NetworkStream.Write Metodo
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.
| 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. |
- Origine:
- NetworkStream.cs
- Origine:
- NetworkStream.cs
- 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> -> unitPublic Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))Parametri
- buffer
- ReadOnlySpan<Byte>
Dati da scrivere in NetworkStream.
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.
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.
Si applica a
.NET 9 e altre versioni
| Prodotto | Versioni |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Standard | 2.1 |
- Origine:
- NetworkStream.cs
- Origine:
- NetworkStream.cs
- 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 size);public:
override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);public override void Write (byte[] buffer, int offset, int size);public override void Write (byte[] buffer, int offset, int count);override this.Write : byte[] * int * int -> unitoverride this.Write : byte[] * int * int -> unitPublic Overrides Sub Write (buffer As Byte(), offset As Integer, size As Integer)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.
- sizecount
- Int32
Numero di byte da scrivere nella classe NetworkStream.
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 l'accesso al socket.
-oppure-
Si è verificato un errore durante la scrittura nella rete.
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
Si applica a
.NET 9 e altre versioni
| Prodotto | Versioni |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
Feedback su .NET
.NET è un progetto open source. Seleziona un collegamento per fornire feedback: