File.OpenHandle Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Initierar en ny instans av SafeFileHandle klassen med den angivna sökvägen, skapandeläget, läs-/skriv- och delningsbehörigheten, åtkomsten till andra SafeFileHandles kan ha till samma fil, ytterligare filalternativ och allokeringsstorlek.
public static Microsoft.Win32.SafeHandles.SafeFileHandle OpenHandle(string path, System.IO.FileMode mode = System.IO.FileMode.Open, System.IO.FileAccess access = System.IO.FileAccess.Read, System.IO.FileShare share = System.IO.FileShare.Read, System.IO.FileOptions options = System.IO.FileOptions.None, long preallocationSize = 0);static member OpenHandle : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * System.IO.FileOptions * int64 -> Microsoft.Win32.SafeHandles.SafeFileHandlePublic Shared Function OpenHandle (path As String, Optional mode As FileMode = System.IO.FileMode.Open, Optional access As FileAccess = System.IO.FileAccess.Read, Optional share As FileShare = System.IO.FileShare.Read, Optional options As FileOptions = System.IO.FileOptions.None, Optional preallocationSize As Long = 0) As SafeFileHandleParametrar
- path
- String
En relativ eller absolut sökväg för filen som den aktuella SafeFileHandle instansen ska kapsla in.
- mode
- FileMode
Ett av uppräkningsvärdena som avgör hur du öppnar eller skapar filen. Standardvärdet är Open
- access
- FileAccess
En bitvis kombination av uppräkningsvärdena som avgör hur filen kan nås. Standardvärdet är Read
- share
- FileShare
En bitvis kombination av uppräkningsvärdena som avgör hur filen ska delas av processer. Standardvärdet är Read.
- options
- FileOptions
Ett objekt som beskriver valfria SafeFileHandle parametrar att använda.
- preallocationSize
- Int64
Den inledande allokeringsstorleken i byte för filen. Ett positivt värde gäller endast när en vanlig fil skapas, skrivs över eller ersätts. Negativa värden tillåts inte. I andra fall (inklusive standardvärdet 0) ignoreras det.
Returer
En SafeFileHandle instans.
Undantag
path är null.
path är en tom sträng (""), innehåller endast tomt utrymme eller innehåller ett eller flera ogiltiga tecken.
-or- path refererar till en icke-filenhet, till exempel CON:, COM1:, LPT1:osv. i en NTFS-miljö.
path refererar till en icke-filenhet, till exempel CON:, COM1:, LPT1:osv. i en icke-NTFS-miljö.
preallocationSize är negativ.
-or- mode, access, eller share innehåller ett ogiltigt värde.
Det går inte att hitta filen, till exempel när mode är Truncate eller Open, och filen som anges av path finns inte. Filen måste redan finnas i dessa lägen.
Ett I/O-fel, till exempel att CreateNew ange när filen som anges av path redan finns, inträffade.
-or- Disken var full (när preallocationSize angavs och path pekade på en vanlig fil).
-or- Filen var för stor (när preallocationSize angavs och path pekade på en vanlig fil).
Anroparen har inte den behörighet som krävs.
Den angivna sökvägen är ogiltig, till exempel på en ommappad enhet.
Den access begärda är inte tillåten av operativsystemet för den angivna path, till exempel när access är Write eller ReadWrite och filen eller katalogen har angetts för skrivskyddad åtkomst.
-or- Encrypted anges för options, men filkryptering stöds inte på den aktuella plattformen.
Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.
