NamedPipeClientStream Construtores

Referência

Definição

Namespace:: System.IO.Pipes

Assembly:: System.IO.Pipes.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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)

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

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

Aplica-se a

NamedPipeClientStream(String, String)

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

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

Aplica-se a

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.

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 determina 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 classes e NamedPipeClientStream as NamedPipeServerStream classes.

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

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

Aplica-se a

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.

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: SecurityCriticalAttribute

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.

Aplica-se a

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.

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

Este construtor usa os seguintes valores padrão:

Um valor padrão TokenImpersonationLevel de None.
Um valor padrão HandleInheritability de None.

Aplica-se a

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.

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.

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

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

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.

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

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 for desiredAccessRights WriteData, a direção do pipe será Out. Se o valor de desiredAccessRights incluir ambos ReadData e WriteData, a direção do pipe será InOut.

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

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.

Aplica-se a

NamedPipeClientStream Construtores

Definição

Sobrecargas

NamedPipeClientStream(String)

Parâmetros

Exceções

Comentários

Aplica-se a

NamedPipeClientStream(String, String)

Parâmetros

Exceções

Comentários

Aplica-se a

NamedPipeClientStream(String, String, PipeDirection)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Parâmetros

Exceções

Aplica-se a

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Parâmetros

Exceções

Comentários

Aplica-se a

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

Parâmetros

Exceções

Comentários

Aplica-se a

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

Parâmetros

Exceções

Comentários

Aplica-se a

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

Parâmetros

Exceções

Aplica-se a

Recursos adicionais