NetworkStream.Write Método

Definição

Sobrecargas

Write(ReadOnlySpan<Byte>)

Grava dados no NetworkStream de um intervalo de bytes somente leitura.Writes data to the NetworkStream from a read-only byte span.

Write(Byte[], Int32, Int32)

Grava dados no NetworkStream de um intervalo especificado de uma matriz de bytes.Writes data to the NetworkStream from a specified range of a byte array.

Write(ReadOnlySpan<Byte>)

Grava dados no NetworkStream de um intervalo de bytes somente leitura.Writes data to the NetworkStream from a read-only byte span.

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 serem gravados em NetworkStream.The data to write to the NetworkStream.

Exceções

O NetworkStream não dá suporte à gravação.The NetworkStream does not support writing.

Ocorreu um erro ao acessar o soquete.An error occurred when accessing the socket.

- ou --or-

Houve uma falha durante a gravação na rede.There was a failure while writing to the network.

O NetworkStream está fechado.The NetworkStream is closed.

Comentários

Esse método envia todos os bytes na buffer rede.This method sends all bytes in buffer to the network. O Write método é bloqueado até que o número solicitado de bytes seja enviado ou um SocketException é lançado.The Write method blocks until the requested number of bytes is sent or a SocketException is thrown.

Observação

Verifique se o NetworkStream é gravável chamando a CanWrite propriedade.Check to see if the NetworkStream is writable by calling the CanWrite property. Se você tentar gravar em um NetworkStream que não seja gravável, receberá um InvalidOperationException .If you attempt to write to a NetworkStream that is not writable, you will get an InvalidOperationException.

Observação

Se você receber um IOException , verifique a InnerException propriedade para determinar se ela foi causada por um SocketException .If you receive an IOException, check the InnerException property to determine if it was caused by a SocketException. Nesse caso, use a ErrorCode propriedade 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 obter uma descrição detalhada do erro.If so, use the ErrorCode property to obtain the specific error code and refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Aplica-se a

Write(Byte[], Int32, Int32)

Grava dados no NetworkStream de um intervalo especificado de uma matriz de bytes.Writes data to the NetworkStream from a specified range of a byte array.

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 -> unit
Public Overrides Sub Write (buffer As Byte(), offset As Integer, size As Integer)

Parâmetros

buffer
Byte[]

Uma matriz do tipo Byte que contém os dados a serem gravados no NetworkStream.An array of type Byte that contains the data to write to the NetworkStream.

offset
Int32

O local no buffer do qual a gravação de dados será iniciada.The location in buffer from which to start writing data.

size
Int32

O número de bytes a serem gravados no NetworkStream.The number of bytes to write to the NetworkStream.

Exceções

O parâmetro buffer é null.The buffer parameter is null.

O parâmetro offset é menor que 0.The offset parameter is less than 0.

- ou --or- O parâmetro offset é maior que o tamanho de buffer.The offset parameter is greater than the length of buffer.

- ou --or- O parâmetro size é menor que 0.The size parameter is less than 0.

- ou --or- O parâmetro size é maior que o tamanho de buffer subtraído do valor do parâmetro offset.The size parameter is greater than the length of buffer minus the value of the offset parameter.

O NetworkStream não dá suporte à gravação.The NetworkStream does not support writing.

Ocorreu um erro ao acessar o soquete.An error occurred when accessing the socket.

- ou --or-

Houve uma falha durante a gravação na rede.There was a failure while writing to the network.

O NetworkStream está fechado.The NetworkStream is closed.

Exemplos

O exemplo de código a seguir verifica se o NetworkStream é gravável.The following code example checks to see whether the NetworkStream is writable. Se for, Write será usado para gravar uma mensagem pequena.If it is, then Write is used to write a small message.

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

Comentários

Esse método inicia no especificado offset e envia size bytes do conteúdo da buffer para a rede.This method starts at the specified offset and sends size bytes from the contents of buffer to the network. O Write método é bloqueado até que o número solicitado de bytes seja enviado ou um SocketException é lançado.The Write method blocks until the requested number of bytes is sent or a SocketException is thrown.

Observação

Verifique se o NetworkStream é gravável chamando a CanWrite propriedade.Check to see if the NetworkStream is writable by calling the CanWrite property. Se você tentar gravar em um NetworkStream que não seja gravável, receberá um InvalidOperationException .If you attempt to write to a NetworkStream that is not writable, you will get an InvalidOperationException.

Observação

Se você receber um IOException , verifique a InnerException propriedade para determinar se ela foi causada por um SocketException .If you receive an IOException, check the InnerException property to determine if it was caused by a SocketException. Nesse caso, use a ErrorCode propriedade 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 obter uma descrição detalhada do erro.If so, use the ErrorCode property to obtain the specific error code and refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Confira também

Aplica-se a