NamedPipeClientStream Constructores

Definición

Espacio de nombres:

System.IO.Pipes

Ensamblado:

System.IO.Pipes.dll

Inicializa una nueva instancia de la clase NamedPipeClientStream.

Sobrecargas

NamedPipeClientStream(String)	Inicializa una nueva instancia de la clase NamedPipeClientStream con el nombre de canalización especificado.
NamedPipeClientStream(String, String)	Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados.
NamedPipeClientStream(String, String, PipeDirection)	Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados y la dirección de canalización especificada.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Inicializa una nueva instancia de la clase NamedPipeClientStream para el identificador de canalización especificado con la dirección de canalización especificada.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados, y la dirección y opciones de canalización especificadas.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados, y las características dirección de canalización, opciones de canalización y nivel de suplantación de seguridad especificadas.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados, y las características dirección de canalización, opciones de canalización, nivel de suplantación de seguridad y modo de herencia especificadas.

NamedPipeClientStream(String)

Source:

NamedPipeClientStream.cs

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

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

public NamedPipeClientStream (string pipeName);

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

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".

Comentarios

Este constructor usa los siguientes valores predeterminados:

• Nombre de servidor predeterminado de ".".

• Valor predeterminado PipeDirection de InOut.

• Valor predeterminado PipeOptions de None.

• Valor predeterminado TokenImpersonationLevel de None.

• Valor predeterminado HandleInheritability de None.

NamedPipeClientStream(String, String)

Source:

NamedPipeClientStream.cs

Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados.

public:
 NamedPipeClientStream(System::String ^ serverName, System::String ^ pipeName);

public NamedPipeClientStream (string serverName, string pipeName);

new System.IO.Pipes.NamedPipeClientStream : string * string -> System.IO.Pipes.NamedPipeClientStream

Public Sub New (serverName As String, pipeName As String)

Parámetros

serverName

String

Nombre del equipo remoto al que se va a conectar; o bien, "." para especificar el equipo local.

pipeName

String

Nombre de la canalización.

Excepciones

ArgumentNullException

pipeName o serverName es null.

ArgumentException

pipeName o serverName es una cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

Comentarios

Este constructor usa los siguientes valores predeterminados:

• Valor predeterminado PipeDirection de InOut.

• Valor predeterminado PipeOptions de None.

• Valor predeterminado TokenImpersonationLevel de None.

• Valor predeterminado HandleInheritability de None.

NamedPipeClientStream(String, String, PipeDirection)

Source:

NamedPipeClientStream.cs

Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados y la dirección de canalización especificada.

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

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

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

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

Parámetros

serverName

String

Nombre del equipo remoto al que se va a conectar; o bien, "." para especificar el equipo local.

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 o serverName es null.

ArgumentException

pipeName o serverName es una cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

o bien

direction no es un valor PipeDirection válido.

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 NamedPipeClientStream objeto en un proceso secundario, que luego se conecta a una canalización en el equipo local. El ejemplo de servidor se puede ver en la NamedPipeServerStream clase . Este ejemplo forma parte de un ejemplo más grande proporcionado para las NamedPipeServerStream clases y NamedPipeClientStream .

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

class PipeClient
{
    static void Main(string[] args)
    {
        using (NamedPipeClientStream pipeClient =
            new NamedPipeClientStream(".", "testpipe", PipeDirection.In))
        {

            // Connect to the pipe or wait until the pipe is available.
            Console.Write("Attempting to connect to pipe...");
            pipeClient.Connect();

            Console.WriteLine("Connected to pipe.");
            Console.WriteLine("There are currently {0} pipe server instances open.",
               pipeClient.NumberOfServerInstances);
            using (StreamReader sr = new StreamReader(pipeClient))
            {
                // Display the read text to the console
                string temp;
                while ((temp = sr.ReadLine()) != null)
                {
                    Console.WriteLine("Received from server: {0}", temp);
                }
            }
        }
        Console.Write("Press Enter to continue...");
        Console.ReadLine();
    }
}

Imports System.IO
Imports System.IO.Pipes
Imports System.Security.Principal

Class PipeClient

    Shared Sub Main(ByVal args As String())

        Dim pipeClient As New NamedPipeClientStream("localhost", _
                    "testpipe", PipeDirection.In, PipeOptions.None)

        ' Connect to the pipe or wait until the pipe is available.
        Console.WriteLine("Attempting to connect to the pipe...")
        pipeClient.Connect()

        Console.WriteLine("Connect to the pipe.")
        Console.WriteLine("There are currently {0} pipe server instances open.", _
                          pipeClient.NumberOfServerInstances)

        Dim sr As New StreamReader(pipeClient)
        Dim temp As String

        temp = sr.ReadLine()
        While Not temp Is Nothing
            Console.WriteLine("Received from server: {0}", temp)
            temp = sr.ReadLine()
        End While
        Console.Write("Press Enter to continue...")
        Console.ReadLine()
    End Sub
End Class

Comentarios

Este constructor usa los siguientes valores predeterminados:

• Valor predeterminado PipeOptions de None.

• Valor predeterminado TokenImpersonationLevel de None.

• Valor predeterminado HandleInheritability de None.

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Source:

NamedPipeClientStream.cs

Inicializa una nueva instancia de la clase NamedPipeClientStream para el identificador de canalización especificado con la dirección de canalización especificada.

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

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

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

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 NamedPipeClientStream encapsulará.

Excepciones

IOException

Se ha cerrado la secuencia.

ArgumentException

safePipeHandle no es un controlador válido.

ArgumentNullException

safePipeHandle es null.

ArgumentOutOfRangeException

direction no es un valor PipeDirection válido.

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Source:

NamedPipeClientStream.cs

Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados, y la dirección y opciones de canalización especificadas.

public:
 NamedPipeClientStream(System::String ^ serverName, System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, System::IO::Pipes::PipeOptions options);

public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeDirection direction, System.IO.Pipes.PipeOptions options);

new System.IO.Pipes.NamedPipeClientStream : string * string * System.IO.Pipes.PipeDirection * System.IO.Pipes.PipeOptions -> System.IO.Pipes.NamedPipeClientStream

Public Sub New (serverName As String, pipeName As String, direction As PipeDirection, options As PipeOptions)

Parámetros

serverName

String

Nombre del equipo remoto al que se va a conectar; o bien, "." para especificar el equipo local.

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.

options

PipeOptions

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

Excepciones

ArgumentNullException

pipeName o serverName es null.

ArgumentException

pipeName o serverName es una cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

o bien

direction no es un valor PipeDirection válido.

o bien

options no es un valor PipeOptions válido.

Comentarios

Este constructor usa los siguientes valores predeterminados:

• Valor predeterminado TokenImpersonationLevel de None.

• Valor predeterminado HandleInheritability de None.

NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)

Source:

NamedPipeClientStream.cs

Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados, y las características dirección de canalización, opciones de canalización y nivel de suplantación de seguridad especificadas.

public:
 NamedPipeClientStream(System::String ^ serverName, System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, System::IO::Pipes::PipeOptions options, System::Security::Principal::TokenImpersonationLevel impersonationLevel);

public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeDirection direction, System.IO.Pipes.PipeOptions options, System.Security.Principal.TokenImpersonationLevel impersonationLevel);

new System.IO.Pipes.NamedPipeClientStream : string * string * System.IO.Pipes.PipeDirection * System.IO.Pipes.PipeOptions * System.Security.Principal.TokenImpersonationLevel -> System.IO.Pipes.NamedPipeClientStream

Public Sub New (serverName As String, pipeName As String, direction As PipeDirection, options As PipeOptions, impersonationLevel As TokenImpersonationLevel)

Parámetros

serverName

String

Nombre del equipo remoto al que se va a conectar; o bien, "." para especificar el equipo local.

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.

options

PipeOptions

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

impersonationLevel

TokenImpersonationLevel

Uno de los valores de enumeración que determina el nivel de suplantación de seguridad.

Excepciones

ArgumentNullException

pipeName o serverName es null.

ArgumentException

pipeName o serverName es una cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

o bien

direction no es un valor PipeDirection válido.

o bien

options no es un valor PipeOptions válido.

o bien

impersonationLevel no es un valor TokenImpersonationLevel válido.

Comentarios

Este constructor usa un valor predeterminado HandleInheritability de None.

NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)

Source:

NamedPipeClientStream.cs

Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados, y las características dirección de canalización, opciones de canalización, nivel de suplantación de seguridad y modo de herencia especificadas.

public:
 NamedPipeClientStream(System::String ^ serverName, System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, System::IO::Pipes::PipeOptions options, System::Security::Principal::TokenImpersonationLevel impersonationLevel, System::IO::HandleInheritability inheritability);

public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeDirection direction, System.IO.Pipes.PipeOptions options, System.Security.Principal.TokenImpersonationLevel impersonationLevel, System.IO.HandleInheritability inheritability);

new System.IO.Pipes.NamedPipeClientStream : string * string * System.IO.Pipes.PipeDirection * System.IO.Pipes.PipeOptions * System.Security.Principal.TokenImpersonationLevel * System.IO.HandleInheritability -> System.IO.Pipes.NamedPipeClientStream

Public Sub New (serverName As String, pipeName As String, direction As PipeDirection, options As PipeOptions, impersonationLevel As TokenImpersonationLevel, inheritability As HandleInheritability)

Parámetros

serverName

String

Nombre del equipo remoto al que se va a conectar; o bien, "." para especificar el equipo local.

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.

options

PipeOptions

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

impersonationLevel

TokenImpersonationLevel

Uno de los valores de enumeración que determina el nivel de suplantación de seguridad.

inheritability

HandleInheritability

Uno de los valores de enumeración que determina si los procesos secundarios van a poder heredar el identificador subyacente.

Excepciones

ArgumentNullException

pipeName o serverName es null.

ArgumentException

pipeName o serverName es una cadena de longitud cero.

ArgumentOutOfRangeException

pipeName se establece en "anónimo".

o bien

direction no es un valor PipeDirection válido.

o bien

options no es un valor PipeOptions válido.

o bien

impersonationLevel no es un valor TokenImpersonationLevel válido.

o bien

inheritability no es un valor HandleInheritability válido.