NamedPipeClientStream.NumberOfServerInstances Proprietà

Definizione

Spazio dei nomi:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Origine:

NamedPipeClientStream.Unix.cs

Ottiene il numero di istanze del server che condividono lo stesso nome di pipe.

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

Valore della proprietà

Int32

Numero di istanze del server che condividono lo stesso nome di pipe.

Attributi

SupportedOSPlatformAttribute

Eccezioni

InvalidOperationException

L'handle di pipe non è stato impostato.

-oppure-

L'oggetto NamedPipeClientStream corrente non è stato ancora connesso a un oggetto NamedPipeServerStream.

IOException

Pipe danneggiata oppure errore di I/O.

ObjectDisposedException

L'handle della pipe sottostante è chiuso.

Esempio

Nell'esempio seguente viene illustrato un metodo per inviare una stringa da un processo padre a un processo figlio usando named pipe. In questo esempio viene creato un NamedPipeClientStream oggetto in un processo figlio, che quindi si connette a una pipe nel computer locale. L'esempio NamedPipeServerStream del server può essere visualizzato nella classe . Questo esempio fa parte di un esempio più grande fornito per le NamedPipeServerStream classi e NamedPipeClientStream .

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

Commenti

Questa proprietà restituisce il numero di istanze del server per l'oggetto a cui l'oggetto NamedPipeServerStream corrente NamedPipeClientStream ha un handle o è connesso. Se l'oggetto corrente NamedPipeClientStream non è ancora connesso a un server di pipe denominato o se l'handle della pipe corrente non è ancora stato impostato, questa proprietà genera un InvalidOperationExceptionoggetto .