File.OpenHandle Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der SafeFileHandle Klasse mit dem angegebenen Pfad, Erstellungsmodus, Lese-/Schreibzugriff und Freigabeberechtigung, der Zugriff auf andere SafeFileHandles kann auf dieselbe Datei, zusätzliche Dateioptionen und die Zuordnungsgröße verfügen.
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 SafeFileHandleParameter
- path
- String
Ein relativer oder absoluter Pfad für die Datei, die von der aktuellen SafeFileHandle Instanz gekapselt wird.
- mode
- FileMode
Einer der Enumerationswerte, der bestimmt, wie die Datei geöffnet oder erstellt wird. Der Standardwert ist Open
- access
- FileAccess
Eine bitweise Kombination der Enumerationswerte, die bestimmt, wie auf die Datei zugegriffen werden kann. Der Standardwert ist Read
- share
- FileShare
Eine bitweise Kombination der Enumerationswerte, die bestimmt, wie die Datei von Prozessen gemeinsam genutzt wird. Der Standardwert ist Read.
- options
- FileOptions
Ein Objekt, das optionale SafeFileHandle Parameter beschreibt, die verwendet werden sollen.
- preallocationSize
- Int64
Die anfängliche Zuordnungsgröße in Byte für die Datei. Ein positiver Wert ist nur wirksam, wenn eine reguläre Datei erstellt, überschrieben oder ersetzt wird. Negative Werte sind nicht zulässig. In anderen Fällen (einschließlich des Standardwerts 0) wird sie ignoriert.
Gibt zurück
Eine SafeFileHandle Instanz.
Ausnahmen
path ist null.
path ist eine leere Zeichenfolge (""), enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen.
-oder- path bezieht sich auf ein Nicht-Dateigerät, z CON:. B. , COM1:, LPT1:usw. in einer NTFS-Umgebung.
path bezieht sich auf ein Nicht-Dateigerät, z CON:. B. , COM1:, LPT1:usw. in einer Nicht-NTFS-Umgebung.
preallocationSize ist negativ.
-or- mode, accessoder share enthalten einen ungültigen Wert.
Die Datei kann nicht gefunden werden, z. B. wann oder modeTruncatewannOpen, und die durch path die angegebene Datei ist nicht vorhanden. Die Datei muss bereits in diesen Modi vorhanden sein.
Ein E/A-Fehler, z. B. das Angeben CreateNew , wann die durch path bereits vorhandene Datei angegeben wurde, ist aufgetreten.
-oder- Der Datenträger war voll (wann preallocationSize bereitgestellt und path auf eine normale Datei verweist).
-oder- Die Datei war zu groß (wann preallocationSize angegeben und path auf eine normale Datei verweist).
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Der angegebene Pfad ist ungültig, z. B. auf einem nicht zugeordneten Laufwerk.
Die access angeforderte Anforderung ist vom Betriebssystem für das angegebene pathBetriebssystem nicht zulässig, z. B. wann oder access wann Write und ReadWrite die Datei oder das Verzeichnis für schreibgeschützten Zugriff festgelegt ist.
-or- Encrypted ist für optionsangegeben, aber die Dateiverschlüsselung wird auf der aktuellen Plattform nicht unterstützt.
Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.
