Stream.Write 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.
Überlädt
| Name | Beschreibung |
|---|---|
| Write(ReadOnlySpan<Byte>) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine Bytesequenz in den aktuellen Datenstrom geschrieben und die aktuelle Position innerhalb dieses Datenstroms um die Anzahl der geschriebenen Bytes vorangestellt. |
| Write(Byte[], Int32, Int32) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine Bytesequenz in den aktuellen Datenstrom geschrieben und die aktuelle Position innerhalb dieses Datenstroms um die Anzahl der geschriebenen Bytes vorangestellt. |
Write(ReadOnlySpan<Byte>)
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine Bytesequenz in den aktuellen Datenstrom geschrieben und die aktuelle Position innerhalb dieses Datenstroms um die Anzahl der geschriebenen Bytes vorangestellt.
public:
virtual void Write(ReadOnlySpan<System::Byte> buffer);
public virtual void Write(ReadOnlySpan<byte> buffer);
abstract member Write : ReadOnlySpan<byte> -> unit
override this.Write : ReadOnlySpan<byte> -> unit
Public Overridable Sub Write (buffer As ReadOnlySpan(Of Byte))
Parameter
- buffer
- ReadOnlySpan<Byte>
Ein Speicherbereich. Diese Methode kopiert den Inhalt dieses Bereichs in den aktuellen Datenstrom.
Hinweise
Verwenden Sie die CanWrite Eigenschaft, um zu bestimmen, ob die aktuelle Instanz das Schreiben unterstützt. Verwenden Sie die WriteAsync Methode, um asynchron in den aktuellen Datenstrom zu schreiben.
Wenn der Schreibvorgang erfolgreich ist, wechselt die Position innerhalb des Datenstroms um die Anzahl der geschriebenen Bytes. Wenn eine Ausnahme auftritt, bleibt die Position innerhalb des Datenstroms unverändert.
Gilt für:
Write(Byte[], Int32, Int32)
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
- Quelle:
- Stream.cs
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine Bytesequenz in den aktuellen Datenstrom geschrieben und die aktuelle Position innerhalb dieses Datenstroms um die Anzahl der geschriebenen Bytes vorangestellt.
public:
abstract void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public abstract void Write(byte[] buffer, int offset, int count);
abstract member Write : byte[] * int * int -> unit
Public MustOverride Sub Write (buffer As Byte(), offset As Integer, count As Integer)
Parameter
- buffer
- Byte[]
Ein Bytearray. Diese Methode kopiert count Bytes aus buffer dem aktuellen Datenstrom.
- offset
- Int32
Der nullbasierte Byte-Offset, in buffer dem mit dem Kopieren von Bytes in den aktuellen Datenstrom begonnen werden soll.
- count
- Int32
Die Anzahl der Bytes, die in den aktuellen Datenstrom geschrieben werden sollen.
Ausnahmen
Die Summe und offsetcount ist größer als die Pufferlänge.
buffer ist null.
offset oder count ist negativ.
Ein E/A-Fehler ist aufgetreten, z. B. die angegebene Datei kann nicht gefunden werden.
Der Datenstrom unterstützt das Schreiben nicht.
Write(Byte[], Int32, Int32) wurde aufgerufen, nachdem der Datenstrom geschlossen wurde.
Hinweise
Verwenden Sie die CanWrite Eigenschaft, um zu bestimmen, ob die aktuelle Instanz das Schreiben unterstützt. Verwenden Sie die WriteAsync Methode, um asynchron in den aktuellen Datenstrom zu schreiben.
Wenn der Schreibvorgang erfolgreich ist, wechselt die Position innerhalb des Datenstroms um die Anzahl der geschriebenen Bytes. Wenn eine Ausnahme auftritt, bleibt die Position innerhalb des Datenstroms unverändert.
Weitere Informationen
- Datei- und Stream-E/A
- Vorgehensweise: Lesen von Text aus einer Datei
- Vorgehensweise: Schreiben von Text in eine Datei