共用方式為


NamedPipeClientStream 建構函式

定義

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

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

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

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

NamedPipeClientStream(String)

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

管道的名稱。

例外狀況

pipeNamenull

pipeName 是零長度字串

pipeName 設定為「匿名」。

備註

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

適用於

NamedPipeClientStream(String, String)

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

管道的名稱。

例外狀況

pipeNameserverNamenull

pipeNameserverName 是長度為零的字串。

pipeName 設定為「匿名」。

備註

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

適用於

NamedPipeClientStream(String, String, PipeDirection)

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

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

例外狀況

pipeNameserverNamenull

pipeNameserverName 是長度為零的字串。

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

備註

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

適用於

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

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

參數

direction
PipeDirection

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

isAsync
Boolean

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

isConnected
Boolean

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

safePipeHandle
SafePipeHandle

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

屬性

例外狀況

資料流已關閉。

safePipeHandle 不是有效的控制代碼。

safePipeHandlenull

direction 不是有效的 PipeDirection 值。

適用於

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

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

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

例外狀況

pipeNameserverNamenull

pipeNameserverName 是長度為零的字串。

pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

-或-

options 不是有效的 PipeOptions 值。

備註

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

適用於

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

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

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

例外狀況

pipeNameserverNamenull

pipeNameserverName 是長度為零的字串。

pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

-或-

options 不是有效的 PipeOptions 值。

-或-

impersonationLevel 不是有效的 TokenImpersonationLevel 值。

備註

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

適用於

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

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

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)

參數

serverName
String

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

pipeName
String

管道的名稱。

desiredAccessRights
PipeAccessRights

一個列舉值,指定所需的管道存取權限。

options
PipeOptions

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

impersonationLevel
TokenImpersonationLevel

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

inheritability
HandleInheritability

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

屬性

例外狀況

pipeNameserverNamenull

pipeNameserverName 是長度為零的字串。

pipeName 設定為「匿名」。

-或-

options 不是有效的 PipeOptions 值。

-或-

impersonationLevel 不是有效的 TokenImpersonationLevel 值。

-或-

inheritability 不是有效的 HandleInheritability 值。

備註

這個建構函式的管道方向是由 參數決定 desiredAccessRightsdesiredAccessRights如果值為 ReadData,則管道方向會是 In。 如果的值desiredAccessRightsWriteData,則管道方向會是 Out。如果的值desiredAccessRights同時包含和 WriteData,則管道方向會是 InOutReadData

適用於

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

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

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

例外狀況

pipeNameserverNamenull

pipeNameserverName 是長度為零的字串。

pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

-或-

options 不是有效的 PipeOptions 值。

-或-

impersonationLevel 不是有效的 TokenImpersonationLevel 值。

-或-

inheritability 不是有效的 HandleInheritability 值。

適用於