NamedPipeClientStream コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
NamedPipeClientStream クラスの新しいインスタンスを初期化します。
オーバーロード
NamedPipeClientStream(String)
指定したパイプ名を使用して NamedPipeClientStream クラスの新しいインスタンスを初期化します。
public:
NamedPipeClientStream(System::String ^ pipeName);public NamedPipeClientStream (string pipeName);new System.IO.Pipes.NamedPipeClientStream : string -> System.IO.Pipes.NamedPipeClientStreamPublic Sub New (pipeName As String)パラメーター
- pipeName
- String
パイプ名。
例外
pipeName が nullです。
pipeName は長さゼロの文字列です。
pipeName は "匿名" に設定されています。
注釈
このコンストラクターでは、次の既定値が使用されます。
既定のサーバー名は "." です。
既定値 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.NamedPipeClientStreamPublic Sub New (serverName As String, pipeName As String)パラメーター
- serverName
- String
接続対象のリモート コンピューターの名前。ローカル コンピューターを指定する場合は "."。
- pipeName
- String
パイプ名。
例外
pipeName または serverName が null です。
pipeName または serverName が長さ 0 の文字列です。
pipeName は "匿名" に設定されています。
注釈
このコンストラクターでは、次の既定値が使用されます。
既定値 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.NamedPipeClientStreamPublic Sub New (serverName As String, pipeName As String, direction As PipeDirection)パラメーター
- serverName
- String
接続対象のリモート コンピューターの名前。ローカル コンピューターを指定する場合は "."。
- pipeName
- String
パイプ名。
- direction
- PipeDirection
パイプの方向を決定する列挙値の 1 つ。
例外
pipeName または serverName が null です。
pipeName または serverName が長さ 0 の文字列です。
例
次の例では、名前付きパイプを使用して親プロセスから子プロセスに文字列を送信するメソッドを示します。 次の使用例は、子プロセスで オブジェクトを作成 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 クラスの新しいインスタンスを初期化します。
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.NamedPipeClientStreamPublic 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 オブジェクトによってカプセル化されるパイプのセーフ ハンドル。
- 属性
例外
ストリームは閉じられました。
safePipeHandle は有効なハンドルではありません。
safePipeHandle が nullです。
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.NamedPipeClientStreamPublic Sub New (serverName As String, pipeName As String, direction As PipeDirection, options As PipeOptions)パラメーター
- serverName
- String
接続対象のリモート コンピューターの名前。ローカル コンピューターを指定する場合は "."。
- pipeName
- String
パイプ名。
- direction
- PipeDirection
パイプの方向を決定する列挙値の 1 つ。
- options
- PipeOptions
パイプを開く方法または作成する方法を決定する列挙値の 1 つ。
例外
pipeName または serverName が null です。
pipeName または serverName が長さ 0 の文字列です。
pipeName は "匿名" に設定されています。
- または -
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.NamedPipeClientStreamPublic 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 つ。
例外
pipeName または serverName が null です。
pipeName または serverName が長さ 0 の文字列です。
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.NamedPipeClientStreamnew System.IO.Pipes.NamedPipeClientStream : string * string * System.IO.Pipes.PipeAccessRights * System.IO.Pipes.PipeOptions * System.Security.Principal.TokenImpersonationLevel * System.IO.HandleInheritability -> System.IO.Pipes.NamedPipeClientStreamPublic 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 つ。
- 属性
例外
pipeName または serverName が null です。
pipeName または serverName が長さ 0 の文字列です。
pipeName は "匿名" に設定されています。
- または -
options は有効な PipeOptions 値ではありません。
- または -
impersonationLevel は有効な TokenImpersonationLevel 値ではありません。
- または -
inheritability は正しい HandleInheritability 値ではありません。
注釈
このコンストラクターのパイプの方向は、 desiredAccessRights パラメーターによって決定されます。 値が のdesiredAccessRights場合、パイプの方向は になりますIn。ReadData の値が のdesiredAccessRights場合、パイプの方向は になりますOut。WriteDataの値に と WriteDataのdesiredAccessRights両方ReadDataが含まれている場合、パイプの方向は になります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.NamedPipeClientStreamPublic 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 つ。
例外
pipeName または serverName が null です。
pipeName または serverName が長さ 0 の文字列です。
pipeName は "匿名" に設定されています。
- または -
direction は有効な PipeDirection 値ではありません。
- または -
options は有効な PipeOptions 値ではありません。
- または -
impersonationLevel は有効な TokenImpersonationLevel 値ではありません。
- または -
inheritability は正しい HandleInheritability 値ではありません。
適用対象
.NET