Partager via


PipeStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Méthode

Définition

Débute une opération d'écriture asynchrone.

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

Paramètres

buffer
Byte[]

Mémoire tampon qui contient les données à écrire dans le flux actuel.

offset
Int32

Dans buffer, décalage d'octet de base zéro auquel commencer la copie des octets dans le flux actuel.

count
Int32

Nombre maximal d'octets à écrire.

callback
AsyncCallback

Méthode à appeler une fois l'opération d'écriture asynchrone terminée.

state
Object

Objet fourni par l'utilisateur qui distingue cette requête d'écriture asynchrone des autres requêtes.

Retours

Objet IAsyncResult qui fait référence à l'opération d'écriture asynchrone.

Attributs

Exceptions

buffer a la valeur null.

offset est inférieur à 0.

- ou -

count est inférieur à 0.

count est supérieur au nombre d’octets disponible dans buffer.

Le canal est fermé.

Le canal ne prend pas en charge les opérations d’écriture.

Le canal est déconnecté, en attente de connexion ou le handle n’a pas été défini.

Le canal est endommagé ou une autre erreur d’E/S s’est produite.

Remarques

EndWrite doit être appelé une fois pour chaque appel à BeginWrite. Cela peut être effectué dans le même code que celui appelé BeginWrite ou dans un rappel passé à BeginWrite.

Utilisez la CanWrite propriété pour déterminer si l’objet actuel PipeStream prend en charge les opérations d’écriture.

Si le canal est fermé ou si un argument non valide est passé à BeginWrite, les exceptions appropriées sont levées immédiatement. Les erreurs qui se produisent lors d’une demande d’écriture asynchrone se produisent sur le thread du pool de threads qui exécute la demande. Les exceptions sont levées lorsque le code appelle la EndWrite méthode.

S’applique à