NamedPipeClientStream Construtores

Definição

Espaço de Nomes:: System.IO.Pipes

Assemblagens:: netstandard.dll, System.IO.Pipes.dll

Assemblagem:: System.IO.Pipes.dll

Assemblagem:: System.Core.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da NamedPipeClientStream classe.

Sobrecargas

Name	Descrição
NamedPipeClientStream(String)	Inicializa uma nova instância da NamedPipeClientStream classe com o nome do pipe especificado.
NamedPipeClientStream(String, String)	Inicializa uma nova instância da NamedPipeClientStream classe com os nomes de pipe e servidores especificados.
NamedPipeClientStream(PipeDirection, Boolean, SafePipeHandle)
NamedPipeClientStream(String, String, PipeDirection)	Inicializa uma nova instância da NamedPipeClientStream classe com os nomes do pipe e servidor especificados, e a direção do pipe especificada.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Obsoleto. Inicializa uma nova instância da NamedPipeClientStream classe para o handle de pipe especificado com a direção do pipe especificada.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Inicializa uma nova instância da NamedPipeClientStream classe com os nomes de pipe e servidores especificados, e a direção e opções de pipe especificadas.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Inicializa uma nova instância da NamedPipeClientStream classe com os nomes de pipe e servidores especificados, e a direção do pipe especificada, opções de pipe e nível de imitação de segurança.
NamedPipeClientStream(String, String, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inicializa uma nova instância da NamedPipeClientStream classe com os nomes do pipe e servidor especificados, e as opções de pipe especificadas, nível de personificação de segurança e modo de herdabilidade.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inicializa uma nova instância da NamedPipeClientStream classe com os nomes do pipe e servidor especificados, e a direção do pipe especificada, opções de pipe, nível de personificação de segurança e modo de herdabilidade.

NamedPipeClientStream(String)

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Inicializa uma nova instância da NamedPipeClientStream classe 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 cachimbo.

Exceções

ArgumentNullException

pipeName é null.

ArgumentException

pipeName é uma corda de comprimento zero.

ArgumentOutOfRangeException

pipeName está definido como "anónimo".

Observações

Este construtor utiliza os seguintes valores por defeito:

Um nome padrão de servidor ".".
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)

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Inicializa uma nova instância da NamedPipeClientStream classe com os nomes de pipe e servidores 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 a que se pode ligar, ou "." para especificar o computador local.

pipeName: String

O nome do cachimbo.

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma corda de comprimento zero.

ArgumentOutOfRangeException

pipeName está definido como "anónimo".

Observações

Este construtor utiliza os seguintes valores por defeito:

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(PipeDirection, Boolean, SafePipeHandle)

Origem:: NamedPipeClientStream.cs

public:
 NamedPipeClientStream(System::IO::Pipes::PipeDirection direction, bool isAsync, Microsoft::Win32::SafeHandles::SafePipeHandle ^ safePipeHandle);

public NamedPipeClientStream(System.IO.Pipes.PipeDirection direction, bool isAsync, Microsoft.Win32.SafeHandles.SafePipeHandle safePipeHandle);

new System.IO.Pipes.NamedPipeClientStream : System.IO.Pipes.PipeDirection * bool * Microsoft.Win32.SafeHandles.SafePipeHandle -> System.IO.Pipes.NamedPipeClientStream

Public Sub New (direction As PipeDirection, isAsync As Boolean, safePipeHandle As SafePipeHandle)

Parâmetros

direction: PipeDirection

isAsync: Boolean

safePipeHandle: SafePipeHandle

Aplica-se a

NamedPipeClientStream(String, String, PipeDirection)

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Inicializa uma nova instância da NamedPipeClientStream classe com os nomes do pipe e servidor especificados, e a direção do 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 a que se pode ligar, ou "." para especificar o computador local.

pipeName: String

O nome do cachimbo.

direction: PipeDirection

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

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma corda de comprimento zero.

ArgumentOutOfRangeException

pipeName está definido como "anónimo".

-ou-

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

Exemplos

O exemplo seguinte demonstra um método para enviar uma string de um processo pai para um processo filho usando pipes nomeados. Este exemplo cria um NamedPipeClientStream objeto num processo filho, que depois se liga a um pipeline no computador local. O exemplo do servidor pode ser visto na NamedPipeServerStream aula. Este exemplo faz parte de um exemplo mais amplo 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

Observações

Este construtor utiliza os seguintes valores por defeito:

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)

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Atenção

This constructor has been deprecated and argument bool isConnected does not have any effect. Use NamedPipeClientStream(PipeDirection direction, bool isAsync, SafePipeHandle safePipeHandle) instead.

Inicializa uma nova instância da NamedPipeClientStream classe para o handle de pipe especificado com a direção do 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.Obsolete("This constructor has been deprecated and argument bool isConnected does not have any effect. Use NamedPipeClientStream(PipeDirection direction, bool isAsync, SafePipeHandle safePipeHandle) instead.", DiagnosticId="SYSLIB0063", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
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.Obsolete("This constructor has been deprecated and argument bool isConnected does not have any effect. Use NamedPipeClientStream(PipeDirection direction, bool isAsync, SafePipeHandle safePipeHandle) instead.", DiagnosticId="SYSLIB0063", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
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 cano.

isAsync: Boolean

true para indicar que a manivela foi aberta assíncrona; caso contrário, false.

isConnected: Boolean

true para indicar que o tubo está ligado; caso contrário, false.

safePipeHandle: SafePipeHandle

Uma pega segura para o tubo que este NamedPipeClientStream objeto irá encapsular.

Atributos: ObsoleteAttribute SecurityCriticalAttribute

Exceções

IOException

O riacho foi encerrado.

ArgumentException

safePipeHandle não é um nome válido.

ArgumentNullException

safePipeHandle é null.

ArgumentOutOfRangeException

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

Aplica-se a

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Inicializa uma nova instância da NamedPipeClientStream classe com os nomes de pipe e servidores especificados, e a direção e opções 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 a que se pode ligar, ou "." para especificar o computador local.

pipeName: String

O nome do cachimbo.

direction: PipeDirection

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

options: PipeOptions

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

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma corda de comprimento zero.

ArgumentOutOfRangeException

pipeName está definido como "anónimo".

-ou-

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

-ou-

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

Observações

Este construtor utiliza os seguintes valores por defeito:

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

Aplica-se a

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

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Inicializa uma nova instância da NamedPipeClientStream classe com os nomes de pipe e servidores especificados, e a direção do pipe especificada, opções de pipe e nível de imitaçã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 a que se pode ligar, ou "." para especificar o computador local.

pipeName: String

O nome do cachimbo.

direction: PipeDirection

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

options: PipeOptions

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

impersonationLevel: TokenImpersonationLevel

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

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma corda de comprimento zero.

ArgumentOutOfRangeException

pipeName está definido como "anónimo".

-ou-

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

-ou-

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

-ou-

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

Observações

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

Aplica-se a

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

Origem:: NamedPipeClientStream.Unix.cs

Origem:: NamedPipeClientStream.Unix.cs

Origem:: NamedPipeClientStream.Unix.cs

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

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 a que se pode ligar, ou "." para especificar o computador local.

pipeName: String

O nome do cachimbo.

desiredAccessRights: PipeAccessRights

Um dos valores de enumeração que especifica os direitos de acesso desejados do canal.

options: PipeOptions

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

impersonationLevel: TokenImpersonationLevel

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

inheritability: HandleInheritability

Um dos valores de enumeração que determina se o handle subjacente será herdável por processos filhos.

Atributos: SupportedOSPlatformAttribute

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma corda de comprimento zero.

ArgumentOutOfRangeException

pipeName está definido como "anónimo".

-ou-

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

-ou-

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

-ou-

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

Observações

A direção do tubo para este construtor é determinada pelo desiredAccessRights parâmetro. Se o desiredAccessRights valor for ReadData, a direção do tubo será In. Se o valor de desiredAccessRights for WriteData, a direção do tubo será Out. Se o valor de desiredAccessRights incluir tanto ReadData como WriteData, a direção do tubo será InOut.

Aplica-se a

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

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

Origem:: NamedPipeClientStream.cs

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

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 a que se pode ligar, ou "." para especificar o computador local.

pipeName: String

O nome do cachimbo.

direction: PipeDirection

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

options: PipeOptions

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

impersonationLevel: TokenImpersonationLevel

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

inheritability: HandleInheritability

Um dos valores de enumeração que determina se o handle subjacente será herdável por processos filhos.

Exceções

ArgumentNullException

pipeName ou serverName é null.

ArgumentException

pipeName ou serverName é uma corda de comprimento zero.

ArgumentOutOfRangeException

pipeName está definido como "anónimo".

-ou-

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

-ou-

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

-ou-

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

-ou-

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

Aplica-se a

Comentários

Esta página foi útil?