NetworkStream.Write Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Overload

Write(ReadOnlySpan<Byte>)	Scrive i dati nell'oggetto NetworkStream da un intervallo di byte di sola lettura.
Write(Byte[], Int32, Int32)	Scrive i dati in NetworkStream da un intervallo specificato di una matrice di byte.

Write(ReadOnlySpan<Byte>)

Origine:

NetworkStream.cs

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> -> unit

Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

Parametri

buffer

ReadOnlySpan<Byte>

Dati da scrivere in NetworkStream.

Eccezioni

InvalidOperationException

NetworkStream non supporta la scrittura.

IOException

Si è verificato un errore durante l'accesso al socket.

-oppure-

Si è verificato un errore durante la scrittura nella rete.

ObjectDisposedException

NetworkStream è chiuso.

Commenti

Questo metodo invia tutti i byte nella buffer rete. Il Write metodo si blocca finché non viene inviato il numero di byte richiesto o viene generata un'eccezione SocketException .

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.

Write(Byte[], Int32, Int32)

Origine:

NetworkStream.cs

Scrive i dati in NetworkStream da un intervallo specificato di una matrice di byte.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public override void Write (byte[] buffer, int offset, int count);

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parametri

buffer

Byte[]

Matrice di tipo Byte che contiene i dati da scrivere nella classe NetworkStream.

offset

Int32

Posizione nel buffer da cui avviare la scrittura dei dati.

count

Int32

Numero di byte da scrivere nella classe NetworkStream.

Eccezioni

ArgumentNullException

Il valore del parametro buffer è null.

ArgumentOutOfRangeException

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.

InvalidOperationException

NetworkStream non supporta la scrittura.

IOException

Si è verificato un errore durante l'accesso al socket.

-oppure-

Si è verificato un errore durante la scrittura nella rete.

ObjectDisposedException

NetworkStream è chiuso.

Esempio

Nell'esempio di codice seguente viene verificato se è 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 )
{
   array<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)
{
    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 size byte dal contenuto di buffer alla rete. Il Write metodo si blocca finché non viene inviato il numero di byte richiesto o viene generata un'eccezione SocketException .

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.

Vedi anche

• CanWrite
• Writeable