NetworkStream.Write Método

Definição

Espaço de Nomes:
System.Net.Sockets
Assemblagens:
netstandard.dll, System.Net.Sockets.dll
Assemblagem:
System.Net.Sockets.dll
Assemblagem:
netstandard.dll
Assemblagem:
System.dll

Sobrecargas

Name Description
Write(ReadOnlySpan<Byte>)

Escreve dados para o NetworkStream a partir de um intervalo de bytes apenas de leitura.
Write(Byte[], Int32, Int32)

Escreve dados em a NetworkStream partir de um intervalo especificado de um array de bytes.

Write(ReadOnlySpan<Byte>)

Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs

Escreve dados para o NetworkStream a partir de um intervalo de bytes apenas de leitura.

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

Parâmetros

buffer
ReadOnlySpan<Byte>

Os dados a escrever no NetworkStream.

Exceções

InvalidOperationException

Não NetworkStream suporta a escrita.

IOException

Ocorreu um erro ao aceder ao soquete.

-ou-

Houve uma falha ao escrever para a rede.

ObjectDisposedException

Está NetworkStream fechado.

Observações

Este método envia todos os bytes para buffer a rede. O Write método bloqueia até que o número solicitado de bytes seja enviado ou um SocketException lançamento.

Note

Verifique se é NetworkStream gravável ligando para a CanWrite propriedade. Se tentar escrever para um NetworkStream que não é escrito, obterá um InvalidOperationException.

Note

Se receber um IOException, verifique a InnerException propriedade para determinar se foi causado por um SocketException. Se sim, utilize a propriedade ErrorCode para obter o código de erro específico e consulte a documentação do código de erro da API do Windows Sockets versão 2 para uma descrição detalhada do erro.

Aplica-se a

Write(Byte[], Int32, Int32)

Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs

Escreve dados em a NetworkStream partir de um intervalo especificado de um array de bytes.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int size);
public override void Write(byte[] buffer, int offset, int count);
public override void Write(byte[] buffer, int offset, int size);
override this.Write : byte[] * int * int -> unit
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)
Public Overrides Sub Write (buffer As Byte(), offset As Integer, size As Integer)

Parâmetros

buffer
Byte[]

Um array de tipo Byte que contém os dados para escrever no NetworkStream.

offset
Int32

O local buffer de onde começar a escrever dados.

countsize
Int32

O número de bytes a escrever no NetworkStream.

Exceções

ArgumentNullException

O buffer parâmetro é null.

ArgumentOutOfRangeException

O offset parâmetro é inferior a 0.

-ou-

O offset parâmetro é maior do que o comprimento de buffer.

-ou-

O size parâmetro é inferior a 0.

-ou-

O size parâmetro é maior do que o comprimento de buffer menos o valor do offset parâmetro.

InvalidOperationException

Não NetworkStream suporta a escrita.

IOException

Ocorreu um erro ao aceder ao soquete.

-ou-

Houve uma falha ao escrever para a rede.

ObjectDisposedException

Está NetworkStream fechado.

Exemplos

O exemplo de código seguinte verifica se o NetworkStream é gravável. Se for, então Write é usado para escrever uma mensagem pequena.

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

Observações

Este método começa no especificado offset e envia count bytes do conteúdo de buffer para a rede. O Write método bloqueia até que o número solicitado de bytes seja enviado ou um SocketException lançamento.

Note

Verifique se é NetworkStream gravável ligando para a CanWrite propriedade. Se tentar escrever para um NetworkStream que não é escrito, obterá um InvalidOperationException.

Note

Se receber um IOException, verifique a InnerException propriedade para determinar se foi causado por um SocketException. Se sim, utilize a propriedade ErrorCode para obter o código de erro específico e consulte a documentação do código de erro da API do Windows Sockets versão 2 para uma descrição detalhada do erro.

Ver também

Aplica-se a