AnonymousPipeServerStream Construtores

Definição

Espaço de Nomes:: System.IO.Pipes

Assemblagens:: netstandard.dll, System.IO.Pipes.dll

Assemblagem:: System.IO.Pipes.dll

Assemblagem:: System.Core.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da AnonymousPipeServerStream classe.

Sobrecargas

Name	Descrição
AnonymousPipeServerStream()	Inicializa uma nova instância da AnonymousPipeServerStream classe.
AnonymousPipeServerStream(PipeDirection)	Inicializa uma nova instância da AnonymousPipeServerStream classe com a direção do pipe especificada.
AnonymousPipeServerStream(PipeDirection, HandleInheritability)	Inicializa uma nova instância da AnonymousPipeServerStream classe com a direção do pipe e o modo de herdabilidade especificados.
AnonymousPipeServerStream(PipeDirection, SafePipeHandle, SafePipeHandle)	Inicializa uma nova instância da AnonymousPipeServerStream classe a partir dos handles de pipe especificados.
AnonymousPipeServerStream(PipeDirection, HandleInheritability, Int32)	Inicializa uma nova instância da AnonymousPipeServerStream classe com a direção do pipe especificada, modo de herdabilidade e tamanho do buffer.
AnonymousPipeServerStream(PipeDirection, HandleInheritability, Int32, PipeSecurity)	Inicializa uma nova instância da AnonymousPipeServerStream classe com a direção do pipe especificada, modo de herdabilidade, tamanho do buffer e segurança do pipe.

AnonymousPipeServerStream()

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Inicializa uma nova instância da AnonymousPipeServerStream classe.

public:
 AnonymousPipeServerStream();

public AnonymousPipeServerStream();

Public Sub New ()

Observações

Para AnonymousPipeServerStream construtores sem parâmetro PipeDirection , a direção padrão é Out. Um PipeDirection valor de InOut não é suportado porque os pipes anónimos são definidos como unidirecionais.

Este construtor cria um AnonymousPipeServerStream objeto que tem o tamanho padrão do buffer, sem segurança no canal, e com um HandleInheritability valor de None.

Aplica-se a

AnonymousPipeServerStream(PipeDirection)

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Inicializa uma nova instância da AnonymousPipeServerStream classe com a direção do pipe especificada.

public:
 AnonymousPipeServerStream(System::IO::Pipes::PipeDirection direction);

public AnonymousPipeServerStream(System.IO.Pipes.PipeDirection direction);

new System.IO.Pipes.AnonymousPipeServerStream : System.IO.Pipes.PipeDirection -> System.IO.Pipes.AnonymousPipeServerStream

Public Sub New (direction As PipeDirection)

Parâmetros

direction: PipeDirection

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

Pipes anónimos só podem estar numa direção, pelo que direction não podem ser definidos para InOut.

Exceções

NotSupportedException

direction está definido como InOut.

Observações

Um PipeDirection valor de InOut não é suportado porque os pipes anónimos são definidos como unidirecionais.

Este construtor cria um AnonymousPipeServerStream objeto que tem o tamanho padrão do buffer, sem segurança no canal, e com um HandleInheritability valor de None.

Aplica-se a

AnonymousPipeServerStream(PipeDirection, HandleInheritability)

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Inicializa uma nova instância da AnonymousPipeServerStream classe com a direção do pipe e o modo de herdabilidade especificados.

public:
 AnonymousPipeServerStream(System::IO::Pipes::PipeDirection direction, System::IO::HandleInheritability inheritability);

public AnonymousPipeServerStream(System.IO.Pipes.PipeDirection direction, System.IO.HandleInheritability inheritability);

new System.IO.Pipes.AnonymousPipeServerStream : System.IO.Pipes.PipeDirection * System.IO.HandleInheritability -> System.IO.Pipes.AnonymousPipeServerStream

Public Sub New (direction As PipeDirection, inheritability As HandleInheritability)

Parâmetros

direction: PipeDirection

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

Pipes anónimos só podem estar numa direção, pelo que direction não podem ser definidos para InOut.

inheritability: HandleInheritability

Um dos valores de enumeração que determina se o handle subjacente pode ser herdado por processos filhos. Deve ser definido para ou None Inheritable.

Exceções

ArgumentOutOfRangeException

inheritability não está definido para nenhum dos None dois ou Inheritable.

NotSupportedException

direction está definido como InOut.

Exemplos

O exemplo seguinte demonstra um método para enviar uma string de um processo pai para um processo filho usando pipes anónimos. Neste exemplo, um AnonymousPipeServerStream objeto é criado num processo pai com um PipeDirection valor de Out.

//<snippet01>
using System;
using System.IO;
using System.IO.Pipes;
using System.Diagnostics;

class PipeServer
{
    static void Main()
    {
        Process pipeClient = new Process();

        pipeClient.StartInfo.FileName = "pipeClient.exe";

        using (AnonymousPipeServerStream pipeServer =
            new AnonymousPipeServerStream(PipeDirection.Out,
            HandleInheritability.Inheritable))
        {
            Console.WriteLine("[SERVER] Current TransmissionMode: {0}.",
                pipeServer.TransmissionMode);

            // Pass the client process a handle to the server.
            pipeClient.StartInfo.Arguments =
                pipeServer.GetClientHandleAsString();
            pipeClient.StartInfo.UseShellExecute = false;
            pipeClient.Start();

            pipeServer.DisposeLocalCopyOfClientHandle();

            try
            {
                // Read user input and send that to the client process.
                using (StreamWriter sw = new StreamWriter(pipeServer))
                {
                    sw.AutoFlush = true;
                    // Send a 'sync message' and wait for client to receive it.
                    sw.WriteLine("SYNC");
                    pipeServer.WaitForPipeDrain();
                    // Send the console input to the client process.
                    Console.Write("[SERVER] Enter text: ");
                    sw.WriteLine(Console.ReadLine());
                }
            }
            // Catch the IOException that is raised if the pipe is broken
            // or disconnected.
            catch (IOException e)
            {
                Console.WriteLine("[SERVER] Error: {0}", e.Message);
            }
        }

        pipeClient.WaitForExit();
        pipeClient.Close();
        Console.WriteLine("[SERVER] Client quit. Server terminating.");
    }
}
//</snippet01>

'<snippet01>
Imports System.IO
Imports System.IO.Pipes
Imports System.Diagnostics

Class PipeServer
    Shared Sub Main()
        Dim pipeClient As New Process()

        pipeClient.StartInfo.FileName = "pipeClient.exe"

        Using pipeServer As New AnonymousPipeServerStream(PipeDirection.Out, _
            HandleInheritability.Inheritable)

            Console.WriteLine("[SERVER] Current TransmissionMode: {0}.",
                pipeServer.TransmissionMode)

            ' Pass the client process a handle to the server.
            pipeClient.StartInfo.Arguments = pipeServer.GetClientHandleAsString()
            pipeClient.StartInfo.UseShellExecute = false
            pipeClient.Start()

            pipeServer.DisposeLocalCopyOfClientHandle()

            Try
                ' Read user input and send that to the client process.
                Using sw As New StreamWriter(pipeServer)
                    sw.AutoFlush = true
                    ' Send a 'sync message' and wait for client to receive it.
                    sw.WriteLine("SYNC")
                    pipeServer.WaitForPipeDrain()
                    ' Send the console input to the client process.
                    Console.Write("[SERVER] Enter text: ")
                    sw.WriteLine(Console.ReadLine())
                End Using
            Catch e As IOException
                ' Catch the IOException that is raised if the pipe is broken
                ' or disconnected.
                Console.WriteLine("[SERVER] Error: {0}", e.Message)
            End Try
        End Using

        pipeClient.WaitForExit()
        pipeClient.Close()
        Console.WriteLine("[SERVER] Client quit. Server terminating.")
    End Sub
End Class
'</snippet01>

Observações

Um PipeDirection valor de InOut não é suportado porque os pipes anónimos são definidos como unidirecionais.

Este construtor cria um AnonymousPipeServerStream objeto que tem o tamanho padrão do buffer e não tem segurança no pipeline.

Aplica-se a

AnonymousPipeServerStream(PipeDirection, SafePipeHandle, SafePipeHandle)

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Inicializa uma nova instância da AnonymousPipeServerStream classe a partir dos handles de pipe especificados.

public:
 AnonymousPipeServerStream(System::IO::Pipes::PipeDirection direction, Microsoft::Win32::SafeHandles::SafePipeHandle ^ serverSafePipeHandle, Microsoft::Win32::SafeHandles::SafePipeHandle ^ clientSafePipeHandle);

public AnonymousPipeServerStream(System.IO.Pipes.PipeDirection direction, Microsoft.Win32.SafeHandles.SafePipeHandle serverSafePipeHandle, Microsoft.Win32.SafeHandles.SafePipeHandle clientSafePipeHandle);

[System.Security.SecurityCritical]
public AnonymousPipeServerStream(System.IO.Pipes.PipeDirection direction, Microsoft.Win32.SafeHandles.SafePipeHandle serverSafePipeHandle, Microsoft.Win32.SafeHandles.SafePipeHandle clientSafePipeHandle);

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

[<System.Security.SecurityCritical>]
new System.IO.Pipes.AnonymousPipeServerStream : System.IO.Pipes.PipeDirection * Microsoft.Win32.SafeHandles.SafePipeHandle * Microsoft.Win32.SafeHandles.SafePipeHandle -> System.IO.Pipes.AnonymousPipeServerStream

Public Sub New (direction As PipeDirection, serverSafePipeHandle As SafePipeHandle, clientSafePipeHandle As SafePipeHandle)

Parâmetros

direction: PipeDirection

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

Pipes anónimos só podem estar numa direção, pelo que direction não podem ser definidos para InOut.

serverSafePipeHandle: SafePipeHandle

Uma pega segura para o tubo que este AnonymousPipeServerStream objeto irá encapsular.

clientSafePipeHandle: SafePipeHandle

Uma pega segura para o AnonymousPipeClientStream objeto.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentException

serverSafePipeHandle ou clientSafePipeHandle é um nome de utilizador inválido.

ArgumentNullException

serverSafePipeHandle ou clientSafePipeHandle é null.

NotSupportedException

direction está definido como InOut.

IOException

Ocorreu um erro de E/S, como um erro de disco.

-ou-

O riacho foi encerrado.

Observações

Um PipeDirection valor de InOut não é suportado porque os pipes anónimos são definidos como unidirecionais.

Aplica-se a

AnonymousPipeServerStream(PipeDirection, HandleInheritability, Int32)

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Origem:: AnonymousPipeServerStream.cs

Inicializa uma nova instância da AnonymousPipeServerStream classe com a direção do pipe especificada, modo de herdabilidade e tamanho do buffer.

public:
 AnonymousPipeServerStream(System::IO::Pipes::PipeDirection direction, System::IO::HandleInheritability inheritability, int bufferSize);

public AnonymousPipeServerStream(System.IO.Pipes.PipeDirection direction, System.IO.HandleInheritability inheritability, int bufferSize);

[System.Security.SecurityCritical]
public AnonymousPipeServerStream(System.IO.Pipes.PipeDirection direction, System.IO.HandleInheritability inheritability, int bufferSize);

new System.IO.Pipes.AnonymousPipeServerStream : System.IO.Pipes.PipeDirection * System.IO.HandleInheritability * int -> System.IO.Pipes.AnonymousPipeServerStream

[<System.Security.SecurityCritical>]
new System.IO.Pipes.AnonymousPipeServerStream : System.IO.Pipes.PipeDirection * System.IO.HandleInheritability * int -> System.IO.Pipes.AnonymousPipeServerStream

Public Sub New (direction As PipeDirection, inheritability As HandleInheritability, bufferSize As Integer)

Parâmetros

direction: PipeDirection

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

Pipes anónimos só podem estar numa direção, pelo que direction não podem ser definidos para InOut.

inheritability: HandleInheritability

Um dos valores de enumeração que determina se o handle subjacente pode ser herdado por processos filhos. Deve ser definido para ou None Inheritable.

bufferSize: Int32

O tamanho do buffer. Este valor deve ser maior ou igual a 0.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

inheritability não está definido para nenhum dos None dois ou Inheritable.

-ou-

bufferSize é inferior a 0.

NotSupportedException

direction está definido como InOut.

Observações

Um PipeDirection valor de InOut não é suportado porque os pipes anónimos são definidos como unidirecionais.

Este construtor cria um AnonymousPipeServerStream objeto sem segurança do canal.

Aplica-se a

AnonymousPipeServerStream(PipeDirection, HandleInheritability, Int32, PipeSecurity)

Inicializa uma nova instância da AnonymousPipeServerStream classe com a direção do pipe especificada, modo de herdabilidade, tamanho do buffer e segurança do pipe.

public:
 AnonymousPipeServerStream(System::IO::Pipes::PipeDirection direction, System::IO::HandleInheritability inheritability, int bufferSize, System::IO::Pipes::PipeSecurity ^ pipeSecurity);

[System.Security.SecurityCritical]
public AnonymousPipeServerStream(System.IO.Pipes.PipeDirection direction, System.IO.HandleInheritability inheritability, int bufferSize, System.IO.Pipes.PipeSecurity pipeSecurity);

public AnonymousPipeServerStream(System.IO.Pipes.PipeDirection direction, System.IO.HandleInheritability inheritability, int bufferSize, System.IO.Pipes.PipeSecurity pipeSecurity);

[<System.Security.SecurityCritical>]
new System.IO.Pipes.AnonymousPipeServerStream : System.IO.Pipes.PipeDirection * System.IO.HandleInheritability * int * System.IO.Pipes.PipeSecurity -> System.IO.Pipes.AnonymousPipeServerStream

new System.IO.Pipes.AnonymousPipeServerStream : System.IO.Pipes.PipeDirection * System.IO.HandleInheritability * int * System.IO.Pipes.PipeSecurity -> System.IO.Pipes.AnonymousPipeServerStream

Public Sub New (direction As PipeDirection, inheritability As HandleInheritability, bufferSize As Integer, pipeSecurity As PipeSecurity)

Parâmetros

direction: PipeDirection

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

Pipes anónimos só podem estar numa direção, pelo que direction não podem ser definidos para InOut.

inheritability: HandleInheritability

Um dos valores de enumeração que determina se o handle subjacente pode ser herdado por processos filhos.

bufferSize: Int32

O tamanho do buffer. Este valor deve ser maior ou igual a 0.

pipeSecurity: PipeSecurity

Um objeto que determina o controlo de acesso e a segurança da auditoria para o tubo.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentOutOfRangeException

inheritability não está definido para nenhum dos None dois ou Inheritable.

-ou-

bufferSize é inferior a 0.

NotSupportedException

direction está definido como InOut.

Observações

Um PipeDirection valor de InOut não é suportado porque os pipes anónimos são definidos como unidirecionais.

Aplica-se a

Comentários

Esta página foi útil?