NamedPipeClientStream コンストラクター

定義

名前空間:: System.IO.Pipes

アセンブリ:: System.Core.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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 クラスの新しいインスタンスを初期化します。

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

ArgumentOutOfRangeException

pipeName が "anonymous" に設定されています。

注釈

このコンストラクターは、次の既定値を使用します。

既定のサーバー名 "."。
PipeDirectionの既定のInOut値。
PipeOptionsの既定のNone値。
TokenImpersonationLevelの既定のNone値。
HandleInheritabilityの既定のNone値。

適用対象

NamedPipeClientStream(String, String)

指定したパイプ名とサーバー名を使用して、 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 が "anonymous" に設定されています。

注釈

このコンストラクターは、次の既定値を使用します。

PipeDirectionの既定のInOut値。
PipeOptionsの既定のNone値。
TokenImpersonationLevelの既定のNone値。
HandleInheritabilityの既定のNone値。

適用対象

NamedPipeClientStream(String, String, PipeDirection)

指定したパイプ名とサーバー名、および指定したパイプの方向を使用して、 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 が "anonymous" に設定されています。

-または-

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

例

次の例は、名前付きパイプを使用して親プロセスから子プロセスに文字列を送信するメソッドを示しています。次の使用例は、子プロセスで NamedPipeClientStream オブジェクトを作成し、ローカルコンピューター上のパイプに接続します。サーバーの例は、 NamedPipeServerStream クラスで確認できます。この例は、 NamedPipeServerStream クラスと NamedPipeClientStream クラスに提供される大きな例の一部です。

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 クラスの新しいインスタンスを初期化します。

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

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

[<System.Security.SecurityCritical>]
new System.IO.Pipes.NamedPipeClientStream : System.IO.Pipes.PipeDirection * bool * bool * Microsoft.Win32.SafeHandles.SafePipeHandle -> System.IO.Pipes.NamedPipeClientStream

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 オブジェクトがカプセル化するパイプの安全なハンドル。

属性: SecurityCriticalAttribute

例外

IOException

ストリームが閉じられました。

ArgumentException

safePipeHandle は有効なハンドルではありません。

ArgumentNullException

safePipeHandle は nullです。

ArgumentOutOfRangeException

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

適用対象

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

指定したパイプとサーバー名、および指定したパイプの方向とパイプのオプションを使用して、 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 が "anonymous" に設定されています。

-または-

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

-または-

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

注釈

このコンストラクターは、次の既定値を使用します。

TokenImpersonationLevelの既定のNone値。
HandleInheritabilityの既定のNone値。

適用対象

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

指定したパイプとサーバー名、および指定したパイプの方向、パイプオプション、セキュリティ偽装レベルを使用して、 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 が "anonymous" に設定されています。

-または-

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

-または-

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

-または-

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

注釈

このコンストラクターは、HandleInheritabilityの既定のNone値を使用します。

適用対象

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

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

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

パイプの必要なアクセス権を指定する列挙値の 1 つ。

options: PipeOptions

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

impersonationLevel: TokenImpersonationLevel

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

inheritability: HandleInheritability

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

例外

ArgumentNullException

pipeName または serverName が null。

ArgumentException

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

ArgumentOutOfRangeException

pipeName が "anonymous" に設定されています。

-または-

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

-または-

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

-または-

inheritability が有効な HandleInheritability 値ではありません。

注釈

このコンストラクターのパイプ方向は、 desiredAccessRights パラメーターによって決まります。 desiredAccessRights値がReadDataの場合、パイプの方向がInされます。 desiredAccessRightsの値がWriteDataの場合、パイプの方向がOutされます。desiredAccessRightsの値にReadDataとWriteDataの両方が含まれている場合、パイプの方向はInOutされます。

適用対象

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

指定したパイプとサーバー名、および指定したパイプの方向、パイプオプション、セキュリティ偽装レベル、継承モードを使用して、 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)