NamedPipeServerStream-Klasse

Benannte Pipes stellen unidirektionale oder Duplexpipes für die Kommunikation zwischen einem Pipeserver und einem oder mehrere Pipeclients bereit. Benannte Pipes können lokal oder in einem Netzwerk für die prozessübergreifende Kommunikation verwendet werden. Ein einzelner Pipename kann von mehreren NamedPipeClientStream-Objekten verwendet werden.

Jeder Prozess kann als Server oder Client für benannte Pipes oder als Server und Client für benannte Pipes verwendet werden.

Hinweis
Unter Windows XP Professional und Windows 2000 Server können maximal 10 Pipes gleichzeitig eine Verbindung über das Netzwerk herstellen.

Hinweis

Das auf diesen Typ oder Member angewendete HostProtectionAttribute-Attribut besitzt den folgenden Resources-Eigenschaftswert: MayLeakOnAbort. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder einer URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.

Im folgenden Beispiel wird gezeigt, wie eine Zeichenfolge mithilfe von benannten Pipes von einem übergeordneten Prozess an einen untergeordneten Prozess auf demselben Computer gesendet werden kann. In diesem Beispiel wird ein NamedPipeServerStream-Objekt in einem übergeordneten Prozess mit dem PipeDirection-Wert Out erstellt. Der Server wartet dann auf das Herstellen einer Verbindung durch ein NamedPipeClientStream-Objekt in einem untergeordneten Prozess. In diesem Beispiel werden beide Prozesse auf demselben Computer ausgeführt, und das NamedPipeClientStream-Objekt weist den PipeDirection-Wert In auf. Der übergeordnete Prozess sendet daraufhin eine vom Benutzer bereitgestellte Zeichenfolge an den untergeordneten Prozess. Die Zeichenfolge wird in der Konsole angezeigt.

Dies ist ein Beispiel für den Serverprozess, der die NamedPipeServerStream-Klasse verwendet. Das gesamte Codebeispiel, einschließlich des Codes für Pipeclient und -server, finden Sie unter Gewusst wie: Verwenden von benannten Pipes zur Kommunikation zwischen Prozessen über ein Netzwerk.

using System;
using System.IO;
using System.IO.Pipes;

class PipeServer
{
    static void Main()
    {
        using (NamedPipeServerStream pipeServer =
            new NamedPipeServerStream("testpipe", PipeDirection.Out))
        {
            Console.WriteLine("NamedPipeServerStream object created.");

            // Wait for a client to connect
            Console.Write("Waiting for client connection...");
            pipeServer.WaitForConnection();

            Console.WriteLine("Client connected.");
            try
            {
                // Read user input and send that to the client process.
                using (StreamWriter sw = new StreamWriter(pipeServer))
                {
                    sw.AutoFlush = true;
                    Console.Write("Enter text: ");
                    sw.WriteLine(Console.ReadLine());
                }
            }
            // Catch the IOException that is raised if the pipe is broken
            // or disconnected.
            catch (IOException e)
            {
                Console.WriteLine("ERROR: {0}", e.Message);
            }
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz