NamedPipeClientStream Constructores

Referencia

Definición

Espacio de nombres:: System.IO.Pipes

Ensamblado:: System.IO.Pipes.dll

Ensamblado:: System.Core.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados, y las características opciones de canalización, nivel de suplantación de seguridad y modo de herencia 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)

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.

Se aplica a

NamedPipeClientStream(String, String)

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.

Se aplica a

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.

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.

Se aplica a

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.

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);

[System.Security.SecurityCritical]
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

[<System.Security.SecurityCritical>]
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á.

Atributos: SecurityCriticalAttribute

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.

Se aplica a

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.

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.

Se aplica a

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.

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.

Se aplica a

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

Inicializa una nueva instancia de la clase NamedPipeClientStream con los nombres de canalización y servidor especificados, y las características 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::PipeAccessRights desiredAccessRights, System::IO::Pipes::PipeOptions options, System::Security::Principal::TokenImpersonationLevel impersonationLevel, System::IO::HandleInheritability inheritability);

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

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

Public Sub New (serverName As String, pipeName As String, desiredAccessRights As PipeAccessRights, 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.

desiredAccessRights: PipeAccessRights

Uno de los valores de enumeración que especifica los derechos de acceso deseados 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 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.

Comentarios

La dirección de canalización de este constructor viene determinada por el desiredAccessRights parámetro . Si el desiredAccessRights valor es ReadData, la dirección de la canalización será In. Si el valor de desiredAccessRights es WriteData, la dirección de la canalización será Out. Si el valor de desiredAccessRights incluye y ReadData WriteData, la dirección de la canalización será InOut.

Se aplica a

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.

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.

Se aplica a

NamedPipeClientStream Constructores

Definición

Sobrecargas

NamedPipeClientStream(String)

Parámetros

Excepciones

Comentarios

Se aplica a

NamedPipeClientStream(String, String)

Parámetros

Excepciones

Comentarios

Se aplica a

NamedPipeClientStream(String, String, PipeDirection)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Parámetros

Excepciones

Se aplica a

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Parámetros

Excepciones

Comentarios

Se aplica a

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

Parámetros

Excepciones

Comentarios

Se aplica a

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

Parámetros

Excepciones

Comentarios

Se aplica a

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

Parámetros

Excepciones

Se aplica a

Recursos adicionales