Partilhar via


NamedPipeClientStream Construtores

Definição

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, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)

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

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

pipeName é null.

pipeName é uma cadeia de comprimento zero.

pipeName é definido como "anonymous".

Comentários

Esse construtor usa os seguintes valores padrão:

Aplica-se a

NamedPipeClientStream(String, String)

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

pipeName ou serverName é null.

pipeName ou serverName é uma cadeia de comprimento zero.

pipeName é definido como "anonymous".

Comentários

Esse construtor usa os seguintes valores padrão:

Aplica-se a

NamedPipeClientStream(String, String, PipeDirection)

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

pipeName ou serverName é null.

pipeName ou serverName é uma cadeia de comprimento zero.

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:

Aplica-se a

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

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

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

Atributos

Exceções

O fluxo foi fechado.

safePipeHandle não é um identificador válido.

safePipeHandle é null.

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

Aplica-se a

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

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

pipeName ou serverName é null.

pipeName ou serverName é uma cadeia de comprimento zero.

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:

Aplica-se a

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

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

pipeName ou serverName é null.

pipeName ou serverName é uma cadeia de comprimento zero.

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.

Aplica-se a

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

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

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

pipeName
String

O nome do pipe.

desiredAccessRights
PipeAccessRights

Um dos valores de enumeração que especifica os direitos de acesso desejados 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.

Atributos

Exceções

pipeName ou serverName é null.

pipeName ou serverName é uma cadeia de comprimento zero.

pipeName é definido como "anonymous".

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

Comentários

A direção do pipe para esse construtor é determinada pelo desiredAccessRights parâmetro . Se o desiredAccessRights valor for ReadData, a direção do pipe será In. Se o valor de desiredAccessRights for WriteData, a direção do pipe será Out. Se o valor de desiredAccessRights incluir e ReadDataWriteData, a direção do pipe será InOut.

Aplica-se a

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

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

pipeName ou serverName é null.

pipeName ou serverName é uma cadeia de comprimento zero.

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.

Aplica-se a