PipeStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
.
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.