Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método NetworkStream.Write (Byte[], Int32, Int32)

 

Grava os dados no NetworkStream.

Namespace:   System.Net.Sockets
Assembly:  System (em System.dll)

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

Parâmetros

buffer
Type: System.Byte[]

Uma matriz do tipo Byte que contém os dados a serem gravados no NetworkStream.

offset
Type: System.Int32

O local no buffer do qual a gravação de dados será iniciada.

size
Type: System.Int32

O número de bytes a serem gravados no NetworkStream.

Exception Condition
ArgumentNullException

O parâmetro buffer é null.

ArgumentOutOfRangeException

O parâmetro offset é menor que 0.

-ou-

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

-ou-

O parâmetro size é menor que 0.

-ou-

O parâmetro size é maior que o tamanho de buffer subtraído do valor do parâmetro offset.

IOException

Houve uma falha durante a gravação na rede.

-ou-

Ocorreu um erro ao acessar o soquete. Consulte a seção Comentários para obter mais informações.

ObjectDisposedException

O NetworkStream está fechado.

-ou-

Houve uma falha de leitura da rede.

The M:System.Net.Sockets.NetworkStream.Write(System.Byte[],System.Int32,System.Int32) method starts at the specified offset and sends size bytes from the contents of buffer to the network. The M:System.Net.Sockets.NetworkStream.Write(System.Byte[],System.Int32,System.Int32) method blocks until the requested number of bytes is sent or a T:System.Net.Sockets.SocketException is thrown. If you receive a T:System.Net.Sockets.SocketException, use the P:System.Net.Sockets.SocketException.ErrorCode property to obtain the specific error code, and refer to the Windows Sockets version 2 API error code documentation in MSDN for a detailed description of the error.

System_CAPS_noteObservação

Check to see if the T:System.Net.Sockets.NetworkStream is writable by accessing the P:System.Net.Sockets.NetworkStream.CanWrite property. If you attempt to write to a T:System.Net.Sockets.NetworkStream that is not writable, you will get an T:System.IO.IOException. If you receive an T:System.IO.IOException, check the P:System.Exception.InnerException property to determine if it was caused by a T:System.Net.Sockets.SocketException.

The following code example checks to see whether the T:System.Net.Sockets.NetworkStream is writable. If it is, then M:System.Net.Sockets.NetworkStream.Write(System.Byte[],System.Int32,System.Int32) is used to write a small message.

// 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.");  
}

.NET Framework
Disponível desde 1.1
Retornar ao início
Mostrar: