NamedPipeClientStream Konstruktory

Definice

Obor názvů:

System.IO.Pipes

Sestavení:

netstandard.dll, System.IO.Pipes.dll

Inicializuje novou instanci NamedPipeClientStream třídy.

Přetížení

Name	Description
NamedPipeClientStream(String)	Inicializuje novou instanci NamedPipeClientStream třídy se zadaným názvem kanálu.
NamedPipeClientStream(String, String)	Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru.
NamedPipeClientStream(String, String, PipeDirection)	Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru a zadaným směrem kanálu.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Inicializuje novou instanci NamedPipeClientStream třídy pro zadaný popisovač potrubí se zadaným směrem kanálu.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru a zadaným směrem kanálu a možnostmi kanálu.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru a zadaným směrem kanálu, možnostmi kanálu a úrovní zosobnění zabezpečení.
NamedPipeClientStream(String, String, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru a zadanými možnostmi kanálu, úrovní zosobnění zabezpečení a režimem dědičnosti.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru a zadaným směrem kanálu, možnostmi kanálu, úrovní zosobnění zabezpečení a režimem dědičnosti.

NamedPipeClientStream(String)

Zdroj:

NamedPipeClientStream.cs

Inicializuje novou instanci NamedPipeClientStream třídy se zadaným názvem kanálu.

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)

Parametry

pipeName

String

Název potrubí.

Výjimky

ArgumentNullException

pipeName je null.

ArgumentException

pipeName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavena na anonymní.

Poznámky

Tento konstruktor používá následující výchozí hodnoty:

• Výchozí název serveru ".".

• Výchozí PipeDirection hodnota InOut.

• Výchozí PipeOptions hodnota None.

• Výchozí TokenImpersonationLevel hodnota None.

• Výchozí HandleInheritability hodnota None.

NamedPipeClientStream(String, String)

Zdroj:

NamedPipeClientStream.cs

Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru.

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)

Parametry

serverName

String

Název vzdáleného počítače, ke kterému se chcete připojit, nebo ". zadejte místní počítač.

pipeName

String

Název potrubí.

Výjimky

ArgumentNullException

pipeName nebo serverName je null.

ArgumentException

pipeName nebo serverName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavena na anonymní.

Poznámky

Tento konstruktor používá následující výchozí hodnoty:

• Výchozí PipeDirection hodnota InOut.

• Výchozí PipeOptions hodnota None.

• Výchozí TokenImpersonationLevel hodnota None.

• Výchozí HandleInheritability hodnota None.

NamedPipeClientStream(String, String, PipeDirection)

Zdroj:

NamedPipeClientStream.cs

Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru a zadaným směrem kanálu.

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)

Parametry

serverName

String

Název vzdáleného počítače, ke kterému se chcete připojit, nebo ". zadejte místní počítač.

pipeName

String

Název potrubí.

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

Výjimky

ArgumentNullException

pipeName nebo serverName je null.

ArgumentException

pipeName nebo serverName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavena na anonymní.

-or-

direction není platná PipeDirection hodnota.

Příklady

Následující příklad ukazuje metodu odeslání řetězce z nadřazeného procesu do podřízeného procesu pomocí pojmenovaných kanálů. Tento příklad vytvoří NamedPipeClientStream objekt v podřízeného procesu, který se pak připojí k kanálu v místním počítači. Příklad serveru je vidět ve NamedPipeServerStream třídě. Tento příklad je součástí většího příkladu poskytovaného NamedPipeServerStream pro třídy a NamedPipeClientStream třídy.

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

Poznámky

Tento konstruktor používá následující výchozí hodnoty:

• Výchozí PipeOptions hodnota None.

• Výchozí TokenImpersonationLevel hodnota None.

• Výchozí HandleInheritability hodnota None.

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Zdroj:

NamedPipeClientStream.cs

Inicializuje novou instanci NamedPipeClientStream třídy pro zadaný popisovač potrubí se zadaným směrem kanálu.

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)

Parametry

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

isAsync

Boolean

truek označení, že popisovač byl otevřen asynchronně; v opačném případě . false

isConnected

Boolean

truek označení, že potrubí je připojeno; v opačném případě . false

safePipeHandle

SafePipeHandle

Bezpečný popisovač potrubí, který tento NamedPipeClientStream objekt zapouzdřuje.

Výjimky

IOException

Stream byl uzavřen.

ArgumentException

safePipeHandle není platný popisovač.

ArgumentNullException

safePipeHandle je null.

ArgumentOutOfRangeException

direction není platná PipeDirection hodnota.

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Zdroj:

NamedPipeClientStream.cs

Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru a zadaným směrem kanálu a možnostmi kanálu.

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)

Parametry

serverName

String

Název vzdáleného počítače, ke kterému se chcete připojit, nebo ". zadejte místní počítač.

pipeName

String

Název potrubí.

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

options

PipeOptions

Jedna z hodnot výčtu, která určuje, jak otevřít nebo vytvořit kanál.

Výjimky

ArgumentNullException

pipeName nebo serverName je null.

ArgumentException

pipeName nebo serverName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavena na anonymní.

-or-

direction není platná PipeDirection hodnota.

-or-

options není platná PipeOptions hodnota.

Poznámky

Tento konstruktor používá následující výchozí hodnoty:

• Výchozí TokenImpersonationLevel hodnota None.

• Výchozí HandleInheritability hodnota None.

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

Zdroj:

NamedPipeClientStream.cs

Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru a zadaným směrem kanálu, možnostmi kanálu a úrovní zosobnění zabezpečení.

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)

Parametry

serverName

String

Název vzdáleného počítače, ke kterému se chcete připojit, nebo ". zadejte místní počítač.

pipeName

String

Název potrubí.

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

options

PipeOptions

Jedna z hodnot výčtu, která určuje, jak otevřít nebo vytvořit kanál.

impersonationLevel

TokenImpersonationLevel

Jedna z hodnot výčtu, která určuje úroveň zosobnění zabezpečení.

Výjimky

ArgumentNullException

pipeName nebo serverName je null.

ArgumentException

pipeName nebo serverName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavena na anonymní.

-or-

direction není platná PipeDirection hodnota.

-or-

options není platná PipeOptions hodnota.

-or-

impersonationLevel není platná TokenImpersonationLevel hodnota.

Poznámky

Tento konstruktor používá výchozí HandleInheritability hodnotu None.

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

Zdroj:

NamedPipeClientStream.Unix.cs

Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru a zadanými možnostmi kanálu, úrovní zosobnění zabezpečení a režimem dědičnosti.

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

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

Public Sub New (serverName As String, pipeName As String, desiredAccessRights As PipeAccessRights, options As PipeOptions, impersonationLevel As TokenImpersonationLevel, inheritability As HandleInheritability)

Parametry

serverName

String

Název vzdáleného počítače, ke kterému se chcete připojit, nebo ". zadejte místní počítač.

pipeName

String

Název potrubí.

desiredAccessRights

PipeAccessRights

Jedna z hodnot výčtu, která určuje požadovaná přístupová práva kanálu.

options

PipeOptions

Jedna z hodnot výčtu, která určuje, jak otevřít nebo vytvořit kanál.

impersonationLevel

TokenImpersonationLevel

Jedna z hodnot výčtu, která určuje úroveň zosobnění zabezpečení.

inheritability

HandleInheritability

Jedna z hodnot výčtu, která určuje, zda bude podkladový popisovač zděděn podřízenými procesy.

Atributy

SupportedOSPlatformAttribute

Výjimky

ArgumentNullException

pipeName nebo serverName je null.

ArgumentException

pipeName nebo serverName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavena na anonymní.

-or-

options není platná PipeOptions hodnota.

-or-

impersonationLevel není platná TokenImpersonationLevel hodnota.

-or-

inheritability není platná HandleInheritability hodnota.

Poznámky

Směr potrubí pro tento konstruktor je určen parametrem desiredAccessRights . desiredAccessRights Pokud je ReadDatahodnota , směr potrubí bude In. Pokud je WriteDatahodnota desiredAccessRights , směr potrubí bude Out. Pokud hodnota desiredAccessRights zahrnuje obě ReadData a WriteData, směr potrubí bude InOut.

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

Zdroj:

NamedPipeClientStream.cs

Inicializuje novou instanci NamedPipeClientStream třídy se zadanými názvy kanálu a serveru a zadaným směrem kanálu, možnostmi kanálu, úrovní zosobnění zabezpečení a režimem dědičnosti.

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)

Parametry

serverName

String

Název vzdáleného počítače, ke kterému se chcete připojit, nebo ". zadejte místní počítač.

pipeName

String

Název potrubí.

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

options

PipeOptions

Jedna z hodnot výčtu, která určuje, jak otevřít nebo vytvořit kanál.

impersonationLevel

TokenImpersonationLevel

Jedna z hodnot výčtu, která určuje úroveň zosobnění zabezpečení.

inheritability

HandleInheritability

Jedna z hodnot výčtu, která určuje, zda bude podkladový popisovač zděděn podřízenými procesy.

Výjimky

ArgumentNullException

pipeName nebo serverName je null.

ArgumentException

pipeName nebo serverName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavena na anonymní.

-or-

direction není platná PipeDirection hodnota.

-or-

options není platná PipeOptions hodnota.

-or-

impersonationLevel není platná TokenImpersonationLevel hodnota.

-or-

inheritability není platná HandleInheritability hodnota.