NamedPipeServerStream Constructores

Definición

Espacio de nombres:

System.IO.Pipes

Ensamblado:

System.IO.Pipes.dll

Inicializa una nueva instancia de la clase NamedPipeServerStream.

Sobrecargas

NamedPipeServerStream(String)	Inicializa una nueva instancia de la clase NamedPipeServerStream con el nombre de canalización especificado.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)	Inicializa una nueva instancia de la clase NamedPipeServerStream con las características nombre de canalización, dirección de canalización, número máximo de instancias de servidor, modo de transmisión y opciones de canalización especificadas, y los tamaños de búfer de entrada y salida recomendados.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)	Inicializa una nueva instancia de la clase NamedPipeServerStream con las características nombre de canalización, dirección de canalización, número máximo de instancias de servidor, modo de transmisión y opciones de canalización especificadas.
NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Inicializa una nueva instancia de la clase NamedPipeServerStream a partir del identificador de canalización especificado.
NamedPipeServerStream(String, PipeDirection, Int32)	Inicializa una nueva instancia de la clase NamedPipeServerStream con las características nombre de canalización, dirección de canalización y número máximo de instancias de servidor especificadas.
NamedPipeServerStream(String, PipeDirection)	Inicializa una nueva instancia de la clase NamedPipeServerStream con el nombre y dirección de canalización especificados.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)	Inicializa una nueva instancia de la clase NamedPipeServerStream con las características nombre de canalización, dirección de canalización, número máximo de instancias de servidor y modo de transmisión especificadas.

NamedPipeServerStream(String)

Source:

NamedPipeServerStream.cs

Inicializa una nueva instancia de la clase NamedPipeServerStream con el nombre de canalización especificado.

public:
 NamedPipeServerStream(System::String ^ pipeName);

public NamedPipeServerStream (string pipeName);

new System.IO.Pipes.NamedPipeServerStream : string -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String)

Parámetros

pipeName

String

Nombre de la canalización.

Excepciones

ArgumentNullException

pipeName es null.

ArgumentException

pipeName es cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

NotSupportedException

pipeName contiene un carácter de dos puntos (":").

IOException

Se ha superado el número máximo instancias de servidor.

Comentarios

Este constructor crea un NamedPipeServerStream objeto que tiene las siguientes características:

• Dirección de canalización predeterminada de InOut.

• Número máximo de instancias de servidor que comparten el mismo nombre establecido en 1.

• Valor PipeTransmissionMode de Byte.

• Valor PipeOptions de None.

• Tamaños predeterminados del búfer de entrada y salida.

• Sin seguridad de canalización.

• Valor HandleInheritability de None.

• No se especificó ningún elemento adicional PipeAccessRights.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)

Source:

NamedPipeServerStream.cs

Inicializa una nueva instancia de la clase NamedPipeServerStream con las características nombre de canalización, dirección de canalización, número máximo de instancias de servidor, modo de transmisión y opciones de canalización especificadas, y los tamaños de búfer de entrada y salida recomendados.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode, System::IO::Pipes::PipeOptions options, int inBufferSize, int outBufferSize);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options, int inBufferSize, int outBufferSize);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions * int * int -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions, inBufferSize As Integer, outBufferSize As Integer)

Parámetros

pipeName

String

Nombre de la canalización.

direction

PipeDirection

Uno de los valores de enumeración que determina la dirección de la canalización.

maxNumberOfServerInstances

Int32

Número máximo de instancias de servidor que comparten el mismo nombre. De manera opcional, se puede pasar MaxAllowedServerInstances para este valor.

transmissionMode

PipeTransmissionMode

Uno de los valores de enumeración que determina el modo de transmisión de la canalización.

options

PipeOptions

Uno de los valores de enumeración que determina cómo abrir o crear la canalización.

inBufferSize

Int32

Valor positivo mayor que 0 que indica el tamaño del búfer de entrada.

outBufferSize

Int32

Valor positivo mayor que 0 que indica el tamaño del búfer de salida.

Excepciones

ArgumentNullException

pipeName es null.

ArgumentException

pipeName es cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

o bien

direction no es un valor PipeDirection válido.

o bien

El valor de maxNumberofServerInstances es menor que -1 o mayor que 254 (-1 indica MaxAllowedServerInstances)

o bien

options no es un valor PipeOptions válido.

o bien

inBufferSize es negativo.

NotSupportedException

pipeName contiene un carácter de dos puntos (":").

IOException

Se ha superado el número máximo instancias de servidor.

Comentarios

Este constructor crea un NamedPipeServerStream objeto que tiene las siguientes características:

• No hay seguridad adicional de canalización.

• Valor predeterminado HandleInheritability de None.

• No se especificó ningún elemento adicional PipeAccessRights.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)

Source:

NamedPipeServerStream.cs

Inicializa una nueva instancia de la clase NamedPipeServerStream con las características nombre de canalización, dirección de canalización, número máximo de instancias de servidor, modo de transmisión y opciones de canalización especificadas.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode, System::IO::Pipes::PipeOptions options);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions)

Parámetros

pipeName

String

Nombre de la canalización.

direction

PipeDirection

Uno de los valores de enumeración que determina la dirección de la canalización.

maxNumberOfServerInstances

Int32

Número máximo de instancias de servidor que comparten el mismo nombre. De manera opcional, se puede pasar MaxAllowedServerInstances para este valor.

transmissionMode

PipeTransmissionMode

Uno de los valores de enumeración que determina el modo de transmisión de la canalización.

options

PipeOptions

Uno de los valores de enumeración que determina cómo abrir o crear la canalización.

Excepciones

ArgumentNullException

pipeName es null.

ArgumentException

pipeName es cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

o bien

direction no es un valor PipeDirection válido.

o bien

El valor de maxNumberofServerInstances es menor que -1 o mayor que 254 (-1 indica MaxAllowedServerInstances)

o bien

options no es un valor PipeOptions válido.

NotSupportedException

pipeName contiene un carácter de dos puntos (":").

IOException

Se ha superado el número máximo instancias de servidor.

Comentarios

Este constructor crea un NamedPipeServerStream objeto que tiene las siguientes características:

• Tamaños predeterminados del búfer de entrada y salida.

• Sin seguridad de canalización.

• Valor HandleInheritability de None.

• No se especificó ningún elemento adicional PipeAccessRights.

NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Source:

NamedPipeServerStream.Unix.cs

Inicializa una nueva instancia de la clase NamedPipeServerStream a partir del identificador de canalización especificado.

public:
 NamedPipeServerStream(System::IO::Pipes::PipeDirection direction, bool isAsync, bool isConnected, Microsoft::Win32::SafeHandles::SafePipeHandle ^ safePipeHandle);

public NamedPipeServerStream (System.IO.Pipes.PipeDirection direction, bool isAsync, bool isConnected, Microsoft.Win32.SafeHandles.SafePipeHandle safePipeHandle);

new System.IO.Pipes.NamedPipeServerStream : System.IO.Pipes.PipeDirection * bool * bool * Microsoft.Win32.SafeHandles.SafePipeHandle -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (direction As PipeDirection, isAsync As Boolean, isConnected As Boolean, safePipeHandle As SafePipeHandle)

Parámetros

direction

PipeDirection

Uno de los valores de enumeración que determina la dirección de la canalización.

isAsync

Boolean

Es true para indicar que se abrió el identificador de forma asincrónica; en caso contrario, es false.

isConnected

Boolean

Es true para indicar que la canalización está conectada; de lo contrario, es false.

safePipeHandle

SafePipeHandle

Controlador seguro para la canalización que este objeto NamedPipeServerStream encapsulará.

Excepciones

ArgumentOutOfRangeException

direction no es un valor PipeDirection válido.

ArgumentNullException

safePipeHandle es null.

ArgumentException

safePipeHandle es un controlador no válido.

IOException

El valor de safePipeHandle no es un identificador de canalización válido.

O bien

Se ha superado el número máximo instancias de servidor.

NamedPipeServerStream(String, PipeDirection, Int32)

Source:

NamedPipeServerStream.cs

Inicializa una nueva instancia de la clase NamedPipeServerStream con las características nombre de canalización, dirección de canalización y número máximo de instancias de servidor especificadas.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer)

Parámetros

pipeName

String

Nombre de la canalización.

direction

PipeDirection

Uno de los valores de enumeración que determina la dirección de la canalización.

maxNumberOfServerInstances

Int32

Número máximo de instancias de servidor que comparten el mismo nombre. De manera opcional, se puede pasar MaxAllowedServerInstances para este valor.

Excepciones

ArgumentNullException

pipeName es null.

ArgumentException

pipeName es cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

o bien

direction no es un valor PipeDirection válido.

o bien

Se requiere un número no negativo.

o bien

El valor de maxNumberofServerInstances es menor que -1 o mayor que 254 (-1 indica MaxAllowedServerInstances)

O bien

Es necesario None o Inheritable.

O bien

Los derechos de acceso se limitan a las marcas ChangePermissions, TakeOwnership y AccessSystemSecurity.

NotSupportedException

pipeName contiene un carácter de dos puntos (":").

IOException

Se ha superado el número máximo instancias de servidor.

Comentarios

Este constructor crea un NamedPipeServerStream objeto que tiene las siguientes características:

• Valor predeterminado de 1 para el número máximo de instancias de servidor que comparten el mismo nombre.

• Valor predeterminado PipeTransmissionMode de Byte.

• Valor PipeOptions de None.

• Tamaños predeterminados del búfer de entrada y salida.

• Sin seguridad de canalización.

• Valor HandleInheritability de None.

• No se especificó ningún elemento adicional PipeAccessRights.

NamedPipeServerStream(String, PipeDirection)

Source:

NamedPipeServerStream.cs

Inicializa una nueva instancia de la clase NamedPipeServerStream con el nombre y dirección de canalización especificados.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection)

Parámetros

pipeName

String

Nombre de la canalización.

direction

PipeDirection

Uno de los valores de enumeración que determina la dirección de la canalización.

Excepciones

ArgumentNullException

pipeName es null.

ArgumentException

pipeName es cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

o bien

direction no es un valor PipeDirection válido.

NotSupportedException

pipeName contiene un carácter de dos puntos (":").

IOException

Se ha superado el número máximo instancias de servidor.

Ejemplos

En el ejemplo siguiente se muestra un método para enviar una cadena de un proceso primario a un proceso secundario mediante canalizaciones con nombre. En este ejemplo se crea un NamedPipeServerStream objeto en un proceso primario. El NamedPipeServerStream objeto tiene un PipeDirection valor de Out, que luego se bloquea hasta que un NamedPipeClientStream objeto establece una conexión con el objeto actual NamedPipeServerStream .

using System;
using System.IO;
using System.IO.Pipes;

class PipeServer
{
    static void Main()
    {
        using (NamedPipeServerStream pipeServer =
            new NamedPipeServerStream("testpipe", PipeDirection.Out))
        {
            Console.WriteLine("NamedPipeServerStream object created.");

            // Wait for a client to connect
            Console.Write("Waiting for client connection...");
            pipeServer.WaitForConnection();

            Console.WriteLine("Client connected.");
            try
            {
                // Read user input and send that to the client process.
                using (StreamWriter sw = new StreamWriter(pipeServer))
                {
                    sw.AutoFlush = true;
                    Console.Write("Enter text: ");
                    sw.WriteLine(Console.ReadLine());
                }
            }
            // Catch the IOException that is raised if the pipe is broken
            // or disconnected.
            catch (IOException e)
            {
                Console.WriteLine("ERROR: {0}", e.Message);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Pipes

Class PipeServer

    Shared Sub Main()
        Dim pipeServer As New NamedPipeServerStream("testpipe", PipeDirection.Out)

        Console.WriteLine("NamedPipeServerStream object created.")

        ' Wait for a client to connect
        Console.Write("Waiting for a client connection...")
        pipeServer.WaitForConnection()

        Console.WriteLine("Client connected.")
        Try
            'Read user input and send that to the client process.
            Dim sw As New StreamWriter(pipeServer)
            sw.AutoFlush = True
            Console.Write("Enter Text: ")
            sw.WriteLine(Console.ReadLine())
        Catch ex As IOException
            ' Catch the IOException that is raised if the pipe is broken
            ' or disconnected
            Console.WriteLine("ERROR: {0}", ex.Message)
        End Try
    End Sub
End Class

Comentarios

Este constructor crea un NamedPipeServerStream objeto que tiene las siguientes características:

• Valor PipeTransmissionMode de Byte.

• Valor PipeOptions de None.

• Tamaños predeterminados del búfer de entrada y salida.

• Sin seguridad de canalización.

• Valor HandleInheritability de None.

• No se especificó ningún elemento adicional PipeAccessRights.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)

Source:

NamedPipeServerStream.cs

Inicializa una nueva instancia de la clase NamedPipeServerStream con las características nombre de canalización, dirección de canalización, número máximo de instancias de servidor y modo de transmisión especificadas.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode)

Parámetros

pipeName

String

Nombre de la canalización.

direction

PipeDirection

Uno de los valores de enumeración que determina la dirección de la canalización.

maxNumberOfServerInstances

Int32

Número máximo de instancias de servidor que comparten el mismo nombre. De manera opcional, se puede pasar MaxAllowedServerInstances para este valor.

transmissionMode

PipeTransmissionMode

Uno de los valores de enumeración que determina el modo de transmisión de la canalización.

Excepciones

ArgumentNullException

pipeName es null.

ArgumentException

pipeName es cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

o bien

direction no es un valor PipeDirection válido.

o bien

El valor de maxNumberofServerInstances es menor que -1 o mayor que 254 (-1 indica MaxAllowedServerInstances)

NotSupportedException

pipeName contiene un carácter de dos puntos (":").

IOException

Se ha superado el número máximo instancias de servidor.

Comentarios

Este constructor crea un NamedPipeServerStream objeto que tiene las siguientes características:

• Valor predeterminado PipeOptions de None.

• Tamaños predeterminados del búfer de entrada y salida.

• Sin seguridad de canalización.

• Valor HandleInheritability de None.

• No se especificó ningún elemento adicional PipeAccessRights.