AnonymousPipeClientStream Clase

Definición

Espacio de nombres:

System.IO.Pipes

Ensamblado:

System.IO.Pipes.dll

Source:

AnonymousPipeClientStream.cs

Expone el lado cliente de una secuencia de canalización anónima, que admite operaciones de lectura y escritura sincrónicas y asincrónicas (sin compatibilidad con cancelación en plataformas Windows).

public ref class AnonymousPipeClientStream sealed : System::IO::Pipes::PipeStream

public sealed class AnonymousPipeClientStream : System.IO.Pipes.PipeStream

type AnonymousPipeClientStream = class
    inherit PipeStream

Public NotInheritable Class AnonymousPipeClientStream
Inherits PipeStream

Herencia

Object

MarshalByRefObject

Stream

PipeStream

AnonymousPipeClientStream

Ejemplos

En el ejemplo siguiente se envía una cadena de un proceso primario a un proceso secundario mediante canalizaciones anónimas. En este ejemplo se crea un objeto AnonymousPipeServerStream en un proceso primario con un valor de PipeDirection de Out. También crea un objeto AnonymousPipeClientStream en un proceso secundario con un valor PipeDirection de In. A continuación, el proceso primario envía una cadena proporcionada por el usuario al proceso secundario. La cadena se muestra en la consola.

Este ejemplo es para el proceso de cliente, que el proceso del servidor inicia. Asigne al archivo ejecutable resultante el nombre del código de cliente pipeClient.exe y cópielo en el mismo directorio que el ejecutable del servidor al ejecutar este ejemplo. Para obtener todo el ejemplo de código, incluido el código para el cliente de canalización y el servidor, vea How to: Use Anonymous Pipes for Local Interprocess Communication.

//<snippet01>
#using <System.Core.dll>

using namespace System;
using namespace System::IO;
using namespace System::IO::Pipes;

ref class PipeClient
{
public:
    static void Main(array<String^>^ args)
    {
        if (args->Length > 1)
        {
            PipeStream^ pipeClient = gcnew AnonymousPipeClientStream(PipeDirection::In, args[1]);

            Console::WriteLine("[CLIENT] Current TransmissionMode: {0}.",
                pipeClient->TransmissionMode);

            StreamReader^ sr = gcnew StreamReader(pipeClient);

            // Display the read text to the console
            String^ temp;

            // Wait for 'sync message' from the server.
            do
            {
                Console::WriteLine("[CLIENT] Wait for sync...");
                temp = sr->ReadLine();
            }
            while (!temp->StartsWith("SYNC"));

            // Read the server data and echo to the console.
            while ((temp = sr->ReadLine()) != nullptr)
            {
                Console::WriteLine("[CLIENT] Echo: " + temp);
            }
            sr->Close();
            pipeClient->Close();
        }
        Console::Write("[CLIENT] Press Enter to continue...");
        Console::ReadLine();
    }
};

int main()
{
    array<String^>^ args = Environment::GetCommandLineArgs();
    PipeClient::Main(args);
}
//</snippet01>

//<snippet01>
using System;
using System.IO;
using System.IO.Pipes;

class PipeClient
{
    static void Main(string[] args)
    {
        if (args.Length > 0)
        {
            using (PipeStream pipeClient =
                new AnonymousPipeClientStream(PipeDirection.In, args[0]))
            {
                Console.WriteLine("[CLIENT] Current TransmissionMode: {0}.",
                   pipeClient.TransmissionMode);

                using (StreamReader sr = new StreamReader(pipeClient))
                {
                    // Display the read text to the console
                    string temp;

                    // Wait for 'sync message' from the server.
                    do
                    {
                        Console.WriteLine("[CLIENT] Wait for sync...");
                        temp = sr.ReadLine();
                    }
                    while (!temp.StartsWith("SYNC"));

                    // Read the server data and echo to the console.
                    while ((temp = sr.ReadLine()) != null)
                    {
                        Console.WriteLine("[CLIENT] Echo: " + temp);
                    }
                }
            }
        }
        Console.Write("[CLIENT] Press Enter to continue...");
        Console.ReadLine();
    }
}
//</snippet01>

'<snippet01>
Imports System.IO
Imports System.IO.Pipes

Class PipeClient
    Shared Sub Main(args() as String)
        If args.Length > 0 Then
            Using pipeClient As New AnonymousPipeClientStream(PipeDirection.In, args(0))
                Console.WriteLine("[CLIENT] Current TransmissionMode: {0}.", _
                   pipeClient.TransmissionMode)

                Using sr As New StreamReader(pipeClient)
                    ' Display the read text to the console
                    Dim temp As String

                    ' Wait for 'sync message' from the server.
                    Do
                        Console.WriteLine("[CLIENT] Wait for sync...")
                        temp = sr.ReadLine()
                    Loop While temp.StartsWith("SYNC") = False

                    ' Read the server data and echo to the console.
                    temp = sr.ReadLine()
                    While Not temp = Nothing
                        Console.WriteLine("[CLIENT] Echo: " + temp)
                        temp = sr.ReadLine()
                    End While
                End Using
            End Using
        End If
        Console.Write("[CLIENT] Press Enter to continue...")
        Console.ReadLine()
    End Sub
End Class
'</snippet01>

Comentarios

Las canalizaciones anónimas ayudan a proporcionar una comunicación entre procesos secundarios y primarios seguros y seguros. La clase AnonymousPipeClientStream permite que un proceso secundario se conecte y intercambie información con un proceso primario.

Las canalizaciones anónimas no tienen nombre, canalizaciones unidireccionales que normalmente transfieren datos entre procesos primarios y secundarios. Las canalizaciones anónimas siempre son locales; no se pueden usar a través de una red. No se admite un PipeDirection valor de InOut porque las canalizaciones anónimas se definen como unidireccionales.

Las canalizaciones anónimas no admiten el modo de lectura PipeTransmissionMode.Message.

El lado cliente de una canalización anónima debe crearse a partir de un identificador de canalización proporcionado por el lado servidor llamando al método GetClientHandleAsString. A continuación, la cadena se pasa como parámetro al crear el proceso de cliente. Desde el proceso de cliente, se pasa al constructor de AnonymousPipeClientStream como parámetro pipeHandleAsString.

En Windows, las operaciones de lectura y escritura asincrónicas (superpuestas) no son compatibles con canalizaciones anónimas (consulte Operaciones de canalización anónimas). La clase AnonymousPipeClientStream seguirá programando el trabajo en el grupo de subprocesos en plataformas Windows, por lo que funcionan las operaciones asincrónicas Stream, pero no se admite la cancelación de esas operaciones.

Constructores

AnonymousPipeClientStream(PipeDirection, SafePipeHandle)	Inicializa una nueva instancia de la clase AnonymousPipeClientStream desde el identificador especificado.
AnonymousPipeClientStream(PipeDirection, String)	Inicializa una nueva instancia de la clase AnonymousPipeClientStream con la dirección de canalización especificada y una representación de cadena del identificador de canalización.
AnonymousPipeClientStream(String)	Inicializa una nueva instancia de la clase AnonymousPipeClientStream con la representación de cadena especificada del identificador de canalización.

Propiedades

CanRead	Obtiene un valor que indica si la secuencia actual admite operaciones de lectura. (Heredado de PipeStream)
CanSeek	Obtiene un valor que indica si la secuencia actual admite operaciones de búsqueda. (Heredado de PipeStream)
CanTimeout	Obtiene un valor que determina si la secuencia actual puede agotar el tiempo de espera. (Heredado de Stream)
CanWrite	Obtiene un valor que indica si la secuencia actual admite operaciones de escritura. (Heredado de PipeStream)
InBufferSize	Obtiene el tamaño, en bytes, del búfer de entrada para una canalización. (Heredado de PipeStream)
IsAsync	Obtiene un valor que indica si un objeto PipeStream se abrió de forma asincrónica o sincrónica. (Heredado de PipeStream)
IsConnected	Obtiene o establece un valor que indica si un objeto PipeStream está conectado. (Heredado de PipeStream)
IsHandleExposed	Obtiene un valor que indica si se expone un identificador a un objeto PipeStream. (Heredado de PipeStream)
IsMessageComplete	Obtiene un valor que indica si hay más datos en el mensaje devuelto por la operación de lectura más reciente. (Heredado de PipeStream)
Length	Obtiene la longitud de una secuencia, en bytes. (Heredado de PipeStream)
OutBufferSize	Obtiene el tamaño, en bytes, del búfer de salida de una canalización. (Heredado de PipeStream)
Position	Obtiene o establece la posición actual de la secuencia actual. (Heredado de PipeStream)
ReadMode	Establece el modo de lectura del objeto AnonymousPipeClientStream.
ReadTimeout	Obtiene o establece un valor, en milisegundos, que determina cuánto tiempo intentará leer la secuencia antes de que se agote el tiempo de espera. (Heredado de Stream)
SafePipeHandle	Obtiene el identificador seguro para el extremo local de la canalización que el objeto PipeStream actual encapsula. (Heredado de PipeStream)
TransmissionMode	Obtiene el modo de transmisión de canalización admitido por la canalización actual.
WriteTimeout	Obtiene o establece un valor, en milisegundos, que determina cuánto tiempo intentará escribir la secuencia antes de que se agote el tiempo de espera. (Heredado de Stream)

Métodos

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Inicia una operación de lectura asincrónica. (Heredado de PipeStream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Comienza una operación de escritura asincrónica. (Heredado de PipeStream)
CheckPipePropertyOperations()	Comprueba que la canalización está en un estado adecuado para obtener o establecer propiedades. (Heredado de PipeStream)
CheckReadOperations()	Comprueba que la canalización está en un estado conectado para las operaciones de lectura. (Heredado de PipeStream)
CheckWriteOperations()	Comprueba que la canalización está en un estado conectado para las operaciones de escritura. (Heredado de PipeStream)
Close()	Cierra la secuencia actual y libera los recursos (como sockets y identificadores de archivo) asociados a la secuencia actual. En lugar de llamar a este método, asegúrese de que la secuencia se elimina correctamente. (Heredado de Stream)
CopyTo(Stream, Int32)	Lee los bytes de la secuencia actual y los escribe en otra secuencia mediante un tamaño de búfer especificado. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CopyTo(Stream)	Lee los bytes de la secuencia actual y los escribe en otra secuencia. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CopyToAsync(Stream, CancellationToken)	Lee asincrónicamente los bytes de la secuencia actual y los escribe en otra secuencia, mediante un token de cancelación especificado. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CopyToAsync(Stream, Int32, CancellationToken)	Lee asincrónicamente los bytes de la secuencia actual y los escribe en otra secuencia, mediante un tamaño de búfer y un token de cancelación especificados. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CopyToAsync(Stream, Int32)	Lee de forma asincrónica los bytes de la secuencia actual y los escribe en otra secuencia mediante un tamaño de búfer especificado. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CopyToAsync(Stream)	Lee asincrónicamente los bytes de la secuencia actual y los escribe en otra secuencia. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. (Heredado de Stream)
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
CreateWaitHandle()	Obsoletos. Asigna un objeto WaitHandle. (Heredado de Stream)
Dispose()	Libera todos los recursos usados por el Stream. (Heredado de Stream)
Dispose(Boolean)	Libera los recursos no administrados utilizados por la clase PipeStream y, opcionalmente, libera los recursos administrados. (Heredado de PipeStream)
DisposeAsync()	Libera asincrónicamente los recursos no administrados usados por el Stream. (Heredado de Stream)
EndRead(IAsyncResult)	Finaliza una solicitud de lectura asincrónica pendiente. (Heredado de PipeStream)
EndWrite(IAsyncResult)	Finaliza una solicitud de escritura asincrónica pendiente. (Heredado de PipeStream)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
Finalize()	Libera recursos no administrados y realiza otras operaciones de limpieza antes de que la recolección de elementos no utilizados recupere la instancia de AnonymousPipeClientStream.
Flush()	Borra el búfer de la secuencia actual y hace que los datos almacenados en búfer se escriban en el dispositivo subyacente. (Heredado de PipeStream)
FlushAsync()	Borra de forma asincrónica 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)
FlushAsync(CancellationToken)	Borra de forma asincrónica el búfer de la secuencia actual y hace que los datos almacenados en búfer se escriban en el dispositivo subyacente. (Heredado de PipeStream)
GetAccessControl()	Obtiene un objeto PipeSecurity que encapsula las entradas de la lista de control de acceso (ACL) para la canalización descrita por el objeto PipeStream actual. (Heredado de PipeStream)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeHandle(SafePipeHandle, Boolean, Boolean)	Inicializa un objeto PipeStream a partir del objeto SafePipeHandle especificado. (Heredado de PipeStream)
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
ObjectInvariant()	Obsoletos. Proporciona compatibilidad con un Contract. (Heredado de Stream)
Read(Byte[], Int32, Int32)	Lee un bloque de bytes de una secuencia y escribe los datos en un búfer especificado a partir de una posición especificada para una longitud especificada. (Heredado de PipeStream)
Read(Span<Byte>)	Lee una secuencia de bytes de la secuencia actual, las escribe en una matriz de bytes y avanza la posición dentro de la secuencia por el número de bytes leídos. (Heredado de PipeStream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Lee de forma asincrónica una secuencia de bytes de la secuencia actual a una matriz de bytes que comienza en una posición especificada para un número especificado de bytes, avanza la posición dentro de la secuencia por el número de bytes leídos y supervisa las solicitudes de cancelación. (Heredado de PipeStream)
ReadAsync(Byte[], Int32, Int32)	Lee de forma asincrónica una secuencia de bytes de la secuencia actual y avanza la posición dentro de la secuencia por el número de bytes leídos. (Heredado de Stream)
ReadAsync(Memory<Byte>, CancellationToken)	Lee de forma asincrónica una secuencia de bytes de la secuencia actual, las escribe en un intervalo de memoria de bytes, avanza la posición dentro de la secuencia por el número de bytes leídos y supervisa las solicitudes de cancelación. (Heredado de PipeStream)
ReadAtLeast(Span<Byte>, Int32, Boolean)	Lee al menos un número mínimo de bytes de la secuencia actual y avanza la posición dentro de la secuencia por el número de bytes leídos. (Heredado de Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	Lee de forma asincrónica al menos un número mínimo de bytes de la secuencia actual, avanza la posición dentro de la secuencia por el número de bytes leídos y supervisa las solicitudes de cancelación. (Heredado de Stream)
ReadByte()	Lee un byte de una canalización. (Heredado de PipeStream)
ReadExactly(Byte[], Int32, Int32)	Lee count número de bytes de la secuencia actual y avanza la posición dentro de la secuencia. (Heredado de Stream)
ReadExactly(Span<Byte>)	Lee bytes de la secuencia actual y avanza la posición dentro de la secuencia hasta que se rellena el buffer. (Heredado de Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Lee de forma asincrónica count número de bytes de la secuencia actual, avanza la posición dentro de la secuencia y supervisa las solicitudes de cancelación. (Heredado de Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Lee de forma asincrónica bytes de la secuencia actual, avanza la posición dentro de la secuencia hasta que se rellena el buffer y supervisa las solicitudes de cancelación. (Heredado de Stream)
Seek(Int64, SeekOrigin)	Establece la posición actual de la secuencia actual en el valor especificado. (Heredado de PipeStream)
SetAccessControl(PipeSecurity)	Aplica las entradas de la lista de control de acceso (ACL) especificadas por un objeto PipeSecurity a la canalización especificada por el objeto PipeStream actual. (Heredado de PipeStream)
SetLength(Int64)	Establece la longitud de la secuencia actual en el valor especificado. (Heredado de PipeStream)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
WaitForPipeDrain()	Espera a que el otro extremo de la canalización lea todos los bytes enviados. (Heredado de PipeStream)
Write(Byte[], Int32, Int32)	Escribe un bloque de bytes en el flujo actual mediante datos de un búfer. (Heredado de PipeStream)
Write(ReadOnlySpan<Byte>)	Escribe una secuencia de bytes en la secuencia actual y avanza la posición actual dentro de esta secuencia por el número de bytes escritos. (Heredado de PipeStream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Escribe de forma asincrónica un número especificado de bytes de una matriz de bytes a partir de una posición especificada, avanza la posición actual dentro de esta secuencia por el número de bytes escritos y supervisa las solicitudes de cancelación. (Heredado de PipeStream)
WriteAsync(Byte[], Int32, Int32)	Escribe de forma asincrónica una secuencia de bytes en la secuencia actual y avanza la posición actual dentro de esta secuencia por el número de bytes escritos. (Heredado de Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Escribe de forma asincrónica una secuencia de bytes en la secuencia actual, avanza la posición actual dentro de esta secuencia por el número de bytes escritos y supervisa las solicitudes de cancelación. (Heredado de PipeStream)
WriteByte(Byte)	Escribe un byte en la secuencia actual. (Heredado de PipeStream)

Métodos de extensión

CopyToAsync(Stream, PipeWriter, CancellationToken)	Lee asincrónicamente los bytes de la Stream y los escribe en el PipeWriterespecificado mediante un token de cancelación.
GetAccessControl(PipeStream)	Devuelve la información de seguridad de un flujo de canalización.
SetAccessControl(PipeStream, PipeSecurity)	Cambia los atributos de seguridad de un flujo de canalización existente.
ConfigureAwait(IAsyncDisposable, Boolean)	Configura cómo se realizarán las esperas en las tareas devueltas desde un descartable asincrónico.