PipeStream.Write Methode

  • Referenz

Definition

Namespace:
System.IO.Pipes
Assembly:
System.IO.Pipes.dll
Assembly:
netstandard.dll
Assembly:
System.Core.dll

Überlädt

Write(ReadOnlySpan<Byte>)

Schreibt eine Bytesequenz in den aktuellen Stream und setzt die aktuelle Position in diesem Stream um die Anzahl der geschriebenen Bytes nach vorn.
Write(Byte[], Int32, Int32)

Schreibt einen Byteblock mit den Daten aus einem Puffer in den aktuellen Stream.

Write(ReadOnlySpan<Byte>)

Quelle:
PipeStream.Unix.cs
Quelle:
PipeStream.Unix.cs
Quelle:
PipeStream.Unix.cs

Schreibt eine Bytesequenz in den aktuellen Stream und setzt die aktuelle Position in diesem Stream um die Anzahl der geschriebenen Bytes nach vorn.

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);
public override void Write (ReadOnlySpan<byte> buffer);
override this.Write : ReadOnlySpan<byte> -> unit
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

Parameter

buffer
ReadOnlySpan<Byte>

Ein Bereich im Arbeitsspeicher. Diese Methode kopiert den Inhalt dieses Bereichs in den aktuellen Datenstrom.

Ausnahmen

NotSupportedException

Der Stream unterstützt das Schreiben nicht.

ObjectDisposedException

Auf eine geschlossene Pipe kann nicht zugegriffen werden.

IOException

Die Pipe ist unterbrochen.

InvalidOperationException

Die Pipe ist noch nicht verbunden.

- oder -

Die Pipe befindet sich in einem nicht verbundenen Zustand.

- oder -

Das Pipehandle wurde nicht festgelegt. (Hat Ihre PipeStream-Implementierung InitializeHandle(SafePipeHandle, Boolean, Boolean) aufgerufen?

Hinweise

Verwenden Sie die CanWrite -Eigenschaft, um zu bestimmen, ob die aktuelle instance das Schreiben unterstützt. Verwenden Sie die WriteAsync -Methode, um asynchron in den aktuellen Stream zu schreiben.

Wenn der Schreibvorgang erfolgreich ist, wird die Position innerhalb des Datenstroms um die Anzahl der geschriebenen Bytes erweitert. Wenn eine Ausnahme auftritt, bleibt die Position innerhalb des Datenstroms unverändert.

Gilt für:

Write(Byte[], Int32, Int32)

Quelle:
PipeStream.Unix.cs
Quelle:
PipeStream.Unix.cs
Quelle:
PipeStream.Unix.cs

Schreibt einen Byteblock mit den Daten aus einem Puffer in den aktuellen Stream.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public override void Write (byte[] buffer, int offset, int count);
[System.Security.SecurityCritical]
public override void Write (byte[] buffer, int offset, int count);
override this.Write : byte[] * int * int -> unit
[<System.Security.SecurityCritical>]
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parameter

buffer
Byte[]

Der Puffer, der Daten enthält, die in die Pipe geschrieben werden sollen.

offset
Int32

Der nullbasierte Byteoffset im buffer, ab dem Bytes in den aktuellen Stream kopiert werden.

count
Int32

Die maximale Anzahl an Bytes, die in den aktuellen Stream geschrieben werden sollen.

Attribute
SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

offset ist kleiner als 0.

- oder -

count ist kleiner als 0.

ArgumentException

count ist größer als die im buffer verfügbare Anzahl von Bytes.

ObjectDisposedException

Die Pipe ist geschlossen.

NotSupportedException

Die Pipe unterstützt keine Schreibvorgänge.

IOException

Die Pipe wurde unterbrochen, oder es ist ein anderer E/A-Fehler aufgetreten.

Hinweise

Verwenden Sie die CanWrite -Eigenschaft, um zu bestimmen, ob das aktuelle PipeStream Objekt Schreibvorgänge unterstützt.

Informationen zu asynchronen Schreibvorgängen finden Sie unter BeginWrite und EndWrite.

Gilt für: