NamedPipeServerStream 建構函式

定義

命名空間:

System.IO.Pipes

組件:

System.IO.Pipes.dll

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

多載

NamedPipeServerStream(String)	使用指定的管道名稱，初始化 NamedPipeServerStream 類別的新執行個體。
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)	使用指定的管道名稱、管道方向、伺服器執行個體數目上限、傳輸模式、管道選項，以及建議的輸入與輸出緩衝區大小，初始化 NamedPipeServerStream 類別的新執行個體。
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)	使用指定的管道名稱、管道方向、伺服器執行個體數目上限、傳輸模式，以及管道選項，初始化 NamedPipeServerStream 類別的新執行個體。
NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	從指定的管道控制碼初始化 NamedPipeServerStream 類別的新執行個體。
NamedPipeServerStream(String, PipeDirection, Int32)	使用指定的管道名稱、管道方向和伺服器執行個體數目上限，初始化 NamedPipeServerStream 類別的新執行個體。
NamedPipeServerStream(String, PipeDirection)	使用指定的管道名稱與管道方向，初始化 NamedPipeServerStream 類別的新執行個體。
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)	使用指定的管道名稱、管道方向、伺服器執行個體數目上限以及傳輸模式，初始化 NamedPipeServerStream 類別的新執行個體。

NamedPipeServerStream(String)

來源:

NamedPipeServerStream.cs

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

public:
 NamedPipeServerStream(System::String ^ pipeName);

public NamedPipeServerStream (string pipeName);

new System.IO.Pipes.NamedPipeServerStream : string -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String)

參數

pipeName

String

管道的名稱。

例外狀況

ArgumentNullException

pipeName 為 null。

ArgumentException

pipeName 是零長度字串

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

NotSupportedException

pipeName 包含冒號 (":")。

IOException

已經超過伺服器執行個體的最大數目。

備註

此建構函式會 NamedPipeServerStream 建立具有下列特性的物件：

• 的預設管道方向 InOut。

• 共用相同名稱的伺服器實例數目上限設定為 1。

• PipeTransmissionMode 的 Byte 值。

• PipeOptions 的 None 值。

• 默認輸入和輸出緩衝區大小。

• 沒有管道安全性。

• HandleInheritability 的 None 值。

• 未指定其他 PipeAccessRights。

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)

來源:

NamedPipeServerStream.cs

使用指定的管道名稱、管道方向、伺服器執行個體數目上限、傳輸模式、管道選項，以及建議的輸入與輸出緩衝區大小，初始化 NamedPipeServerStream 類別的新執行個體。

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode, System::IO::Pipes::PipeOptions options, int inBufferSize, int outBufferSize);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options, int inBufferSize, int outBufferSize);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions * int * int -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions, inBufferSize As Integer, outBufferSize As Integer)

參數

pipeName

String

管道的名稱。

direction

PipeDirection

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

maxNumberOfServerInstances

Int32

可共用相同名稱的最大伺服器執行個體數目。 您可以為這個值傳遞 MaxAllowedServerInstances。

transmissionMode

PipeTransmissionMode

其中一個列舉值，決定管道的傳輸模式。

options

PipeOptions

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

inBufferSize

Int32

大於零的正值，指出輸入緩衝區大小。

outBufferSize

Int32

大於零的正值，指出輸出緩衝區大小。

例外狀況

ArgumentNullException

pipeName 為 null。

ArgumentException

pipeName 是零長度字串

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

-或-

maxNumberofServerInstances 小於 -1 或大於 254 (-1 代表 MaxAllowedServerInstances)

-或-

options 不是有效的 PipeOptions 值。

-或-

inBufferSize 為負。

NotSupportedException

pipeName 包含冒號 (":")。

IOException

已經超過伺服器執行個體的最大數目。

備註

此建構函式會 NamedPipeServerStream 建立具有下列特性的物件：

• 沒有額外的管道安全性。

• 的None預設值HandleInheritability。

• 未指定其他 PipeAccessRights。

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)

來源:

NamedPipeServerStream.cs

使用指定的管道名稱、管道方向、伺服器執行個體數目上限、傳輸模式，以及管道選項，初始化 NamedPipeServerStream 類別的新執行個體。

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode, System::IO::Pipes::PipeOptions options);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions)

參數

pipeName

String

管道的名稱。

direction

PipeDirection

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

maxNumberOfServerInstances

Int32

可共用相同名稱的最大伺服器執行個體數目。 您可以為這個值傳遞 MaxAllowedServerInstances。

transmissionMode

PipeTransmissionMode

其中一個列舉值，決定管道的傳輸模式。

options

PipeOptions

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

例外狀況

ArgumentNullException

pipeName 為 null。

ArgumentException

pipeName 是零長度字串

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

-或-

maxNumberofServerInstances 小於 -1 或大於 254 (-1 代表 MaxAllowedServerInstances)

-或-

options 不是有效的 PipeOptions 值。

NotSupportedException

pipeName 包含冒號 (":")。

IOException

已經超過伺服器執行個體的最大數目。

備註

此建構函式會 NamedPipeServerStream 建立具有下列特性的物件：

• 默認輸入和輸出緩衝區大小。

• 沒有管道安全性。

• HandleInheritability 的 None 值。

• 未指定其他 PipeAccessRights。

NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

來源:

NamedPipeServerStream.Unix.cs

從指定的管道控制碼初始化 NamedPipeServerStream 類別的新執行個體。

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

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

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

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

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

例外狀況

ArgumentOutOfRangeException

direction 不是有效的 PipeDirection 值。

ArgumentNullException

safePipeHandle 為 null。

ArgumentException

safePipeHandle 不是有效的控制代碼。

IOException

safePipeHandle 不是有效的管道控制碼。

-或-

已經超過伺服器執行個體的最大數目。

NamedPipeServerStream(String, PipeDirection, Int32)

來源:

NamedPipeServerStream.cs

使用指定的管道名稱、管道方向和伺服器執行個體數目上限，初始化 NamedPipeServerStream 類別的新執行個體。

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer)

參數

pipeName

String

管道的名稱。

direction

PipeDirection

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

maxNumberOfServerInstances

Int32

可共用相同名稱的最大伺服器執行個體數目。 您可以為這個值傳遞 MaxAllowedServerInstances。

例外狀況

ArgumentNullException

pipeName 為 null。

ArgumentException

pipeName 是零長度字串

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

-或-

必須是非負數。

-或-

maxNumberofServerInstances 小於 -1 或大於 254 (-1 代表 MaxAllowedServerInstances)

-或-

需要有 None 或 Inheritable。

-或-

存取權限僅限於 ChangePermissions、TakeOwnership 及 AccessSystemSecurity 旗標。

NotSupportedException

pipeName 包含冒號 (":")。

IOException

已經超過伺服器執行個體的最大數目。

備註

此建構函式會 NamedPipeServerStream 建立具有下列特性的物件：

• 共用相同名稱的伺服器實例數目上限為1的預設值。

• 的Byte預設值PipeTransmissionMode。

• PipeOptions 的 None 值。

• 默認輸入和輸出緩衝區大小。

• 沒有管道安全性。

• HandleInheritability 的 None 值。

• 未指定其他 PipeAccessRights。

NamedPipeServerStream(String, PipeDirection)

來源:

NamedPipeServerStream.cs

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

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection)

參數

pipeName

String

管道的名稱。

direction

PipeDirection

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

例外狀況

ArgumentNullException

pipeName 為 null。

ArgumentException

pipeName 是零長度字串

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

NotSupportedException

pipeName 包含冒號 (":")。

IOException

已經超過伺服器執行個體的最大數目。

範例

下列範例示範使用命名管道將字串從父進程傳送至子進程的方法。 本範例會在 NamedPipeServerStream 父進程中建立物件。 物件 NamedPipeServerStream 具有 PipeDirection 的值 Out，然後封鎖物件，直到 NamedPipeClientStream 物件建立目前 NamedPipeServerStream 對象的連接為止。

using System;
using System.IO;
using System.IO.Pipes;

class PipeServer
{
    static void Main()
    {
        using (NamedPipeServerStream pipeServer =
            new NamedPipeServerStream("testpipe", PipeDirection.Out))
        {
            Console.WriteLine("NamedPipeServerStream object created.");

            // Wait for a client to connect
            Console.Write("Waiting for client connection...");
            pipeServer.WaitForConnection();

            Console.WriteLine("Client connected.");
            try
            {
                // Read user input and send that to the client process.
                using (StreamWriter sw = new StreamWriter(pipeServer))
                {
                    sw.AutoFlush = true;
                    Console.Write("Enter text: ");
                    sw.WriteLine(Console.ReadLine());
                }
            }
            // Catch the IOException that is raised if the pipe is broken
            // or disconnected.
            catch (IOException e)
            {
                Console.WriteLine("ERROR: {0}", e.Message);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Pipes

Class PipeServer

    Shared Sub Main()
        Dim pipeServer As New NamedPipeServerStream("testpipe", PipeDirection.Out)

        Console.WriteLine("NamedPipeServerStream object created.")

        ' Wait for a client to connect
        Console.Write("Waiting for a client connection...")
        pipeServer.WaitForConnection()

        Console.WriteLine("Client connected.")
        Try
            'Read user input and send that to the client process.
            Dim sw As New StreamWriter(pipeServer)
            sw.AutoFlush = True
            Console.Write("Enter Text: ")
            sw.WriteLine(Console.ReadLine())
        Catch ex As IOException
            ' Catch the IOException that is raised if the pipe is broken
            ' or disconnected
            Console.WriteLine("ERROR: {0}", ex.Message)
        End Try
    End Sub
End Class

備註

此建構函式會 NamedPipeServerStream 建立具有下列特性的物件：

• PipeTransmissionMode 的 Byte 值。

• PipeOptions 的 None 值。

• 默認輸入和輸出緩衝區大小。

• 沒有管道安全性。

• HandleInheritability 的 None 值。

• 未指定其他 PipeAccessRights。

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)

來源:

NamedPipeServerStream.cs

使用指定的管道名稱、管道方向、伺服器執行個體數目上限以及傳輸模式，初始化 NamedPipeServerStream 類別的新執行個體。

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode)

參數

pipeName

String

管道的名稱。

direction

PipeDirection

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

maxNumberOfServerInstances

Int32

可共用相同名稱的最大伺服器執行個體數目。 您可以為這個值傳遞 MaxAllowedServerInstances。

transmissionMode

PipeTransmissionMode

其中一個列舉值，決定管道的傳輸模式。

例外狀況

ArgumentNullException

pipeName 為 null。

ArgumentException

pipeName 是零長度字串

ArgumentOutOfRangeException

將 pipeName 設定為「匿名」。

-或-

direction 不是有效的 PipeDirection 值。

-或-

maxNumberofServerInstances 小於 -1 或大於 254 (-1 代表 MaxAllowedServerInstances)

NotSupportedException

pipeName 包含冒號 (":")。

IOException

已經超過伺服器執行個體的最大數目。

備註

此建構函式會 NamedPipeServerStream 建立具有下列特性的物件：

• 的None預設值PipeOptions。

• 默認輸入和輸出緩衝區大小。

• 沒有管道安全性。

• HandleInheritability 的 None 值。

• 未指定其他 PipeAccessRights。