NetworkStream.Write Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Write(ReadOnlySpan<Byte>) |
Escribe datos en NetworkStream desde un intervalo de bytes de solo lectura. |
| Write(Byte[], Int32, Int32) |
Escribe datos en NetworkStream desde un rango especificado de una matriz de bytes. |
Write(ReadOnlySpan<Byte>)
- Source:
- NetworkStream.cs
- Source:
- NetworkStream.cs
- Source:
- NetworkStream.cs
Escribe datos en NetworkStream desde 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> -> unitPublic Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))Parámetros
- buffer
- ReadOnlySpan<Byte>
Datos que se van a escribir en NetworkStream.
Excepciones
NetworkStream no admite escritura.
Se produjo un error al acceder al socket.
o bien
Se produjo un error al escribir en la red.
La clase NetworkStream está cerrada.
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 .
Nota
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.
Nota
Si recibe un IOException, compruebe la InnerException propiedad para determinar si fue causada por un SocketException. Si es así, use la ErrorCode propiedad para obtener el código de error específico y consulte la documentación del código de error de la 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
Escribe datos en NetworkStream desde un rango especificado de una matriz de bytes.
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)Parámetros
- buffer
- Byte[]
Una matriz de tipo Byte que contiene los datos que se va a escribir en NetworkStream.
- offset
- Int32
Ubicación de buffer donde se comienza a escribir los datos.
- sizecount
- Int32
Número de bytes que se van a escribir en NetworkStream.
Excepciones
El parámetro buffer es null.
El parámetro offset es menor que 0.
o bien
El parámetro offset es mayor que la longitud de buffer.
o bien
El parámetro size es menor que 0.
o bien
El parámetro size es mayor que la longitud de buffer menos el valor del parámetro offset.
NetworkStream no admite escritura.
Se produjo un error al acceder al socket.
o bien
Se produjo un error al escribir en la red.
La clase NetworkStream está cerrada.
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 )
{
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
Comentarios
Este método se inicia en el especificado offset y envía size 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 .
Nota
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.
Nota
Si recibe un IOException, compruebe la InnerException propiedad para determinar si fue causada por un SocketException. Si es así, use la ErrorCode propiedad para obtener el código de error específico y consulte la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.
