NamedPipeServerStream.WaitForConnection Método

Definição

Namespace:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Assembly:

System.Core.dll

Assembly:

netstandard.dll

Espera até que um cliente se conecte a este objeto NamedPipeServerStream.

public:
 void WaitForConnection();

public void WaitForConnection ();

[System.Security.SecurityCritical]
public void WaitForConnection ();

member this.WaitForConnection : unit -> unit

[<System.Security.SecurityCritical>]
member this.WaitForConnection : unit -> unit

Public Sub WaitForConnection ()

Atributos

SecurityCriticalAttribute

Exceções

InvalidOperationException

Já foi estabelecida uma conexão de pipe.

- ou -

O identificador de pipe não foi definido.

ObjectDisposedException

O pipe está fechado.

IOException

A conexão de pipe foi interrompida.

Exemplos

O exemplo a seguir demonstra um método para enviar uma cadeia de caracteres de um processo pai para um processo filho usando pipes nomeados. Este exemplo cria um NamedPipeServerStream objeto em um processo pai. Esse objeto tem um PipeDirection valor de Out, que então bloqueia até que um NamedPipeClientStream objeto estabeleça uma conexão com o NamedPipeServerStream objeto. Este exemplo faz parte de um exemplo maior fornecido para as classes e NamedPipeClientStream as NamedPipeServerStream classes.

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);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Pipes

Class PipeServer

    Shared Sub Main()
        Dim pipeServer As New NamedPipeServerStream("testpipe", PipeDirection.Out)

        Console.WriteLine("NamedPipeServerStream object created.")

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

        Console.WriteLine("Client connected.")
        Try
            'Read user input and send that to the client process.
            Dim sw As New StreamWriter(pipeServer)
            sw.AutoFlush = True
            Console.Write("Enter Text: ")
            sw.WriteLine(Console.ReadLine())
        Catch ex As IOException
            ' Catch the IOException that is raised if the pipe is broken
            ' or disconnected
            Console.WriteLine("ERROR: {0}", ex.Message)
        End Try
    End Sub
End Class

Comentários

Chamar esse método faz com que o NamedPipeServerStream objeto seja bloqueado até que um cliente se conecte.