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

範例

以下範例是透過匿名管道將字串從父程序傳送到子程序。 此範例在父程序中建立 AnonymousPipeServerStream 一個物件，其 PipeDirection 值為 Out。它也會在子程序中建立 AnonymousPipeClientStream 一個物件，其 PipeDirection 值為 In。 父程序接著將使用者提供的字串傳送給子程序。 這串字串會顯示在主控台上。

此範例為客戶端程序，由伺服器程序啟動。 執行這個範例時，從客戶端程式碼 pipeClient.exe 中命名產生的可執行檔，並將其複製到與伺服器執行檔相同的目錄。 完整程式碼範例，包括管線用戶端與伺服器端的程式碼，請參見 《如何：使用匿名管線進行本地程序間通訊》。

//<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 類別使子程序能夠連接並與父程序交換資訊。

匿名管道是無名稱的單向管道，通常在父程序與子程序間傳輸資料。 匿名管道總是本地的;它們無法透過網路使用。 PipeDirection不支援 的InOut值，因為匿名管道被定義為單向。

匿名管道不支援 PipeTransmissionMode.Message 讀取模式。

匿名管道的用戶端必須由伺服器端透過呼叫 GetClientHandleAsString 該方法所提供的管道處理碼建立。 該字串接著會作為參數傳遞給建立客戶端程序。 從客戶端程序中，將參數傳給 AnonymousPipeClientStream 建構子 pipeHandleAsString 。

在 Windows 上，非同步（重疊）讀寫操作不被匿名管道支援（參見 Anonymous 管道操作）。 AnonymousPipeClientStream 類別仍會在Windows平台上排程執行緒池的工作，因此非同步Stream 操作可執行，但不支援取消這些操作。