PipeStream.Write Metoda

Definicja

Przeciążenia

Write(ReadOnlySpan<Byte>)

Zapisuje sekwencję bajtów do bieżącego strumienia i zwiększa bieżącą pozycję w tym strumieniu o liczbę zapisanych bajtów.Writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

Write(Byte[], Int32, Int32)

Zapisuje blok bajtów do bieżącego strumienia przy użyciu danych z bufora.Writes a block of bytes to the current stream using data from a buffer.

Write(ReadOnlySpan<Byte>)

Zapisuje sekwencję bajtów do bieżącego strumienia i zwiększa bieżącą pozycję w tym strumieniu o liczbę zapisanych bajtów.Writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

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))

Parametry

buffer
ReadOnlySpan<Byte>

Region pamięci.A region of memory. Ta metoda kopiuje zawartość tego regionu do bieżącego strumienia.This method copies the contents of this region to the current stream.

Wyjątki

Strumień nie obsługuje zapisu.The stream does not support writing.

Nie można uzyskać dostępu do zamkniętego potoku.Cannot access a closed pipe.

Potok jest przerwany.The pipe is broken.

Potok nie został jeszcze połączony.The pipe hasn't been connected yet.

lub-or-

Potok jest w stanie odłączonym.The pipe is in a disconnected state.

lub-or-

Dojście potoku nie zostało ustawione.The pipe handle has not been set. (Czy PipeStream InitializeHandle(SafePipeHandle, Boolean, Boolean)wywołania implementacji?(Did your PipeStream implementation call InitializeHandle(SafePipeHandle, Boolean, Boolean)?

Uwagi

Użyj właściwości CanWrite, aby określić, czy bieżące wystąpienie obsługuje zapisywanie.Use the CanWrite property to determine whether the current instance supports writing. Użyj metody WriteAsync, aby zapisywać asynchronicznie w bieżącym strumieniu.Use the WriteAsync method to write asynchronously to the current stream.

Jeśli operacja zapisu powiedzie się, pozycja w strumieniu zastąpi przez liczbę zapisanych bajtów.If the write operation is successful, the position within the stream advances by the number of bytes written. Jeśli wystąpi wyjątek, pozycja w strumieniu pozostaje niezmieniona.If an exception occurs, the position within the stream remains unchanged.

Write(Byte[], Int32, Int32)

Zapisuje blok bajtów do bieżącego strumienia przy użyciu danych z bufora.Writes a block of bytes to the current stream using data from a buffer.

public:
 override void Write(cli::array <System::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
Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parametry

buffer
Byte[]

Bufor zawierający dane do zapisu w potoku.The buffer that contains data to write to the pipe.

offset
Int32

Przesunięcie bajtu na podstawie zera w buffer, w którym należy rozpocząć kopiowanie bajtów do bieżącego strumienia.The zero-based byte offset in buffer at which to begin copying bytes to the current stream.

count
Int32

Maksymalna liczba bajtów do zapisu w bieżącym strumieniu.The maximum number of bytes to write to the current stream.

Atrybuty

Wyjątki

Parametr buffer ma wartość null.buffer is null.

Parametr offset ma wartość mniejszą niż 0.offset is less than 0.

lub-or- Parametr count ma wartość mniejszą niż 0.count is less than 0.

count jest większa niż liczba bajtów dostępnych w buffer.count is greater than the number of bytes available in buffer.

Potok jest zamknięty.The pipe is closed.

Potok nie obsługuje operacji zapisu.The pipe does not support write operations.

Potok jest przerwany lub Wystąpił inny błąd we/wy.The pipe is broken or another I/O error occurred.

Uwagi

Użyj właściwości CanWrite, aby określić, czy bieżący obiekt PipeStream obsługuje operacje zapisu.Use the CanWrite property to determine whether the current PipeStream object supports write operations.

Wywoływanie bloków metody Write do momentu odczytania count bajtów lub osiągnięcia końca strumienia.Calling the Write method blocks until count bytes are read or the end of the stream is reached. W przypadku asynchronicznych operacji odczytu Zobacz BeginWrite i EndWrite.For asynchronous read operations, see BeginWrite and EndWrite.

Dotyczy