NamedPipeClientStream.NumberOfServerInstances Eigenschaft

Definition

Namespace:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Quelle:

NamedPipeClientStream.Unix.cs

Ruft die Anzahl von Serverinstanzen mit dem gleichen Pipenamen ab.

public:
 property int NumberOfServerInstances { int get(); };

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public int NumberOfServerInstances { get; }

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
member this.NumberOfServerInstances : int

Public ReadOnly Property NumberOfServerInstances As Integer

Eigenschaftswert

Int32

Die Anzahl von Serverinstanzen mit dem gleichen Pipenamen.

Attribute

SupportedOSPlatformAttribute

Ausnahmen

InvalidOperationException

Das Pipehandle wurde nicht festgelegt.

- oder -

Das aktuelle NamedPipeClientStream-Objekt hat noch keine Verbindung mit einem NamedPipeServerStream-Objekt hergestellt.

IOException

Die Pipe wurde unterbrochen, oder es ist ein E/A-Fehler aufgetreten.

ObjectDisposedException

Das zugrunde liegende Pipehandle wird geschlossen.

Beispiele

Das folgende Beispiel veranschaulicht eine Methode zum Senden einer Zeichenfolge von einem übergeordneten Prozess an einen untergeordneten Prozess mithilfe von Named Pipes. In diesem Beispiel wird ein NamedPipeClientStream Objekt in einem untergeordneten Prozess erstellt, der dann eine Verbindung mit einer Pipe auf dem lokalen Computer herstellt. Das Serverbeispiel ist in der NamedPipeServerStream -Klasse zu sehen. Dieses Beispiel ist Teil eines größeren Beispiels, das für die NamedPipeServerStream Klassen und NamedPipeClientStream bereitgestellt wird.

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

Hinweise

Diese Eigenschaft gibt die Anzahl der Serverinstanzen für das NamedPipeServerStream Objekt zurück, mit dem das aktuelle NamedPipeClientStream Objekt über ein Handle verfügt oder mit dem verbunden ist. Wenn das aktuelle NamedPipeClientStream Objekt noch nicht mit einem Named Pipe-Server verbunden ist oder das aktuelle Pipehandle noch nicht festgelegt wurde, löst diese Eigenschaft einen aus InvalidOperationException.