NamedPipeServerStream Construtores

Definição

Namespace:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Inicializa uma nova instância da classe NamedPipeServerStream.

Sobrecargas

NamedPipeServerStream(String)	Inicializa uma nova instância da classe NamedPipeServerStream com o nome do pipe especificado.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)	Inicializa uma nova instância da classe NamedPipeServerStream com o nome do pipe, direção do pipe, número máximo de instâncias do servidor, modo de transmissão, opções de pipe e os tamanhos do buffer de entrada e saída recomendados especificados.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)	Inicializa uma nova instância da classe NamedPipeServerStream com o nome do pipe, direção do pipe, número máximo de instâncias do servidor, modo de transmissão e opções de pipe especificados.
NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Inicializa uma nova instância da classe NamedPipeServerStream do identificador de pipe especificado.
NamedPipeServerStream(String, PipeDirection, Int32)	Inicializa uma nova instância da classe NamedPipeServerStream com o nome de pipe, direção do pipe e o número máximo de instâncias do servidor especificados.
NamedPipeServerStream(String, PipeDirection)	Inicializa uma nova instância da classe NamedPipeServerStream com o nome do pipe e a direção do pipe especificados.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)	Inicializa uma nova instância da classe NamedPipeServerStream com o nome do pipe, a direção do pipe, o número máximo de instâncias do servidor e o modo de transmissão especificados.

NamedPipeServerStream(String)

Origem:

NamedPipeServerStream.cs

Inicializa uma nova instância da classe NamedPipeServerStream com o nome do pipe especificado.

public:
 NamedPipeServerStream(System::String ^ pipeName);

public NamedPipeServerStream (string pipeName);

new System.IO.Pipes.NamedPipeServerStream : string -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String)

Parâmetros

pipeName

String

O nome do pipe.

Exceções

ArgumentNullException

pipeName é null.

ArgumentException

pipeName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

NotSupportedException

pipeName contém dois-pontos (“:”).

IOException

O número máximo de instâncias do servidor foi excedido.

Comentários

Esse construtor cria um NamedPipeServerStream objeto que tem as seguintes características:

• Uma direção de pipe padrão de InOut.

• O número máximo de instâncias de servidor que compartilham o mesmo nome definido como 1.

• Um PipeTransmissionMode valor de Byte.

• Um PipeOptions valor de None.

• Tamanhos de buffer de entrada e saída padrão.

• Sem segurança de pipe.

• Um HandleInheritability valor de None.

• Nenhum adicional PipeAccessRightsespecificado.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)

Origem:

NamedPipeServerStream.cs

Inicializa uma nova instância da classe NamedPipeServerStream com o nome do pipe, direção do pipe, número máximo de instâncias do servidor, modo de transmissão, opções de pipe e os tamanhos do buffer de entrada e saída recomendados especificados.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode, System::IO::Pipes::PipeOptions options, int inBufferSize, int outBufferSize);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options, int inBufferSize, int outBufferSize);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions * int * int -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions, inBufferSize As Integer, outBufferSize As Integer)

Parâmetros

pipeName

String

O nome do pipe.

direction

PipeDirection

Um dos valores de enumeração que determinam a direção do pipe.

maxNumberOfServerInstances

Int32

O número máximo de instâncias de servidor que compartilham o mesmo nome. Você pode passar MaxAllowedServerInstances para esse valor.

transmissionMode

PipeTransmissionMode

Um dos valores de enumeração que determina o modo de transmissão do pipe.

options

PipeOptions

Um dos valores de enumeração que determina como abrir ou criar o pipe.

inBufferSize

Int32

Um valor positivo maior que 0 que indica o tamanho do buffer de entrada.

outBufferSize

Int32

Um valor positivo maior que 0 que indica o tamanho do buffer de saída.

Exceções

ArgumentNullException

pipeName é null.

ArgumentException

pipeName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

- ou -

direction não é um valor PipeDirection válido.

- ou -

maxNumberofServerInstances é menor que -1 ou maior que 254 (-1 indica MaxAllowedServerInstances)

- ou -

options não é um valor PipeOptions válido.

- ou -

inBufferSize é negativo.

NotSupportedException

pipeName contém dois-pontos (“:”).

IOException

O número máximo de instâncias do servidor foi excedido.

Comentários

Esse construtor cria um NamedPipeServerStream objeto que tem as seguintes características:

• Não há segurança de pipe adicional.

• Um valor padrão HandleInheritability de None.

• Nenhum adicional PipeAccessRightsespecificado.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)

Origem:

NamedPipeServerStream.cs

Inicializa uma nova instância da classe NamedPipeServerStream com o nome do pipe, direção do pipe, número máximo de instâncias do servidor, modo de transmissão e opções de pipe especificados.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode, System::IO::Pipes::PipeOptions options);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions)

Parâmetros

pipeName

String

O nome do pipe.

direction

PipeDirection

Um dos valores de enumeração que determinam a direção do pipe.

maxNumberOfServerInstances

Int32

O número máximo de instâncias de servidor que compartilham o mesmo nome. Você pode passar MaxAllowedServerInstances para esse valor.

transmissionMode

PipeTransmissionMode

Um dos valores de enumeração que determina o modo de transmissão do pipe.

options

PipeOptions

Um dos valores de enumeração que determina como abrir ou criar o pipe.

Exceções

ArgumentNullException

pipeName é null.

ArgumentException

pipeName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

- ou -

direction não é um valor PipeDirection válido.

- ou -

maxNumberofServerInstances é menor que -1 ou maior que 254 (-1 indica MaxAllowedServerInstances)

- ou -

options não é um valor PipeOptions válido.

NotSupportedException

pipeName contém dois-pontos (“:”).

IOException

O número máximo de instâncias do servidor foi excedido.

Comentários

Esse construtor cria um NamedPipeServerStream objeto que tem as seguintes características:

• Tamanhos de buffer de entrada e saída padrão.

• Sem segurança de pipe.

• Um HandleInheritability valor de None.

• Nenhum adicional PipeAccessRightsespecificado.

NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Origem:

NamedPipeServerStream.Unix.cs

Inicializa uma nova instância da classe NamedPipeServerStream do identificador de pipe especificado.

public:
 NamedPipeServerStream(System::IO::Pipes::PipeDirection direction, bool isAsync, bool isConnected, Microsoft::Win32::SafeHandles::SafePipeHandle ^ safePipeHandle);

public NamedPipeServerStream (System.IO.Pipes.PipeDirection direction, bool isAsync, bool isConnected, Microsoft.Win32.SafeHandles.SafePipeHandle safePipeHandle);

new System.IO.Pipes.NamedPipeServerStream : System.IO.Pipes.PipeDirection * bool * bool * Microsoft.Win32.SafeHandles.SafePipeHandle -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (direction As PipeDirection, isAsync As Boolean, isConnected As Boolean, safePipeHandle As SafePipeHandle)

Parâmetros

direction

PipeDirection

Um dos valores de enumeração que determina a direção do pipe.

isAsync

Boolean

true para indicar que o identificador foi aberto assincronamente, caso contrário, false.

isConnected

Boolean

true para indicar que o pipe está conectado, caso contrário, false.

safePipeHandle

SafePipeHandle

Um identificador seguro para o arquivo que este objeto NamedPipeServerStream encapsulará.

Exceções

ArgumentOutOfRangeException

direction não é um valor PipeDirection válido.

ArgumentNullException

safePipeHandle é null.

ArgumentException

safePipeHandle é um identificador inválido.

IOException

safePipeHandle não é um identificador de pipe válido.

- ou -

O número máximo de instâncias do servidor foi excedido.

NamedPipeServerStream(String, PipeDirection, Int32)

Origem:

NamedPipeServerStream.cs

Inicializa uma nova instância da classe NamedPipeServerStream com o nome de pipe, direção do pipe e o número máximo de instâncias do servidor especificados.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer)

Parâmetros

pipeName

String

O nome do pipe.

direction

PipeDirection

Um dos valores de enumeração que determinam a direção do pipe.

maxNumberOfServerInstances

Int32

O número máximo de instâncias de servidor que compartilham o mesmo nome. Você pode passar MaxAllowedServerInstances para esse valor.

Exceções

ArgumentNullException

pipeName é null.

ArgumentException

pipeName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

- ou -

direction não é um valor PipeDirection válido.

- ou -

Um número não negativo é necessário.

- ou -

maxNumberofServerInstances é menor que -1 ou maior que 254 (-1 indica MaxAllowedServerInstances)

- ou -

None ou Inheritable é necessário.

- ou -

Direitos de acesso são limitados para os sinalizadores ChangePermissions, TakeOwnership e AccessSystemSecurity.

NotSupportedException

pipeName contém dois-pontos (“:”).

IOException

O número máximo de instâncias do servidor foi excedido.

Comentários

Esse construtor cria um NamedPipeServerStream objeto que tem as seguintes características:

• Um valor padrão de 1 para o número máximo de instâncias de servidor que compartilham o mesmo nome.

• Um valor padrão PipeTransmissionMode de Byte.

• Um PipeOptions valor de None.

• Tamanhos de buffer de entrada e saída padrão.

• Sem segurança de pipe.

• Um HandleInheritability valor de None.

• Nenhum adicional PipeAccessRightsespecificado.

NamedPipeServerStream(String, PipeDirection)

Origem:

NamedPipeServerStream.cs

Inicializa uma nova instância da classe NamedPipeServerStream com o nome do pipe e a direção do pipe especificados.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection)

Parâmetros

pipeName

String

O nome do pipe.

direction

PipeDirection

Um dos valores de enumeração que determinam a direção do pipe.

Exceções

ArgumentNullException

pipeName é null.

ArgumentException

pipeName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

- ou -

direction não é um valor PipeDirection válido.

NotSupportedException

pipeName contém dois-pontos (“:”).

IOException

O número máximo de instâncias do servidor foi excedido.

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. O NamedPipeServerStream objeto tem um PipeDirection valor de Out, que é bloqueado até que um NamedPipeClientStream objeto estabeleça uma conexão com o objeto atual NamedPipeServerStream .

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

Esse construtor cria um NamedPipeServerStream objeto que tem as seguintes características:

• Um PipeTransmissionMode valor de Byte.

• Um PipeOptions valor de None.

• Tamanhos de buffer de entrada e saída padrão.

• Sem segurança de pipe.

• Um HandleInheritability valor de None.

• Nenhum adicional PipeAccessRightsespecificado.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)

Origem:

NamedPipeServerStream.cs

Inicializa uma nova instância da classe NamedPipeServerStream com o nome do pipe, a direção do pipe, o número máximo de instâncias do servidor e o modo de transmissão especificados.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode)

Parâmetros

pipeName

String

O nome do pipe.

direction

PipeDirection

Um dos valores de enumeração que determinam a direção do pipe.

maxNumberOfServerInstances

Int32

O número máximo de instâncias de servidor que compartilham o mesmo nome. Você pode passar MaxAllowedServerInstances para esse valor.

transmissionMode

PipeTransmissionMode

Um dos valores de enumeração que determina o modo de transmissão do pipe.

Exceções

ArgumentNullException

pipeName é null.

ArgumentException

pipeName é uma cadeia de comprimento zero.

ArgumentOutOfRangeException

pipeName é definido como "anonymous".

- ou -

direction não é um valor PipeDirection válido.

- ou -

maxNumberofServerInstances é menor que -1 ou maior que 254 (-1 indica MaxAllowedServerInstances)

NotSupportedException

pipeName contém dois-pontos (“:”).

IOException

O número máximo de instâncias do servidor foi excedido.

Comentários

Esse construtor cria um NamedPipeServerStream objeto que tem as seguintes características:

• Um valor padrão PipeOptions de None.

• Tamanhos de buffer de entrada e saída padrão.

• Sem segurança de pipe.

• Um HandleInheritability valor de None.

• Nenhum adicional PipeAccessRightsespecificado.