Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase NetworkStream

 

Publicado: octubre de 2016

Proporciona la secuencia de datos subyacente para el acceso a la red.

Espacio de nombres:   System.Net.Sockets
Ensamblado:  System (en System.dll)

System.Object
  System.MarshalByRefObject
    System.IO.Stream
      System.Net.Sockets.NetworkStream

public class NetworkStream : Stream

NombreDescripción
System_CAPS_pubmethodNetworkStream(Socket)

Crea una nueva instancia de la clase NetworkStream para el Socket especificado.

System_CAPS_pubmethodNetworkStream(Socket, Boolean)

Inicializa una nueva instancia de la NetworkStream clase especificado Socket con los valores especificados Socket propiedad.

System_CAPS_pubmethodNetworkStream(Socket, FileAccess)

Crea una nueva instancia de la NetworkStream clase especificado Socket con los derechos de acceso especificados.

System_CAPS_pubmethodNetworkStream(Socket, FileAccess, Boolean)

Crea una nueva instancia de la NetworkStream clase especificado Socket con los derechos de acceso especificados y especificado Socket propiedad.

NombreDescripción
System_CAPS_pubpropertyCanRead

Obtiene un valor que indica si la NetworkStream admite operaciones de lectura.(Invalida Stream.CanRead).

System_CAPS_pubpropertyCanSeek

Obtiene un valor que indica si la secuencia admite búsquedas. Esta propiedad no se admite actualmente. Esta propiedad siempre devuelve false.(Invalida Stream.CanSeek).

System_CAPS_pubpropertyCanTimeout

Indica si se puede utilizables para propiedades de tiempo de espera NetworkStream.(Invalida Stream.CanTimeout).

System_CAPS_pubpropertyCanWrite

Obtiene un valor que indica si la NetworkStream admite escritura.(Invalida Stream.CanWrite).

System_CAPS_pubpropertyDataAvailable

Obtiene un valor que indica si hay datos disponibles en la NetworkStream a leerse.

System_CAPS_pubpropertyLength

Obtiene la longitud de los datos disponibles en la secuencia. Esta propiedad no se admite actualmente y siempre produce una NotSupportedException.(Invalida Stream.Length).

System_CAPS_pubpropertyPosition

Obtiene o establece la posición actual en la secuencia. Esta propiedad no se admite actualmente y siempre produce una NotSupportedException.(Invalida Stream.Position).

System_CAPS_protpropertyReadable

Obtiene o establece un valor que indica si el NetworkStream se puede leer.

System_CAPS_pubpropertyReadTimeout

Obtiene o establece la cantidad de tiempo que una operación de lectura se bloquea esperando datos.(Invalida Stream.ReadTimeout).

System_CAPS_protpropertySocket

Obtiene la Socket subyacente.

System_CAPS_protpropertyWriteable

Obtiene un valor que indica si la NetworkStream es grabable.

System_CAPS_pubpropertyWriteTimeout

Obtiene o establece la cantidad de tiempo que una operación de escritura bloquea esperando datos.(Invalida Stream.WriteTimeout).

NombreDescripción
System_CAPS_pubmethodBeginRead(Byte[], Int32, Int32, AsyncCallback, Object)

Comienza una lectura asincrónica de la NetworkStream.(Invalida Stream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)).

System_CAPS_pubmethodBeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)

Comienza una escritura asincrónica en una secuencia.(Invalida Stream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)).

System_CAPS_pubmethodClose()

Cierra la secuencia actual y libera todos los recursos (como sockets e identificadores de archivo) asociados a esta. En lugar de llamar a este método, asegúrese de que la secuencia se desecha correctamente.(Heredado de Stream).

System_CAPS_pubmethodClose(Int32)

Cierra el NetworkStream después de esperar el tiempo especificado para permitir el envío de datos.

System_CAPS_pubmethodCopyTo(Stream)

Cierra la secuencia actual y libera todos los recursos (tales como sockets y manejadores de archivo)asociados a la secuencia actual. (Heredado de Stream).

System_CAPS_pubmethodCopyTo(Stream, Int32)

En vez de llamar a este método, asegúrese de que la secuencia actual ha sido correctamente liberada. (Heredado de Stream).

System_CAPS_pubmethodCopyToAsync(Stream)

Lee asincrónicamente los bytes de la secuencia actual y los escribe en otra secuencia.(Heredado de Stream).

System_CAPS_pubmethodCopyToAsync(Stream, Int32)

Lee asincrónicamente los bytes de la secuencia actual y los escribe en otra secuencia, usando el tamaño de búfer especificado.(Heredado de Stream).

System_CAPS_pubmethodCopyToAsync(Stream, Int32, CancellationToken)

Lee asincrónicamente los bytes de la secuencia actual y los escribe en otra secuencia, utilizando el tamaño de búfer y el token de cancelación especificados.(Heredado de Stream).

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar a un proxy que se utiliza para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_protmethodCreateWaitHandle()

Obsoleto. Asigna un objeto WaitHandle.(Heredado de Stream).

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Stream.(Heredado de Stream).

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa NetworkStream y libera los recursos administrados de forma opcional.(Invalida Stream.Dispose(Boolean)).

System_CAPS_pubmethodEndRead(IAsyncResult)

Controla el final de una lectura asincrónica.(Invalida Stream.EndRead(IAsyncResult)).

System_CAPS_pubmethodEndWrite(IAsyncResult)

Controla el final de una escritura asincrónica.(Invalida Stream.EndWrite(IAsyncResult)).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Libera todos los recursos que usa NetworkStream.(Invalida Object.Finalize()).

System_CAPS_pubmethodFlush()

Vacía los datos de la secuencia. Este método está reservado para un uso futuro.(Invalida Stream.Flush()).

System_CAPS_pubmethodFlushAsync()

Borra asincrónicamente todos los búferes de esta secuencia y hace que los datos almacenados en búfer se escriban en el dispositivo subyacente.(Heredado de Stream).

System_CAPS_pubmethodFlushAsync(CancellationToken)

Vacía los datos de la secuencia como una operación asincrónica.(Invalida Stream.FlushAsync(CancellationToken)).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del elemento actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_protmethodObjectInvariant()

Obsoleto. Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Proporciona compatibilidad con una clase Contract.(Heredado de Stream).

System_CAPS_pubmethodRead(Byte[], Int32, Int32)

Lee datos de la NetworkStream.(Invalida Stream.Read(Byte[], Int32, Int32)).

System_CAPS_pubmethodReadAsync(Byte[], Int32, Int32)

Lee asincrónicamente una secuencia de bytes de la secuencia actual y avanza la posición en esta secuencia según el número de bytes leídos.(Heredado de Stream).

System_CAPS_pubmethodReadAsync(Byte[], Int32, Int32, CancellationToken)

Lee de forma asincrónica una secuencia de bytes en la secuencia actual, se hace avanzar la posición dentro de la secuencia el número de bytes leídos y controla las solicitudes de cancelación.(Heredado de Stream).

System_CAPS_pubmethodReadByte()

Lee un byte de la secuencia y hace avanzar la posición de la secuencia en un byte, o devuelve -1 si está al final de la secuencia.(Heredado de Stream).

System_CAPS_pubmethodSeek(Int64, SeekOrigin)

Establece la posición actual de la secuencia en el valor especificado. Este método no se admite actualmente y siempre produce una NotSupportedException.(Invalida Stream.Seek(Int64, SeekOrigin)).

System_CAPS_pubmethodSetLength(Int64)

Establece la longitud del flujo. Este método siempre produce una NotSupportedException.(Invalida Stream.SetLength(Int64)).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_pubmethodWrite(Byte[], Int32, Int32)

Escribe datos en el NetworkStream.(Invalida Stream.Write(Byte[], Int32, Int32)).

System_CAPS_pubmethodWriteAsync(Byte[], Int32, Int32)

Escribe asincrónicamente una secuencia de bytes en la secuencia actual y avanza la posición actual en esta secuencia según el número de bytes escritos.(Heredado de Stream).

System_CAPS_pubmethodWriteAsync(Byte[], Int32, Int32, CancellationToken)

Escribe de forma asincrónica una secuencia de bytes en la secuencia actual, se hace avanzar la posición actual dentro de la secuencia el número de bytes escritos y controla las solicitudes de cancelación.(Heredado de Stream).

System_CAPS_pubmethodWriteByte(Byte)

Escribe un byte a la posición actual en la secuencia y avanza la posición de la secuencia en un byte.(Heredado de Stream).

La NetworkStream clase proporciona métodos para enviar y recibir datos a través de Stream sockets en modo de bloqueo. Para obtener más información sobre cómo bloquear o incompatibilidad Sockets, consulte Usar un socket de cliente asincrónico. Puede usar el NetworkStream clase para la transferencia de datos sincrónica y asincrónica. Para obtener más información acerca de la comunicación sincrónica y asincrónica, vea Sockets.

Para crear un NetworkStream, debe proporcionar una conexión Socket. También puede especificar qué FileAccess permiso la NetworkStream tiene sobre proporcionado Socket. De forma predeterminada, cerrar la NetworkStream no cierra proporcionado Socket. Si desea que la NetworkStream tenga permiso para cerrar el Socket, debe especificar true para el valor de la ownsSocket parámetro.

Utilice la Write y Read métodos para sencilla con un solo subproceso de E/S sincrónica de bloqueo. Si desea procesar la E/S mediante subprocesos independientes, considere el uso de la BeginWrite y EndWrite métodos, o la BeginRead y EndRead métodos para la comunicación.

El NetworkStream no admite el acceso aleatorio a la secuencia de datos de la red. El valor de la CanSeek propiedad, que indica si la secuencia admite búsquedas, es siempre false; cuando se lee el Position propiedad, leer el Length propiedad o llamar a la Seek método producirá un NotSupportedException.

Lectura y escritura de las operaciones se pueden realizar simultáneamente en una instancia de la NetworkStream clase sin la necesidad de sincronización. Mientras hay un subproceso único para las operaciones de escritura y un subproceso único para las operaciones de lectura, no habrá ninguna interferencia cruzada entre lectura y escritura subprocesos y ninguna sincronización es necesaria.

En el ejemplo de código siguiente se muestra cómo crear un NetworkStream desde una conexión StreamSocket y realizar operaciones básicas E/S sincrónica de bloqueo.

// Examples for constructors that do not specify file permission.

// Create the NetworkStream for communicating with the remote host.
NetworkStream myNetworkStream;

if (networkStreamOwnsSocket){
     myNetworkStream = new NetworkStream(mySocket, true);          
}
else{
     myNetworkStream = new NetworkStream(mySocket);     
}

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: