NamedPipeClientStream Constructores

Definición

Espacio de nombres:

System.IO.Pipes

Ensamblados:

netstandard.dll, System.IO.Pipes.dll

Inicializa una nueva instancia de la clase NamedPipeClientStream.

Sobrecargas

Nombre	Description
NamedPipeClientStream(String)	Inicializa una nueva instancia de la NamedPipeClientStream clase con el nombre de canalización especificado.
NamedPipeClientStream(String, String)	Inicializa una nueva instancia de la NamedPipeClientStream clase con los nombres de canalización y servidor especificados.
NamedPipeClientStream(String, String, PipeDirection)	Inicializa una nueva instancia de la NamedPipeClientStream clase 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 NamedPipeClientStream clase 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 NamedPipeClientStream clase con los nombres de canalización y servidor especificados, y las opciones de dirección y canalización especificadas.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Inicializa una nueva instancia de la NamedPipeClientStream clase con los nombres de canalización y servidor especificados y la dirección de canalización, las opciones de canalización y el nivel de suplantación de seguridad especificados.
NamedPipeClientStream(String, String, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inicializa una nueva instancia de la NamedPipeClientStream clase con los nombres de canalización y servidor especificados, así como las opciones de canalización, el nivel de suplantación de seguridad y el modo de heredar especificados.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inicializa una nueva instancia de la NamedPipeClientStream clase con los nombres de canalización y servidor especificados, y la dirección de canalización, las opciones de canalización, el nivel de suplantación de seguridad y el modo de heredar especificados.

NamedPipeClientStream(String)

Source:

NamedPipeClientStream.cs

Inicializa una nueva instancia de la NamedPipeClientStream clase 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 una 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 NamedPipeClientStream clase 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 "." 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 NamedPipeClientStream clase 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 "." 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 válido PipeDirection .

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 NamedPipeClientStream clase 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

true para indicar que el identificador se abrió de forma asincrónica; de lo contrario, false.

isConnected

Boolean

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

safePipeHandle

SafePipeHandle

Identificador seguro para la canalización que este NamedPipeClientStream objeto encapsulará.

Excepciones

IOException

Se ha cerrado la secuencia.

ArgumentException

safePipeHandle no es un identificador válido.

ArgumentNullException

safePipeHandle es null.

ArgumentOutOfRangeException

direction no es un valor válido PipeDirection .

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Source:

NamedPipeClientStream.cs

Inicializa una nueva instancia de la NamedPipeClientStream clase con los nombres de canalización y servidor especificados, y las opciones de dirección y 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 "." 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 válido PipeDirection .

O bien:

options no es un valor válido PipeOptions .

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 NamedPipeClientStream clase con los nombres de canalización y servidor especificados y la dirección de canalización, las opciones de canalización y el nivel de suplantación de seguridad especificados.

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 "." 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 válido PipeDirection .

O bien:

options no es un valor válido PipeOptions .

O bien:

impersonationLevel no es un valor válido TokenImpersonationLevel .

Comentarios

Este constructor usa un valor predeterminado HandleInheritability de None.

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

Source:

NamedPipeClientStream.Unix.cs

Inicializa una nueva instancia de la NamedPipeClientStream clase con los nombres de canalización y servidor especificados, así como las opciones de canalización, el nivel de suplantación de seguridad y el modo de heredar especificados.

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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 "." 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 heredan el identificador subyacente.

Atributos

SupportedOSPlatformAttribute

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 válido PipeOptions .

O bien:

impersonationLevel no es un valor válido TokenImpersonationLevel .

O bien:

inheritability no es un valor válido HandleInheritability .

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 es WriteData, la dirección de desiredAccessRights la canalización será Out. Si el valor de desiredAccessRights incluye y ReadDataWriteData, la dirección de la canalización será InOut.

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

Source:

NamedPipeClientStream.cs

Inicializa una nueva instancia de la NamedPipeClientStream clase con los nombres de canalización y servidor especificados, y la dirección de canalización, las opciones de canalización, el nivel de suplantación de seguridad y el modo de heredar especificados.

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 "." 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 heredan 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 válido PipeDirection .

O bien:

options no es un valor válido PipeOptions .

O bien:

impersonationLevel no es un valor válido TokenImpersonationLevel .

O bien:

inheritability no es un valor válido HandleInheritability .