NamedPipeClientStream 建構函式

定義

命名空間:

System.IO.Pipes

組件:

System.IO.Pipes.dll

初始化 NamedPipeClientStream 類別的新執行個體。

多載

NamedPipeClientStream(String)	使用指定的管道名稱，初始化 NamedPipeClientStream 類別的新執行個體。
NamedPipeClientStream(String, String)	使用指定的管道及伺服器名稱，初始化 NamedPipeClientStream 類別的新執行個體。
NamedPipeClientStream(String, String, PipeDirection)	使用指定的管道與伺服器名稱，以及指定的管道方向，初始化 NamedPipeClientStream 類別的新執行個體。
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	使用具有指定管道方向的管道控制碼，初始化 NamedPipeClientStream 類別的新執行個體。
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	使用指定的管道與伺服器名稱，以及指定的管道方向與管道選項，初始化 NamedPipeClientStream 類別的新執行個體。
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	使用指定的管道與伺服器名稱，以及指定的管道方向、管道選項及安全性模擬等級，初始化 NamedPipeClientStream 類別的新執行個體。
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	使用指定的管道與伺服器名稱，以及指定的管道方向、管道選項、安全性模擬等級和繼承模式，初始化 NamedPipeClientStream 類別的新執行個體。

NamedPipeClientStream(String)

來源:

NamedPipeClientStream.cs

使用指定的管道名稱，初始化 NamedPipeClientStream 類別的新執行個體。

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)

參數

pipeName

String

管道的名稱。

例外狀況

ArgumentNullException

pipeName 為 null。

ArgumentException

pipeName 是零長度字串

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

備註

此建構函式會使用下列預設值：

• 預設伺服器名稱 “.”。

• 的預設值PipeDirectionInOut。

• 的預設值PipeOptionsNone。

• 的預設值TokenImpersonationLevelNone。

• 的預設值HandleInheritabilityNone。

NamedPipeClientStream(String, String)

來源:

NamedPipeClientStream.cs

使用指定的管道及伺服器名稱，初始化 NamedPipeClientStream 類別的新執行個體。

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)

參數

serverName

String

要連接的遠端電腦名稱，或 "." 表示要指定本機電腦。

pipeName

String

管道的名稱。

例外狀況

ArgumentNullException

pipeName 或 serverName 為 null。

ArgumentException

pipeName 或 serverName 是長度為零的字串。

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

備註

此建構函式會使用下列預設值：

• 的預設值PipeDirectionInOut。

• 的預設值PipeOptionsNone。

• 的預設值TokenImpersonationLevelNone。

• 的預設值HandleInheritabilityNone。

NamedPipeClientStream(String, String, PipeDirection)

來源:

NamedPipeClientStream.cs

使用指定的管道與伺服器名稱，以及指定的管道方向，初始化 NamedPipeClientStream 類別的新執行個體。

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)

參數

serverName

String

要連接的遠端電腦名稱，或 "." 表示要指定本機電腦。

pipeName

String

管道的名稱。

direction

PipeDirection

其中一個列舉值，決定管道的方向。

例外狀況

ArgumentNullException

pipeName 或 serverName 為 null。

ArgumentException

pipeName 或 serverName 是長度為零的字串。

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

範例

下列範例示範使用命名管道將字串從父進程傳送至子進程的方法。 這個範例會在 NamedPipeClientStream 子進程中建立 對象，然後連接到本機電腦上的管道。 您可以在 類別中看到 NamedPipeServerStream 伺服器範例。 這個範例是 針對和 NamedPipeClientStream 類別提供之較大範例的NamedPipeServerStream一部分。

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

備註

此建構函式會使用下列預設值：

• 的預設值PipeOptionsNone。

• 的預設值TokenImpersonationLevelNone。

• 的預設值HandleInheritabilityNone。

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

來源:

NamedPipeClientStream.cs

使用具有指定管道方向的管道控制碼，初始化 NamedPipeClientStream 類別的新執行個體。

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)

參數

direction

PipeDirection

其中一個列舉值，決定管道的方向。

isAsync

Boolean

true 表示控制代碼為非同步開啟；否則為 false。

isConnected

Boolean

true 表示管道已連接，否則就是 false。

safePipeHandle

SafePipeHandle

安全控制代碼，用於這個 NamedPipeClientStream 物件將會封裝的管道。

例外狀況

IOException

資料流已關閉。

ArgumentException

safePipeHandle 不是有效的控制代碼。

ArgumentNullException

safePipeHandle 為 null。

ArgumentOutOfRangeException

direction 不是有效的 PipeDirection 值。

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

來源:

NamedPipeClientStream.cs

使用指定的管道與伺服器名稱，以及指定的管道方向與管道選項，初始化 NamedPipeClientStream 類別的新執行個體。

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)

參數

serverName

String

要連接的遠端電腦名稱，或 "." 表示要指定本機電腦。

pipeName

String

管道的名稱。

direction

PipeDirection

其中一個列舉值，決定管道的方向。

options

PipeOptions

其中一個列舉值，決定如何開啟或建立管道。

例外狀況

ArgumentNullException

pipeName 或 serverName 為 null。

ArgumentException

pipeName 或 serverName 是長度為零的字串。

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

-或-

options 不是有效的 PipeOptions 值。

備註

此建構函式會使用下列預設值：

• 的預設值TokenImpersonationLevelNone。

• 的預設值HandleInheritabilityNone。

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

來源:

NamedPipeClientStream.cs

使用指定的管道與伺服器名稱，以及指定的管道方向、管道選項及安全性模擬等級，初始化 NamedPipeClientStream 類別的新執行個體。

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)

參數

serverName

String

要連接的遠端電腦名稱，或 "." 表示要指定本機電腦。

pipeName

String

管道的名稱。

direction

PipeDirection

其中一個列舉值，決定管道的方向。

options

PipeOptions

其中一個列舉值，決定如何開啟或建立管道。

impersonationLevel

TokenImpersonationLevel

其中一個列舉值，決定安全性模擬等級。

例外狀況

ArgumentNullException

pipeName 或 serverName 為 null。

ArgumentException

pipeName 或 serverName 是長度為零的字串。

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

-或-

options 不是有效的 PipeOptions 值。

-或-

impersonationLevel 不是有效的 TokenImpersonationLevel 值。

備註

這個建構函式會使用的None預設值HandleInheritability。

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

來源:

NamedPipeClientStream.cs

使用指定的管道與伺服器名稱，以及指定的管道方向、管道選項、安全性模擬等級和繼承模式，初始化 NamedPipeClientStream 類別的新執行個體。

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)

參數

serverName

String

要連接的遠端電腦名稱，或 "." 表示要指定本機電腦。

pipeName

String

管道的名稱。

direction

PipeDirection

其中一個列舉值，決定管道的方向。

options

PipeOptions

其中一個列舉值，決定如何開啟或建立管道。

impersonationLevel

TokenImpersonationLevel

其中一個列舉值，決定安全性模擬等級。

inheritability

HandleInheritability

一個列舉值，決定基礎碼控制碼是否將由子處理序繼承。

例外狀況

ArgumentNullException

pipeName 或 serverName 為 null。

ArgumentException

pipeName 或 serverName 是長度為零的字串。

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

-或-

options 不是有效的 PipeOptions 值。

-或-

impersonationLevel 不是有效的 TokenImpersonationLevel 值。

-或-

inheritability 不是有效的 HandleInheritability 值。