NetworkStream.Write 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 |
|---|---|
| Write(ReadOnlySpan<Byte>) |
Scrive i dati nell'oggetto NetworkStream da un intervallo di byte di sola lettura. |
| Write(Byte[], Int32, Int32) |
Scrive i dati nell'oggetto NetworkStream da un intervallo specificato di una matrice di byte. |
Write(ReadOnlySpan<Byte>)
Scrive i dati nell'oggetto NetworkStream da un intervallo di byte di sola lettura.
public:
override void Write(ReadOnlySpan<System::Byte> buffer);public override void Write(ReadOnlySpan<byte> buffer);override this.Write : ReadOnlySpan<byte> -> unitPublic Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))Parametri
- buffer
- ReadOnlySpan<Byte>
Dati da scrivere in NetworkStream.
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.
Commenti
Questo metodo invia tutti i byte nella buffer rete. Il Write metodo si blocca fino a quando non viene inviato il numero di byte richiesto o viene generata un'eccezione SocketException .
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
Write(Byte[], Int32, Int32)
Scrive i dati nell'oggetto NetworkStream da un intervallo specificato di una matrice di byte.
public:
override void Write(cli::array <System::Byte> ^ buffer, int offset, int size);public override void Write(byte[] buffer, int offset, int size);override this.Write : byte[] * int * int -> unitabstract member Write : byte[] * int * int -> unit
override this.Write : byte[] * int * int -> unitPublic Overrides Sub Write (buffer As Byte(), offset As Integer, size As Integer)Parametri
- buffer
- Byte[]
Matrice di tipo Byte che contiene i dati da scrivere in NetworkStream.
- offset
- Int32
Posizione da buffer cui iniziare a scrivere i dati.
- size
- Int32
Numero di byte da scrivere nell'oggetto NetworkStream.
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 l'accesso al socket.
oppure
Si è verificato un errore durante la scrittura nella rete.
L'oggetto NetworkStream è chiuso.
Esempio
Nell'esempio di codice seguente viene verificato se l'oggetto NetworkStream è scrivibile. In caso affermativo, Write viene usato per scrivere un piccolo messaggio.
// Examples for CanWrite, and CanWrite
// Check to see if this NetworkStream is writable.
if (myNetworkStream.CanWrite)
{
byte[] myWriteBuffer = Encoding.ASCII.GetBytes("Are you receiving this message?");
myNetworkStream.Write(myWriteBuffer, 0, myWriteBuffer.Length);
}
else
{
Console.WriteLine("Sorry. You cannot write to this NetworkStream.");
}
' Examples for CanWrite, and CanWrite
' Check to see if this NetworkStream is writable.
If myNetworkStream.CanWrite Then
Dim myWriteBuffer As Byte() = Encoding.ASCII.GetBytes("Are you receiving this message?")
myNetworkStream.Write(myWriteBuffer, 0, myWriteBuffer.Length)
Else
Console.WriteLine("Sorry. You cannot write to this NetworkStream.")
End If
Commenti
Questo metodo inizia in corrispondenza dell'oggetto specificato offset e invia count byte dal contenuto di buffer alla rete. Il Write metodo si blocca fino a quando non viene inviato il numero di byte richiesto o viene generata un'eccezione SocketException .
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.