NetworkStream.WriteAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Scrive i dati in NetworkStream da un intervallo di memoria di byte di sola lettura come operazione asincrona. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Scrive i dati nell'oggetto NetworkStream dall'intervallo specificato di una matrice di byte come operazione asincrona. |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
Scrive i dati in NetworkStream da un intervallo di memoria di byte di sola lettura come operazione asincrona.
public override System.Threading.Tasks.ValueTask WriteAsync(ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParametri
- buffer
- ReadOnlyMemory<Byte>
Area di memoria che contiene i dati da scrivere in NetworkStream.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento.
Valori restituiti
Attività che rappresenta l'operazione di scrittura asincrona.
Eccezioni
Non NetworkStream supporta la scrittura.
Si è verificato un errore durante l'accesso al socket.
oppure
Si è verificato un errore durante la scrittura nella rete.
L'oggetto NetworkStream è chiuso.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
Questo metodo invia tutti i byte nella buffer rete.
Note
Verificare se è NetworkStream scrivibile chiamando la CanWrite proprietà . Se si tenta di scrivere in un oggetto NetworkStream che non è scrivibile, si otterrà un oggetto InvalidOperationException.
Note
Se si riceve un oggetto IOException, controllare la InnerException proprietà per determinare se è stata causata da un oggetto SocketException. In tal caso, usare la proprietà ErrorCode per ottenere il codice di errore specifico e fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.
Si applica a
WriteAsync(Byte[], Int32, Int32, CancellationToken)
Scrive i dati nell'oggetto NetworkStream dall'intervallo specificato di una matrice di byte come operazione asincrona.
public:
override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int size, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int size, System.Threading.CancellationToken cancellationToken);abstract member WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Taskoverride this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function WriteAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As TaskParametri
- buffer
- Byte[]
Matrice di byte che contiene i dati da scrivere in NetworkStream.
- offset
- Int32
Posizione da buffer cui iniziare a scrivere i dati.
- countsize
- Int32
Numero di byte da scrivere nell'oggetto NetworkStream.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento.
Valori restituiti
Attività che rappresenta l'operazione di scrittura asincrona.
Eccezioni
Il buffer parametro è null.
Il offset parametro è minore di 0.
oppure
Il offset parametro è maggiore della lunghezza di buffer.
oppure
Il size parametro è minore di 0.
oppure
Il size parametro è maggiore della lunghezza di buffer meno il valore del offset parametro.
Non NetworkStream supporta la scrittura.
Si è verificato un errore durante la scrittura nella rete.
oppure
Si è verificato un errore durante l'accesso al socket.
L'oggetto NetworkStream è chiuso.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
Questo metodo inizia in corrispondenza dell'oggetto specificato offset e invia count byte dal contenuto di buffer alla rete.
Note
Verificare se è NetworkStream scrivibile chiamando la CanWrite proprietà . Se si tenta di scrivere in un oggetto NetworkStream che non è scrivibile, si otterrà un oggetto InvalidOperationException.
Note
Se si riceve un oggetto IOException, controllare la InnerException proprietà per determinare se è stata causata da un oggetto SocketException. In tal caso, usare la proprietà ErrorCode per ottenere il codice di errore specifico e fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.
Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Write(Byte[], Int32, Int32).