Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Initialisiert eine neue Instanz der FileStream-Klasse mit den Angaben für den Pfad, den Erstellungsmodus und die Freigabeberechtigung.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Sub New ( _
path As String, _
mode As FileMode, _
access As FileAccess, _
share As FileShare _
)
'Usage
Dim path As String
Dim mode As FileMode
Dim access As FileAccess
Dim share As FileShare
Dim instance As New FileStream(path, mode, access, share)
public FileStream (
string path,
FileMode mode,
FileAccess access,
FileShare share
)
public:
FileStream (
String^ path,
FileMode mode,
FileAccess access,
FileShare share
)
public FileStream (
String path,
FileMode mode,
FileAccess access,
FileShare share
)
public function FileStream (
path : String,
mode : FileMode,
access : FileAccess,
share : FileShare
)
Parameter
- path
Ein relativer oder absoluter Pfad zu der Datei, die vom aktuellen FileStream-Objekt gekapselt wird.
- mode
Eine FileMode-Konstante, die bestimmt, auf welche Weise die Datei geöffnet oder erstellt werden soll.
- access
Eine FileAccess-Konstante, die bestimmt, welcher Zugriff auf die Datei für das FileStream-Objekt zulässig ist. Dies ruft die CanRead-Eigenschaft und die CanWrite-Eigenschaft des FileStream-Objekts ab. CanSeek ist true, wenn path eine Datenträgerdatei angibt.
- share
Eine FileShare-Konstante zur Bestimmung der Art, in der Prozesse gemeinsam auf die Datei zugreifen.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
path ist NULL (Nothing in Visual Basic). |
|
path ist eine leere Zeichenfolge (""), die nur Leerraum oder mindestens ein ungültiges Zeichen enthält. - oder - path verweist auf ein Gerät, das keine Datei ist, z. B. "con:", "com1:", "lpt1:" usw. in einer NTFS-Umgebung. |
|
path verweist auf ein Gerät, das keine Datei ist, z. B. "con:", "com1:", "lpt1:" usw. in einer Nicht-NTFS-Umgebung. |
|
ArgumentException |
path ist eine leere Zeichenfolge (""), die nur Leerraum oder mindestens ein ungültiges Zeichen enthält. |
Die Datei kann nicht gefunden werden. Dies ist z. B. der Fall, wenn mode auf FileMode.Truncate oder FileMode.Open festgelegt wurde 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 wurde FileMode.CreateNew angegeben, und die durch path angegebene Datei ist bereits vorhanden. - oder - Das System führt Windows 98 oder Windows 98 SE aus, und share ist auf FileShare.Delete festgelegt. - oder - Der Stream wurde geschlossen. |
|
Der Aufrufer verfügt nicht über die erforderliche Berechtigung. |
|
Der angegebene Pfad ist ungültig. Dies ist z. B. der Fall, wenn das Laufwerk des Pfads nicht zugeordnet ist. |
|
Der angeforderte access für den angegebenen path wird durch das Betriebssystem nicht zugelassen. Dies ist z. B. der Fall, wenn Write oder ReadWrite für access festgelegt sind und für die Datei oder das Verzeichnis schreibgeschützter Zugriff festgelegt wurde. |
|
Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein. |
|
mode enthält einen ungültigen Wert. |
Hinweise
In .NET Framework wird der direkte Zugriff auf physikalische Datenträger über Pfade, bei denen es sich um Gerätenamen handelt, z. B. "\\.\PHYSICALDRIVE0", nicht unterstützt.
Der path-Parameter kann ein Dateiname sein, u. a. eine Datei in einer UNC-Freigabe (Universal Naming Convention).
Der Konstruktor verfügt über Lese-/Schreibzugriff auf die Datei, und diese wird mit einer Freigabe für den Lesezugriff geöffnet (d. h., dass Anforderungen durch diesen oder einen anderen Prozess, die Datei für das Schreiben zu öffnen, fehlschlagen, bis das FileStream-Objekt geschlossen wird, Lesevorgänge werden aber gewährt). Die Puffergröße wird auf die Standardgröße von 8192 Bytes (8 KB) festgelegt.
Hinweis
path muss keine Datei sein, die auf der Festplatte gespeichert ist. Es kann ein beliebiger Teil eines Systems sein, das den Zugriff über Streams unterstützt. Je nach System kann diese Klasse z. B. auf ein physikalisches Gerät zugreifen.
CanSeek ist für alle FileStream-Objekte true, die Dateien kapseln. Wenn path ein Gerät angibt, das Suchvorgänge nicht unterstützt, dann ist die CanSeek-Eigenschaft für den resultierenden FileStreamfalse. Weitere Informationen finden Sie unter CanSeek.
Warnung
Wenn Sie einen Zeichensatz mit einer bestimmten Kultureinstellung kompilieren und die gleichen Zeichen mit einer anderen Kultureinstellung abrufen, können diese möglicherweise nicht interpretiert werden, und es wird eine Ausnahme ausgelöst.
In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.
Aufgabe |
Beispiel in diesem Thema |
|---|---|
Erstellen einer Textdatei. |
|
In eine Textdatei schreiben. |
|
Aus einer Textdatei lesen. |
|
Text an eine Datei anfügen. |
|
Eine Datei umbenennen oder verschieben. |
|
Eine Datei löschen. |
|
Eine Datei kopieren. |
|
Die Größe einer Datei abrufen. |
|
Die Attribute einer Datei abrufen. |
|
Die Attribute einer Datei festlegen. |
|
Bestimmen, ob eine Datei vorhanden ist. |
|
Aus einer Binärdatei lesen. |
Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei |
In eine Binärdatei schreiben. |
Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei |
Abrufen einer Dateierweiterung. |
|
Abrufen des vollqualifizierten Pfads einer Datei. |
|
Abrufen des Dateinamens sowie der Dateierweiterung aus einem Pfad. |
|
Ändern der Erweiterung einer Datei. |
Beispiel
Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die Lock-Methode.
Dim aFileStream As New FileStream( _
"Test#@@#.dat", FileMode.OpenOrCreate, _
FileAccess.ReadWrite, FileShare.ReadWrite)
using(FileStream fileStream = new FileStream(
"Test#@@#.dat", FileMode.OpenOrCreate,
FileAccess.ReadWrite, FileShare.ReadWrite))
FileStream^ fileStream = gcnew FileStream( "Test#@@#.dat",FileMode::OpenOrCreate,FileAccess::ReadWrite,FileShare::ReadWrite );
FileStream fileStream = new FileStream
("Test#@@#.dat", FileMode.OpenOrCreate, FileAccess.ReadWrite,
FileShare.ReadWrite);
.NET Framework-Sicherheit
- FileIOPermission für das Lesen, Schreiben und Anfügen von Dateien. Zugeordnete Enumerationen: FileIOPermissionAccess.Read, FileIOPermissionAccess.Write und FileIOPermissionAccess.Append.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
FileStream-Klasse
FileStream-Member
System.IO-Namespace
Weitere Ressourcen
Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei