NamedPipeClientStream Construtores

Definição

Namespace:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Inicializa uma nova instância da classe NamedPipeClientStream.

Sobrecargas

NamedPipeClientStream(String)	Inicializa uma nova instância da classe NamedPipeClientStream com o nome do pipe especificado.
NamedPipeClientStream(String, String)	Inicializa uma nova instância da classe NamedPipeClientStream com os nomes de pipe e servidor especificados.
NamedPipeClientStream(String, String, PipeDirection)	Inicializa uma nova instância da classe NamedPipeClientStream com os nomes de pipe e servidor especificados e a direção de pipe especificada.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Inicializa uma nova instância da classe NamedPipeClientStream para o identificador de pipe especificado com a direção de pipe especificada.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Inicializa uma nova instância da classe NamedPipeClientStream com os nomes de pipe e servidor especificados, além das opções de pipe e direção de pipe especificadas.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Inicializa uma nova instância da classe NamedPipeClientStream com os nomes de pipe e servidor especificados, a direção de pipe especificada, as opções de pipe e o nível de representação de segurança.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inicializa uma nova instância da classe NamedPipeClientStream com os nomes de pipe e de servidor especificados e a direção do pipe, as opções de pipe, o nível de representação de segurança e o modo de capacidade de herança especificados.

NamedPipeClientStream(String)

Origem:

NamedPipeClientStream.cs

Inicializa uma nova instância da classe NamedPipeClientStream com o nome do pipe 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

O nome do pipe.

Exceções

ArgumentNullException

pipeName é null.

ArgumentException

pipeName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

Comentários

Esse construtor usa os seguintes valores padrão:

• Um nome de servidor padrão de ".".

• Um valor padrão PipeDirection de InOut.

• Um valor padrão PipeOptions de None.

• Um valor padrão TokenImpersonationLevel de None.

• Um valor padrão HandleInheritability de None.

NamedPipeClientStream(String, String)

Origem:

NamedPipeClientStream.cs

Inicializa uma nova instância da classe NamedPipeClientStream com os nomes de pipe e 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

O nome do computador remoto ao qual se conectar ou “.” para especificar o computador local.

pipeName

String

O nome do pipe.

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

Comentários

Esse construtor usa os seguintes valores padrão:

• Um valor padrão PipeDirection de InOut.

• Um valor padrão PipeOptions de None.

• Um valor padrão TokenImpersonationLevel de None.

• Um valor padrão HandleInheritability de None.

NamedPipeClientStream(String, String, PipeDirection)

Origem:

NamedPipeClientStream.cs

Inicializa uma nova instância da classe NamedPipeClientStream com os nomes de pipe e servidor especificados e a direção de pipe 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

O nome do computador remoto ao qual se conectar ou “.” para especificar o computador local.

pipeName

String

O nome do pipe.

direction

PipeDirection

Um dos valores de enumeração que determinam a direção do pipe.

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

- ou -

direction não é um valor PipeDirection válido.

Exemplos

O exemplo a seguir demonstra um método para enviar uma cadeia de caracteres de um processo pai para um processo filho usando pipes nomeados. Este exemplo cria um NamedPipeClientStream objeto em um processo filho, que se conecta a um pipe no computador local. O exemplo de servidor pode ser visto na NamedPipeServerStream classe . Este exemplo faz parte de um exemplo maior fornecido para as NamedPipeServerStream classes e 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

Comentários

Esse construtor usa os seguintes valores padrão:

• Um valor padrão PipeOptions de None.

• Um valor padrão TokenImpersonationLevel de None.

• Um valor padrão HandleInheritability de None.

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Origem:

NamedPipeClientStream.cs

Inicializa uma nova instância da classe NamedPipeClientStream para o identificador de pipe especificado com a direção de pipe 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

Um dos valores de enumeração que determina a direção do pipe.

isAsync

Boolean

true para indicar que o identificador foi aberto assincronamente, caso contrário, false.

isConnected

Boolean

true para indicar que o pipe está conectado, caso contrário, false.

safePipeHandle

SafePipeHandle

Um identificador seguro para o arquivo que este objeto NamedPipeClientStream encapsulará.

Exceções

IOException

O fluxo foi fechado.

ArgumentException

safePipeHandle não é um identificador válido.

ArgumentNullException

safePipeHandle é null.

ArgumentOutOfRangeException

direction não é um valor PipeDirection válido.

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Origem:

NamedPipeClientStream.cs

Inicializa uma nova instância da classe NamedPipeClientStream com os nomes de pipe e servidor especificados, além das opções de pipe e direção de pipe 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

O nome do computador remoto ao qual se conectar ou “.” para especificar o computador local.

pipeName

String

O nome do pipe.

direction

PipeDirection

Um dos valores de enumeração que determina a direção do pipe.

options

PipeOptions

Um dos valores de enumeração que determina como abrir ou criar o pipe.

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

- ou -

direction não é um valor PipeDirection válido.

- ou -

options não é um valor PipeOptions válido.

Comentários

Esse construtor usa os seguintes valores padrão:

• Um valor padrão TokenImpersonationLevel de None.

• Um valor padrão HandleInheritability de None.

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

Origem:

NamedPipeClientStream.cs

Inicializa uma nova instância da classe NamedPipeClientStream com os nomes de pipe e servidor especificados, a direção de pipe especificada, as opções de pipe e o nível de representação de segurança.

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

O nome do computador remoto ao qual se conectar ou “.” para especificar o computador local.

pipeName

String

O nome do pipe.

direction

PipeDirection

Um dos valores de enumeração que determina a direção do pipe.

options

PipeOptions

Um dos valores de enumeração que determina como abrir ou criar o pipe.

impersonationLevel

TokenImpersonationLevel

Um dos valores de enumeração que determina o nível de representação de segurança.

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

- ou -

direction não é um valor PipeDirection válido.

- ou -

options não é um valor PipeOptions válido.

- ou -

impersonationLevel não é um valor TokenImpersonationLevel válido.

Comentários

Esse construtor usa um valor padrão HandleInheritability de None.

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

Origem:

NamedPipeClientStream.cs

Inicializa uma nova instância da classe NamedPipeClientStream com os nomes de pipe e de servidor especificados e a direção do pipe, as opções de pipe, o nível de representação de segurança e o modo de capacidade de herança 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

O nome do computador remoto ao qual se conectar ou “.” para especificar o computador local.

pipeName

String

O nome do pipe.

direction

PipeDirection

Um dos valores de enumeração que determina a direção do pipe.

options

PipeOptions

Um dos valores de enumeração que determina como abrir ou criar o pipe.

impersonationLevel

TokenImpersonationLevel

Um dos valores de enumeração que determina o nível de representação de segurança.

inheritability

HandleInheritability

Um dos valores de enumeração que determina se o identificador subjacente será herdado por processos filhos.

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

- ou -

direction não é um valor PipeDirection válido.

- ou -

options não é um valor PipeOptions válido.

- ou -

impersonationLevel não é um valor TokenImpersonationLevel válido.

- ou -

inheritability não é um valor HandleInheritability válido.