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

Definicja

Rozpoczyna asynchroniczne operacje zapisu.Begins an asynchronous write operation.

public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::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
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.The buffer that contains the data to write to the current stream.

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 zapisania.The maximum number of bytes to write.

callback
AsyncCallback

Metoda wywoływana po zakończeniu asynchronicznej operacji zapisu.The method to call when the asynchronous write operation is completed.

state
Object

Obiekt udostępniony przez użytkownika, który odróżnia to konkretne asynchroniczne żądanie zapisu z innych żądań.A user-provided object that distinguishes this particular asynchronous write request from other requests.

Zwraca

Obiekt IAsyncResult, który odwołuje się do asynchronicznej operacji zapisu.An IAsyncResult object that references the asynchronous write operation.

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 odłączony, oczekiwanie na połączenie lub dojście nie zostało ustawione.The pipe is disconnected, waiting to connect, or the handle has not been set.

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

Uwagi

EndWrite musi być wywoływana jednokrotnie dla każdego wywołania do BeginWrite.EndWrite must be called once for every call to BeginWrite. Można to zrobić w tym samym kodzie, który o nazwie BeginWrite lub wywołania zwrotnego, które jest przesyłane do BeginWrite.This can be done either in the same code that called BeginWrite or in a callback that is passed to BeginWrite.

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.

Jeśli potok jest zamknięty lub przeszedł nieprawidłowy argument do BeginWrite, odpowiednie wyjątki są wywoływane natychmiast.If the pipe is closed or an invalid argument is passed to BeginWrite, the appropriate exceptions are raised immediately. Błędy występujące podczas asynchronicznego żądania zapisu odbywają się w wątku puli wątków, który wykonuje żądanie.Errors that occur during an asynchronous write request occur on the thread pool thread that is performing the request. Wyjątki są wywoływane, gdy kod wywołuje metodę EndWrite.The exceptions are raised when the code calls the EndWrite method.

Dotyczy