AnonymousPipeServerStream 類別

定義

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

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

type AnonymousPipeServerStream = class
    inherit PipeStream

Public NotInheritable Class AnonymousPipeServerStream
Inherits PipeStream

繼承

Object

Stream

PipeStream

AnonymousPipeServerStream

繼承

Object

MarshalByRefObject

Stream

PipeStream

AnonymousPipeServerStream

範例

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

這個範例是針對伺服器程序，該程序使用 了 這個 AnonymousPipeServerStream 類別。 完整程式碼範例，包括管線用戶端與伺服器端的程式碼，請參見 《如何：使用匿名管線進行本地程序間通訊》。

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

class PipeServer
{
    static void Main()
    {
        Process pipeClient = new Process();

        pipeClient.StartInfo.FileName = "pipeClient.exe";

        using (AnonymousPipeServerStream pipeServer =
            new AnonymousPipeServerStream(PipeDirection.Out,
            HandleInheritability.Inheritable))
        {
            Console.WriteLine("[SERVER] Current TransmissionMode: {0}.",
                pipeServer.TransmissionMode);

            // Pass the client process a handle to the server.
            pipeClient.StartInfo.Arguments =
                pipeServer.GetClientHandleAsString();
            pipeClient.StartInfo.UseShellExecute = false;
            pipeClient.Start();

            pipeServer.DisposeLocalCopyOfClientHandle();

            try
            {
                // Read user input and send that to the client process.
                using (StreamWriter sw = new StreamWriter(pipeServer))
                {
                    sw.AutoFlush = true;
                    // Send a 'sync message' and wait for client to receive it.
                    sw.WriteLine("SYNC");
                    pipeServer.WaitForPipeDrain();
                    // Send the console input to the client process.
                    Console.Write("[SERVER] Enter text: ");
                    sw.WriteLine(Console.ReadLine());
                }
            }
            // Catch the IOException that is raised if the pipe is broken
            // or disconnected.
            catch (IOException e)
            {
                Console.WriteLine("[SERVER] Error: {0}", e.Message);
            }
        }

        pipeClient.WaitForExit();
        pipeClient.Close();
        Console.WriteLine("[SERVER] Client quit. Server terminating.");
    }
}
//</snippet01>

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

Class PipeServer
    Shared Sub Main()
        Dim pipeClient As New Process()

        pipeClient.StartInfo.FileName = "pipeClient.exe"

        Using pipeServer As New AnonymousPipeServerStream(PipeDirection.Out, _
            HandleInheritability.Inheritable)

            Console.WriteLine("[SERVER] Current TransmissionMode: {0}.",
                pipeServer.TransmissionMode)

            ' Pass the client process a handle to the server.
            pipeClient.StartInfo.Arguments = pipeServer.GetClientHandleAsString()
            pipeClient.StartInfo.UseShellExecute = false
            pipeClient.Start()

            pipeServer.DisposeLocalCopyOfClientHandle()

            Try
                ' Read user input and send that to the client process.
                Using sw As New StreamWriter(pipeServer)
                    sw.AutoFlush = true
                    ' Send a 'sync message' and wait for client to receive it.
                    sw.WriteLine("SYNC")
                    pipeServer.WaitForPipeDrain()
                    ' Send the console input to the client process.
                    Console.Write("[SERVER] Enter text: ")
                    sw.WriteLine(Console.ReadLine())
                End Using
            Catch e As IOException
                ' Catch the IOException that is raised if the pipe is broken
                ' or disconnected.
                Console.WriteLine("[SERVER] Error: {0}", e.Message)
            End Try
        End Using

        pipeClient.WaitForExit()
        pipeClient.Close()
        Console.WriteLine("[SERVER] Client quit. Server terminating.")
    End Sub
End Class
'</snippet01>

備註

匿名管道有助於提供子程序與父程序間安全且可靠的程序間通訊。 此 AnonymousPipeServerStream 類別使父程序能夠從子程序傳送或接收資訊。

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

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

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

AnonymousPipeServerStream物件必須使用該DisposeLocalCopyOfClientHandle方法丟棄客戶端句柄，才能在客戶端退出時收到通知。