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
| 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 in NetworkStream dall'intervallo specificato di una matrice di byte come operazione asincrona. |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
- Origine:
- NetworkStream.cs
- Origine:
- NetworkStream.cs
- Origine:
- NetworkStream.cs
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.
Restituisce
Attività che rappresenta l'operazione di scrittura asincrona.
Eccezioni
NetworkStream non supporta la scrittura.
Si è verificato un errore durante l'accesso al socket.
-oppure-
Si è verificato un errore durante la scrittura nella rete.
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.
Nota
Controllare se è NetworkStream scrivibile chiamando la CanWrite proprietà . Se si tenta di scrivere in un oggetto NetworkStream che non è scrivibile, si otterrà un oggetto InvalidOperationException.
Nota
Se si riceve un IOExceptionoggetto , controllare la InnerException proprietà per determinare se è stata causata da un oggetto SocketException. In questo caso, usare la ErrorCode proprietà 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)
- Origine:
- NetworkStream.cs
- Origine:
- NetworkStream.cs
- Origine:
- NetworkStream.cs
Scrive i dati in 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(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task WriteAsync (byte[] buffer, int offset, int size, System.Threading.CancellationToken cancellationToken);public override System.Threading.Tasks.Task WriteAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);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 TaskPublic Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As TaskParametri
- buffer
- Byte[]
Matrice di byte che contiene i dati da scrivere in NetworkStream.
- offset
- Int32
Posizione nel buffer da cui avviare la scrittura dei dati.
- sizecount
- Int32
Numero di byte da scrivere nella classe NetworkStream.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento.
Restituisce
Attività che rappresenta l'operazione di scrittura asincrona.
Eccezioni
Il valore del parametro buffer è null.
Il parametro offset è minore di 0.
-oppure-
Il parametro offset è maggiore della lunghezza di buffer.
-oppure-
Il parametro size è minore di 0.
-oppure-
Il parametro size è maggiore della lunghezza di buffer meno il valore del parametro offset.
NetworkStream non supporta la scrittura.
Si è verificato un errore durante la scrittura nella rete.
-oppure-
Si è verificato un errore durante l'accesso al socket.
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 size byte dal contenuto di buffer alla rete.
Nota
Controllare se è NetworkStream scrivibile chiamando la CanWrite proprietà . Se si tenta di scrivere in un oggetto NetworkStream che non è scrivibile, si otterrà un oggetto InvalidOperationException.
Nota
Se si riceve un IOExceptionoggetto , controllare la InnerException proprietà per determinare se è stata causata da un oggetto SocketException. In questo caso, usare la ErrorCode proprietà 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à 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).
