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 は "匿名" に設定されています。

注釈

このコンストラクターでは、次の既定値が使用されます。

• 既定のサーバー名は "." です。

• 既定値 PipeDirection は InOutです。

• 既定値 PipeOptions は Noneです。

• 既定値 TokenImpersonationLevel は Noneです。

• 既定値 HandleInheritability は Noneです。

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 が長さ 0 の文字列です。

ArgumentOutOfRangeException

pipeName は "匿名" に設定されています。

注釈

このコンストラクターでは、次の既定値が使用されます。

• 既定値 PipeDirection は InOutです。

• 既定値 PipeOptions は Noneです。

• 既定値 TokenImpersonationLevel は Noneです。

• 既定値 HandleInheritability は Noneです。

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

パイプの方向を決定する列挙値の 1 つ。

例外

ArgumentNullException

pipeName または serverName が null です。

ArgumentException

pipeName または serverName が長さ 0 の文字列です。

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

注釈

このコンストラクターでは、次の既定値が使用されます。

• 既定値 PipeOptions は Noneです。

• 既定値 TokenImpersonationLevel は Noneです。

• 既定値 HandleInheritability は Noneです。

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

パイプの方向を決定する列挙値の 1 つ。

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

パイプの方向を決定する列挙値の 1 つ。

options

PipeOptions

パイプを開く方法または作成する方法を決定する列挙値の 1 つ。

例外

ArgumentNullException

pipeName または serverName が null です。

ArgumentException

pipeName または serverName が長さ 0 の文字列です。

ArgumentOutOfRangeException

pipeName は "匿名" に設定されています。

- または -

direction は有効な PipeDirection 値ではありません。

- または -

options は正しい PipeOptions 値ではありません。

注釈

このコンストラクターでは、次の既定値が使用されます。

• 既定値 TokenImpersonationLevel は Noneです。

• 既定値 HandleInheritability は Noneです。

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

パイプの方向を決定する列挙値の 1 つ。

options

PipeOptions

パイプを開く方法または作成する方法を決定する列挙値の 1 つ。

impersonationLevel

TokenImpersonationLevel

セキュリティ偽装レベルを決定する列挙値の 1 つ。

例外

ArgumentNullException

pipeName または serverName が null です。

ArgumentException

pipeName または serverName が長さ 0 の文字列です。

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

パイプの方向を決定する列挙値の 1 つ。

options

PipeOptions

パイプを開く方法または作成する方法を決定する列挙値の 1 つ。

impersonationLevel

TokenImpersonationLevel

セキュリティ偽装レベルを決定する列挙値の 1 つ。

inheritability

HandleInheritability

基になるハンドルを子プロセスが継承するかどうかを決定する列挙値の 1 つ。

例外

ArgumentNullException

pipeName または serverName が null です。

ArgumentException

pipeName または serverName が長さ 0 の文字列です。

ArgumentOutOfRangeException

pipeName は "匿名" に設定されています。

- または -

direction は有効な PipeDirection 値ではありません。

- または -

options は有効な PipeOptions 値ではありません。

- または -

impersonationLevel は有効な TokenImpersonationLevel 値ではありません。

- または -

inheritability は正しい HandleInheritability 値ではありません。