NamedPipeClientStream.Connect Método

Definição

Namespace:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Conecta-se a um servidor de espera.

Sobrecargas

Connect(TimeSpan)	Conecta-se a um servidor de espera dentro do período de tempo limite especificado.
Connect()	Conecta a um servidor de espera com um valor de tempo limite infinito.
Connect(Int32)	Conecta a um servidor de espera dentro do período de tempo limite especificado.

Connect(TimeSpan)

Origem:

NamedPipeClientStream.cs

Conecta-se a um servidor de espera dentro do período de tempo limite especificado.

public:
 void Connect(TimeSpan timeout);

public void Connect (TimeSpan timeout);

member this.Connect : TimeSpan -> unit

Public Sub Connect (timeout As TimeSpan)

Parâmetros

timeout

TimeSpan

A quantidade de tempo para aguardar o servidor responder antes que a conexão limite.

Comentários

Confira Connect(Int32) comentários.

Connect()

Origem:

NamedPipeClientStream.cs

Conecta a um servidor de espera com um valor de tempo limite infinito.

public:
 void Connect();

public void Connect ();

member this.Connect : unit -> unit

Public Sub Connect ()

Exceções

InvalidOperationException

O cliente já está conectado.

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 NamedPipeClientStream objeto em um processo filho, que se conecta a um pipe no computador local. O exemplo de servidor pode ser visto na NamedPipeServerStream classe . Este exemplo faz parte de um exemplo maior fornecido para as NamedPipeServerStream classes 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

Comentários

Esse método chama o Connect(Int32) método com um valor infinito de tempo limite.

Esse método aguarda que uma instância de pipe fique disponível. Connect pode retornar antes WaitForConnection de ser chamado do NamedPipeServerStream objeto , mas WaitForConnection não retornará até Connect que tenha retornado.

Todos os dados gravados no pipe após a conexão de um NamedPipeClientStream objeto, mas antes que o servidor tenha chamado WaitForConnection, estarão disponíveis para o servidor após a chamada para WaitForConnection.

Connect(Int32)

Origem:

NamedPipeClientStream.cs

Conecta a um servidor de espera dentro do período de tempo limite especificado.

public:
 void Connect(int timeout);

public void Connect (int timeout);

member this.Connect : int -> unit

Public Sub Connect (timeout As Integer)

Parâmetros

timeout

Int32

O número de milissegundos a se aguardar a resposta do servidor antes da conexão expirar.

Exceções

TimeoutException

Não foi possível se conectar ao servidor no período timeout especificado.

ArgumentOutOfRangeException

timeout é menor que 0 e não é definido como Infinite.

InvalidOperationException

O cliente já está conectado.

IOException

O servidor está conectado a outro cliente e o período de tempo limite expirou.

Comentários

Esse método aguarda que uma instância de pipe fique disponível. Connect pode retornar antes WaitForConnection de ser chamado do NamedPipeServerStream, mas WaitForConnection não retornará até Connect que tenha retornado. Defina o timeout parâmetro como Infinite para especificar um valor de tempo limite infinito.

Todos os dados gravados no pipe após a conexão de um NamedPipeClientStream objeto, mas antes que o servidor tenha chamado WaitForConnection, estarão disponíveis para o servidor após a chamada para WaitForConnection.