PipeStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Metoda

Definicja

Rozpoczyna operację zapisu asynchronicznego.

public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
[System.Security.SecurityCritical]
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
[<System.Security.SecurityCritical>]
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parametry

buffer
Byte[]

Bufor zawierający dane do zapisu w bieżącym strumieniu.

offset
Int32

Przesunięcie bajtów na podstawie zera, w buffer którym rozpocznie się kopiowanie bajtów do bieżącego strumienia.

count
Int32

Maksymalna liczba bajtów do zapisu.

callback
AsyncCallback

Metoda wywoływana po zakończeniu operacji zapisu asynchronicznego.

state
Object

Obiekt udostępniony przez użytkownika, który rozróżnia to konkretne asynchroniczne żądanie zapisu z innych żądań.

Zwraca

IAsyncResult Obiekt, który odwołuje się do operacji zapisu asynchronicznego.

Atrybuty

Wyjątki

buffer to null.

offset wartość jest mniejsza niż 0.

-lub-

count wartość jest mniejsza niż 0.

count jest większa niż liczba bajtów dostępnych w elemecie buffer.

Rura jest zamknięta.

Potok nie obsługuje operacji zapisu.

Potok jest odłączony, czeka na połączenie lub nie ustawiono uchwytu.

Potok jest uszkodzony lub wystąpił inny błąd we/wy.

Uwagi

EndWrite musi być wywoływany raz dla każdego wywołania metody BeginWrite. Można to zrobić w tym samym kodzie, który wywoływany BeginWrite lub w wywołaniu zwrotnym przekazanym do BeginWrite.

Użyj właściwości , CanWrite aby określić, czy bieżący PipeStream obiekt obsługuje operacje zapisu.

Jeśli potok jest zamknięty lub zostanie przekazany nieprawidłowy argument, BeginWritezostaną natychmiast zgłoszone odpowiednie wyjątki. Błędy występujące podczas asynchronicznego żądania zapisu występują w wątku puli wątków, który wykonuje żądanie. Wyjątki są wywoływane, gdy kod wywołuje metodę EndWrite .

Dotyczy