AnonymousPipeServerStream Clase

Definición

Espacio de nombres:

System.IO.Pipes

Ensamblado:

System.IO.Pipes.dll

Source:

AnonymousPipeServerStream.cs

Expone una secuencia alrededor de una canalización anónima, que admite operaciones de lectura y escritura sincrónicas y asincrónicas.

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

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

type AnonymousPipeServerStream = class
    inherit PipeStream

Public NotInheritable Class AnonymousPipeServerStream
Inherits PipeStream

Herencia

Object

MarshalByRefObject

Stream

PipeStream

AnonymousPipeServerStream

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 PipeDirection.Out. También crea un objeto AnonymousPipeClientStream en un proceso secundario con un valor PipeDirection de PipeDirection.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 servidor, que usa la clase AnonymousPipeServerStream. 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.dll>
#using <System.Core.dll>

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

ref class PipeServer
{
public:
    static void Main()
    {
        Process^ pipeClient = gcnew Process();

        pipeClient->StartInfo->FileName = "pipeClient.exe";

        AnonymousPipeServerStream^ pipeServer =
            gcnew AnonymousPipeServerStream(PipeDirection::Out,
            HandleInheritability::Inheritable);

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

        // Pass the client process a handle to the server.
        pipeClient->StartInfo->Arguments =
            pipeServer->GetClientHandleAsString();
        pipeClient->StartInfo->UseShellExecute = false;
        pipeClient->Start();

        pipeServer->DisposeLocalCopyOfClientHandle();

        try
        {
            // Read user input and send that to the client process.
            StreamWriter^ sw = gcnew StreamWriter(pipeServer);

            sw->AutoFlush = true;
            // Send a 'sync message' and wait for client to receive it.
            sw->WriteLine("SYNC");
            pipeServer->WaitForPipeDrain();
            // Send the console input to the client process.
            Console::Write("[SERVER] Enter text: ");
            sw->WriteLine(Console::ReadLine());
            sw->Close();
        }
        // Catch the IOException that is raised if the pipe is broken
        // or disconnected.
        catch (IOException^ e)
        {
            Console::WriteLine("[SERVER] Error: {0}", e->Message);
        }
        pipeServer->Close();
        pipeClient->WaitForExit();
        pipeClient->Close();
        Console::WriteLine("[SERVER] Client quit. Server terminating.");
    }
};

int main()
{
    PipeServer::Main();
}
//</snippet01>

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

class PipeServer
{
    static void Main()
    {
        Process pipeClient = new Process();

        pipeClient.StartInfo.FileName = "pipeClient.exe";

        using (AnonymousPipeServerStream pipeServer =
            new AnonymousPipeServerStream(PipeDirection.Out,
            HandleInheritability.Inheritable))
        {
            Console.WriteLine("[SERVER] Current TransmissionMode: {0}.",
                pipeServer.TransmissionMode);

            // Pass the client process a handle to the server.
            pipeClient.StartInfo.Arguments =
                pipeServer.GetClientHandleAsString();
            pipeClient.StartInfo.UseShellExecute = false;
            pipeClient.Start();

            pipeServer.DisposeLocalCopyOfClientHandle();

            try
            {
                // Read user input and send that to the client process.
                using (StreamWriter sw = new StreamWriter(pipeServer))
                {
                    sw.AutoFlush = true;
                    // Send a 'sync message' and wait for client to receive it.
                    sw.WriteLine("SYNC");
                    pipeServer.WaitForPipeDrain();
                    // Send the console input to the client process.
                    Console.Write("[SERVER] Enter text: ");
                    sw.WriteLine(Console.ReadLine());
                }
            }
            // Catch the IOException that is raised if the pipe is broken
            // or disconnected.
            catch (IOException e)
            {
                Console.WriteLine("[SERVER] Error: {0}", e.Message);
            }
        }

        pipeClient.WaitForExit();
        pipeClient.Close();
        Console.WriteLine("[SERVER] Client quit. Server terminating.");
    }
}
//</snippet01>

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

Class PipeServer
    Shared Sub Main()
        Dim pipeClient As New Process()

        pipeClient.StartInfo.FileName = "pipeClient.exe"

        Using pipeServer As New AnonymousPipeServerStream(PipeDirection.Out, _
            HandleInheritability.Inheritable)

            Console.WriteLine("[SERVER] Current TransmissionMode: {0}.",
                pipeServer.TransmissionMode)

            ' Pass the client process a handle to the server.
            pipeClient.StartInfo.Arguments = pipeServer.GetClientHandleAsString()
            pipeClient.StartInfo.UseShellExecute = false
            pipeClient.Start()

            pipeServer.DisposeLocalCopyOfClientHandle()

            Try
                ' Read user input and send that to the client process.
                Using sw As New StreamWriter(pipeServer)
                    sw.AutoFlush = true
                    ' Send a 'sync message' and wait for client to receive it.
                    sw.WriteLine("SYNC")
                    pipeServer.WaitForPipeDrain()
                    ' Send the console input to the client process.
                    Console.Write("[SERVER] Enter text: ")
                    sw.WriteLine(Console.ReadLine())
                End Using
            Catch e As IOException
                ' Catch the IOException that is raised if the pipe is broken
                ' or disconnected.
                Console.WriteLine("[SERVER] Error: {0}", e.Message)
            End Try
        End Using

        pipeClient.WaitForExit()
        pipeClient.Close()
        Console.WriteLine("[SERVER] Client quit. Server terminating.")
    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 AnonymousPipeServerStream permite que un proceso primario envíe o reciba información de un proceso secundario.

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 AnonymousPipeClientStream como parámetro pipeHandleAsString.

El objeto AnonymousPipeServerStream debe eliminar el identificador de cliente mediante el método DisposeLocalCopyOfClientHandle para recibir una notificación cuando el cliente salga.

Constructores

AnonymousPipeServerStream()	Inicializa una nueva instancia de la clase AnonymousPipeServerStream.
AnonymousPipeServerStream(PipeDirection)	Inicializa una nueva instancia de la clase AnonymousPipeServerStream con la dirección de canalización especificada.
AnonymousPipeServerStream(PipeDirection, HandleInheritability)	Inicializa una nueva instancia de la clase AnonymousPipeServerStream con la dirección de canalización y el modo de heredar especificados.
AnonymousPipeServerStream(PipeDirection, HandleInheritability, Int32)	Inicializa una nueva instancia de la clase AnonymousPipeServerStream con la dirección de canalización, el modo de heredar y el tamaño de búfer especificados.
AnonymousPipeServerStream(PipeDirection, SafePipeHandle, SafePipeHandle)	Inicializa una nueva instancia de la clase AnonymousPipeServerStream a partir de los identificadores de canalización especificados.

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)
ClientSafePipeHandle	Obtiene el identificador seguro del objeto AnonymousPipeClientStream que está conectado actualmente al objeto AnonymousPipeServerStream.
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 AnonymousPipeServerStream. En el caso de las canalizaciones anónimas, el modo de transmisión debe ser Byte.
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 compatible con 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)	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)
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)
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)
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)	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, 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)
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)
DisposeLocalCopyOfClientHandle()	Cierra la copia local del identificador del objeto AnonymousPipeClientStream.
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 AnonymousPipeServerStream.
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)
GetClientHandleAsString()	Obtiene el identificador del objeto AnonymousPipeClientStream conectado como una cadena.
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)	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(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(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)	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(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(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.