AnonymousPipeClientStream クラス

定義

public ref class AnonymousPipeClientStream sealed : System::IO::Pipes::PipeStream

public sealed class AnonymousPipeClientStream : System.IO.Pipes.PipeStream

type AnonymousPipeClientStream = class
    inherit PipeStream

Public NotInheritable Class AnonymousPipeClientStream
Inherits PipeStream

継承

Object

Stream

PipeStream

AnonymousPipeClientStream

継承

Object

MarshalByRefObject

Stream

PipeStream

AnonymousPipeClientStream

例

次の例では、匿名パイプを使用して、親プロセスから子プロセスに文字列を送信します。 次の使用例は、PipeDirection 値が Outの親プロセスに AnonymousPipeServerStream オブジェクトを作成します。また、PipeDirection 値が Inの子プロセスに AnonymousPipeClientStream オブジェクトも作成します。 その後、親プロセスは、ユーザー指定の文字列を子プロセスに送信します。 文字列がコンソールに表示されます。

この例は、サーバー プロセスによって開始されるクライアント プロセスを対象としています。 クライアント コード pipeClient.exe から結果の実行可能ファイルに名前を付け、この例を実行するときにサーバー実行可能ファイルと同じディレクトリにコピーします。 パイプ クライアントとサーバーの両方のコードを含むコード例全体については、「方法: ローカルプロセス間通信に匿名パイプを使用する」を参照してください。

//<snippet01>
#using <System.Core.dll>

using namespace System;
using namespace System::IO;
using namespace System::IO::Pipes;

ref class PipeClient
{
public:
    static void Main(array<String^>^ args)
    {
        if (args->Length > 1)
        {
            PipeStream^ pipeClient = gcnew AnonymousPipeClientStream(PipeDirection::In, args[1]);

            Console::WriteLine("[CLIENT] Current TransmissionMode: {0}.",
                pipeClient->TransmissionMode);

            StreamReader^ sr = gcnew StreamReader(pipeClient);

            // Display the read text to the console
            String^ temp;

            // Wait for 'sync message' from the server.
            do
            {
                Console::WriteLine("[CLIENT] Wait for sync...");
                temp = sr->ReadLine();
            }
            while (!temp->StartsWith("SYNC"));

            // Read the server data and echo to the console.
            while ((temp = sr->ReadLine()) != nullptr)
            {
                Console::WriteLine("[CLIENT] Echo: " + temp);
            }
            sr->Close();
            pipeClient->Close();
        }
        Console::Write("[CLIENT] Press Enter to continue...");
        Console::ReadLine();
    }
};

int main()
{
    array<String^>^ args = Environment::GetCommandLineArgs();
    PipeClient::Main(args);
}
//</snippet01>

//<snippet01>
using System;
using System.IO;
using System.IO.Pipes;

class PipeClient
{
    static void Main(string[] args)
    {
        if (args.Length > 0)
        {
            using (PipeStream pipeClient =
                new AnonymousPipeClientStream(PipeDirection.In, args[0]))
            {
                Console.WriteLine("[CLIENT] Current TransmissionMode: {0}.",
                   pipeClient.TransmissionMode);

                using (StreamReader sr = new StreamReader(pipeClient))
                {
                    // Display the read text to the console
                    string temp;

                    // Wait for 'sync message' from the server.
                    do
                    {
                        Console.WriteLine("[CLIENT] Wait for sync...");
                        temp = sr.ReadLine();
                    }
                    while (!temp.StartsWith("SYNC"));

                    // Read the server data and echo to the console.
                    while ((temp = sr.ReadLine()) != null)
                    {
                        Console.WriteLine("[CLIENT] Echo: " + temp);
                    }
                }
            }
        }
        Console.Write("[CLIENT] Press Enter to continue...");
        Console.ReadLine();
    }
}
//</snippet01>

'<snippet01>
Imports System.IO
Imports System.IO.Pipes

Class PipeClient
    Shared Sub Main(args() as String)
        If args.Length > 0 Then
            Using pipeClient As New AnonymousPipeClientStream(PipeDirection.In, args(0))
                Console.WriteLine("[CLIENT] Current TransmissionMode: {0}.", _
                   pipeClient.TransmissionMode)

                Using sr As New StreamReader(pipeClient)
                    ' Display the read text to the console
                    Dim temp As String

                    ' Wait for 'sync message' from the server.
                    Do
                        Console.WriteLine("[CLIENT] Wait for sync...")
                        temp = sr.ReadLine()
                    Loop While temp.StartsWith("SYNC") = False

                    ' Read the server data and echo to the console.
                    temp = sr.ReadLine()
                    While Not temp = Nothing
                        Console.WriteLine("[CLIENT] Echo: " + temp)
                        temp = sr.ReadLine()
                    End While
                End Using
            End Using
        End If
        Console.Write("[CLIENT] Press Enter to continue...")
        Console.ReadLine()
    End Sub
End Class
'</snippet01>

注釈

匿名パイプは、子プロセスと親プロセス間の安全で安全なプロセス間通信を提供するのに役立ちます。 AnonymousPipeClientStream クラスを使用すると、子プロセスが親プロセスに接続して情報を交換できます。

匿名パイプは、親プロセスと子プロセスの間で通常データを転送する名前のない一方向パイプです。 匿名パイプは常にローカルです。ネットワーク経由では使用できません。 匿名パイプは一方向として定義されているため、InOut の PipeDirection 値はサポートされていません。

匿名パイプは、PipeTransmissionMode.Message 読み取りモードをサポートしていません。

匿名パイプのクライアント側は、GetClientHandleAsString メソッドを呼び出すことによって、サーバー側から提供されるパイプ ハンドルから作成する必要があります。 この文字列は、クライアント プロセスの作成時にパラメーターとして渡されます。 クライアント プロセスから、pipeHandleAsString パラメーターとして AnonymousPipeClientStream コンストラクターに渡されます。

Windows では、非同期 (重複) の読み取り操作と書き込み操作は匿名パイプではサポートされていません (匿名パイプ操作参照)。 AnonymousPipeClientStream クラスは引き続き Windows プラットフォーム上のスレッド プールでの作業をスケジュールするため、非同期 Stream 操作は機能しますが、それらの操作の取り消しはサポートされていません。

コンストラクター

プロパティ

メソッド

拡張メソッド

適用対象