File.OpenHandle Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.Runtime.dll

Quelle:: File.cs

Quelle:: File.cs

Quelle:: File.cs

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 instance der SafeFileHandle -Klasse mit dem angegebenen Pfad, dem angegebenen Erstellungsmodus, lese-/schreib- und Freigabeberechtigung, dem Zugriff, den andere SafeFileHandles auf dieselbe Datei haben können, zusätzliche Dateioptionen und die 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 vom aktuellen SafeFileHandle instance 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 verwendet wird. Standardwert: Read.

options: FileOptions

Ein -Objekt, das die zu verwendenden optionalen SafeFileHandle Parameter beschreibt.

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 er ignoriert.

Gibt zurück

SafeFileHandle

Eine SafeFileHandle-Instanz.

Ausnahmen

ArgumentNullException

path ist null.

ArgumentException

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.

NotSupportedException

path bezieht sich auf ein Nicht-Dateigerät, z CON:. B. , COM1:, LPT1:usw. in einer Nicht-NTFS-Umgebung.

ArgumentOutOfRangeException

preallocationSize ist ein negativer Wert. oder: mode, accessoder share einen ungültigen Wert enthalten.

FileNotFoundException

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.

IOException

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 (wenn preallocationSize bereitgestellt wurde und path auf eine normale Datei verweist). Oder: Die Datei war zu groß (wenn preallocationSize angegeben wurde und path auf eine normale Datei verweist).

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. befindet er sich auf einem nicht zugeordneten Laufwerk.

UnauthorizedAccessException

Der angeforderte access für den angegebenen path wird vom Betriebssystem nicht zugelassen. Dies ist z. B. der Fall, wenn access auf Write oder ReadWrite festgelegt und die Datei bzw. das Verzeichnis schreibgeschützt ist. Oder: Encrypted wird für optionsangegeben, aber die Dateiverschlüsselung wird auf der aktuellen Plattform nicht unterstützt.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

Gilt für:

Share via