NetworkStream.Write Método

Definición

Espacio de nombres:
System.Net.Sockets
Ensamblados:
netstandard.dll, System.Net.Sockets.dll
Ensamblado:
System.Net.Sockets.dll
Ensamblado:
netstandard.dll
Ensamblado:
System.dll

Sobrecargas

Nombre Description
Write(ReadOnlySpan<Byte>)

Escribe datos en desde NetworkStream un intervalo de bytes de solo lectura.
Write(Byte[], Int32, Int32)

Escribe datos en desde NetworkStream un intervalo especificado de una matriz de bytes.

Write(ReadOnlySpan<Byte>)

Source:
NetworkStream.cs
Source:
NetworkStream.cs
Source:
NetworkStream.cs
Source:
NetworkStream.cs
Source:
NetworkStream.cs

Escribe datos en desde NetworkStream un intervalo de bytes de solo lectura.

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>

Datos que se van a escribir en .NetworkStream

Excepciones

InvalidOperationException

NetworkStream no admite la escritura.

IOException

Error al acceder al socket.

O bien

Error al escribir en la red.

ObjectDisposedException

NetworkStream Está cerrado.

Comentarios

Este método envía todos los bytes de buffer a la red. El Write método se bloquea hasta que se envía el número solicitado de bytes o se produce una SocketException excepción .

Note

Compruebe si se NetworkStream puede escribir mediante una llamada a la CanWrite propiedad . Si intenta escribir en un NetworkStream objeto que no se puede escribir, obtendrá un InvalidOperationException.

Note

Si recibe un IOException, compruebe la InnerException propiedad para determinar si fue causada por .SocketException Si es así, use la propiedad ErrorCode para obtener el código de error específico y consulte la documentación del código de error de api de Windows Sockets versión 2 para obtener una descripción detallada del error.

Se aplica a

Write(Byte[], Int32, Int32)

Source:
NetworkStream.cs
Source:
NetworkStream.cs
Source:
NetworkStream.cs
Source:
NetworkStream.cs
Source:
NetworkStream.cs

Escribe datos en desde NetworkStream un intervalo especificado de una matriz 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[]

Matriz de tipo Byte que contiene los datos que se van a escribir en .NetworkStream

offset
Int32

Ubicación en la buffer que se van a empezar a escribir datos.

countsize
Int32

Número de bytes que se van a escribir en .NetworkStream

Excepciones

ArgumentNullException

El buffer parámetro es null.

ArgumentOutOfRangeException

El offset parámetro es menor que 0.

O bien

El offset parámetro es mayor que la longitud de buffer.

O bien

El size parámetro es menor que 0.

O bien

El size parámetro es mayor que la longitud de buffer menos el valor del offset parámetro.

InvalidOperationException

NetworkStream no admite la escritura.

IOException

Error al acceder al socket.

O bien

Error al escribir en la red.

ObjectDisposedException

NetworkStream Está cerrado.

Ejemplos

En el ejemplo de código siguiente se comprueba si se puede escribir .NetworkStream Si es así Write , se usa para escribir un mensaje pequeño.

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

Comentarios

Este método comienza en el especificado offset y envía count bytes desde el contenido de buffer a la red. El Write método se bloquea hasta que se envía el número solicitado de bytes o se produce una SocketException excepción .

Note

Compruebe si se NetworkStream puede escribir mediante una llamada a la CanWrite propiedad . Si intenta escribir en un NetworkStream objeto que no se puede escribir, obtendrá un InvalidOperationException.

Note

Si recibe un IOException, compruebe la InnerException propiedad para determinar si fue causada por .SocketException Si es así, use la propiedad ErrorCode para obtener el código de error específico y consulte la documentación del código de error de api de Windows Sockets versión 2 para obtener una descripción detallada del error.

Consulte también

Se aplica a