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 -Klasse mit dem angegebenen Pfad, erstellungsmodus, Lese-/Schreib- und Freigabeberechtigung, dem Zugriff anderer SafeFileHandles auf dieselbe Datei, zusätzlichen Dateioptionen und der SafeFileHandle Zuordnungsgröße.
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.SafeFileHandle
Public 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 SafeFileHandle
Parameter
- path
- String
Ein relativer oder absoluter Pfad für die Datei, die die aktuelle SafeFileHandle Instanz kapselt.
- 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 verwendet wird. Der Standardwert ist Read.
- options
- FileOptions
Ein Objekt, das die zu SafeFileHandle verwendenden optionalen Parameter beschreibt.
- preallocationSize
- Int64
Die anfängliche Zuordnungsgröße in Bytes 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 er 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 Nichtdateigerät, z. B. CON:
, COM1:
, LPT1:
usw. in einer NTFS-Umgebung.
path
bezieht sich auf ein Nicht-Dateigerät, z. B. CON:
, COM1:
, LPT1:
usw. in einer Nicht-NTFS-Umgebung.
preallocationSize
ist ein negativer Wert.
Oder: mode
access
, oder enthalten einen share
ungültigen Wert.
Die Datei kann nicht gefunden werden. Dies ist z. B. der Fall, wenn mode
auf Truncate oder Open festgelegt und die durch path
angegebene Datei nicht vorhanden ist. Die Datei muss bereits in diesen Modi vorhanden sein.
Es ist ein E/A-Fehler aufgetreten, beispielsweise weil CreateNew angegeben wurde, die durch path
angegebene Datei aber bereits vorhanden ist.
Oder: Der Datenträger war voll (als preallocationSize
bereitgestellt wurde und auf eine reguläre Datei path
verweist).
Oder: Die Datei war zu groß (als preallocationSize
bereitgestellt wurde und auf eine reguläre Datei path
verweist).
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Der angegebene Pfad ist ungültig, z. B. befindet er sich auf einem nicht zugeordneten Laufwerk.
Der access
angeforderte ist vom Betriebssystem für den angegebenen nicht path
zulässig, z. B. wenn access
oder ist und die Datei oder das Verzeichnis für den Write ReadWrite schreibgeschützten Zugriff festgelegt ist.
Oder: Encrypted wird für options
angegeben, aber die Dateiverschlüsselung wird auf der aktuellen Plattform nicht unterstützt.
Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.