Compartir a través de


NamedPipeClientStream Constructores

Definición

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)

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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

pipeName es null.

pipeName es cadena de longitud cero.

pipeName se establece en "anónimo".

Comentarios

Este constructor usa los siguientes valores predeterminados:

Se aplica a

NamedPipeClientStream(String, String)

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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

pipeName o serverName es null.

pipeName o serverName es una cadena de longitud cero.

pipeName se establece en "anónimo".

Comentarios

Este constructor usa los siguientes valores predeterminados:

Se aplica a

NamedPipeClientStream(String, String, PipeDirection)

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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

pipeName o serverName es null.

pipeName o serverName es una cadena de longitud cero.

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:

Se aplica a

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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);
[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

Excepciones

Se ha cerrado la secuencia.

safePipeHandle no es un controlador válido.

safePipeHandle es null.

direction no es un valor PipeDirection válido.

Se aplica a

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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

pipeName o serverName es null.

pipeName o serverName es una cadena de longitud cero.

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:

Se aplica a

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

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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

pipeName o serverName es null.

pipeName o serverName es una cadena de longitud cero.

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

Atributos

Excepciones

pipeName o serverName es null.

pipeName o serverName es una cadena de longitud cero.

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 ReadDataWriteData, la dirección de la canalización será InOut.

Se aplica a

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

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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

pipeName o serverName es null.

pipeName o serverName es una cadena de longitud cero.

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