NamedPipeServerStream Costruttori

Definizione

Spazio dei nomi:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Inizializza una nuova istanza della classe NamedPipeServerStream.

Overload

NamedPipeServerStream(String)	Inizializza una nuova istanza della classe NamedPipeServerStream con il nome di pipe specificato.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)	Inizializza una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe, il numero massimo di istanze del server, la modalità di trasmissione, le opzioni di pipe e le dimensioni consigliate del buffer di input e di output specificati.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)	Inizializza una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe, il numero massimo di istanze del server, la modalità di trasmissione e le opzioni di pipe specificati.
NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Inizializza una nuova istanza della classe NamedPipeServerStream dall'handle di pipe specificato.
NamedPipeServerStream(String, PipeDirection, Int32)	Inizializza una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe e il numero massimo di istanze del server specificati.
NamedPipeServerStream(String, PipeDirection)	Inizializza una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe specificati.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)	Inizializza una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe, il numero massimo di istanze del server e la modalità di trasmissione specificati.

NamedPipeServerStream(String)

Origine:

NamedPipeServerStream.cs

Inizializza una nuova istanza della classe NamedPipeServerStream con il nome di pipe specificato.

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)

Parametri

pipeName

String

Nome della pipe.

Eccezioni

ArgumentNullException

pipeName è null.

ArgumentException

pipeName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

NotSupportedException

pipeName contiene i due punti (":").

IOException

È stato superato il numero massimo di istanze del server.

Commenti

Questo costruttore crea un NamedPipeServerStream oggetto con le caratteristiche seguenti:

• Direzione della pipe predefinita di InOut.

• Numero massimo di istanze del server che condividono lo stesso nome impostato su 1.

• Valore PipeTransmissionMode di Byte.

• Valore PipeOptions di None.

• Dimensioni predefinite del buffer di input e output.

• Nessuna sicurezza della pipe.

• Valore HandleInheritability di None.

• Nessun elemento aggiuntivo PipeAccessRightsspecificato.

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

Origine:

NamedPipeServerStream.cs

Inizializza una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe, il numero massimo di istanze del server, la modalità di trasmissione, le opzioni di pipe e le dimensioni consigliate del buffer di input e di output specificati.

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)

Parametri

pipeName

String

Nome della pipe.

direction

PipeDirection

Uno dei valori di enumerazione che determina la direzione della pipe.

maxNumberOfServerInstances

Int32

Numero massimo di istanze del server che condividono lo stesso nome. Per questo valore è possibile passare MaxAllowedServerInstances.

transmissionMode

PipeTransmissionMode

Uno dei valori di enumerazione che determina la modalità di trasmissione della pipe.

options

PipeOptions

Uno dei valori di enumerazione che determina come aprire o creare la pipe.

inBufferSize

Int32

Valore positivo maggiore di 0 che indica la dimensione del buffer di input.

outBufferSize

Int32

Valore positivo maggiore di 0 che indica la dimensione del buffer di output.

Eccezioni

ArgumentNullException

pipeName è null.

ArgumentException

pipeName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

-oppure-

direction non è un valore valido di PipeDirection.

-oppure-

maxNumberofServerInstances è minore di -1 o maggiore di 254 (-1 indica MaxAllowedServerInstances)

-oppure-

options non è un valore valido di PipeOptions.

-oppure-

inBufferSize è negativo.

NotSupportedException

pipeName contiene i due punti (":").

IOException

È stato superato il numero massimo di istanze del server.

Commenti

Questo costruttore crea un NamedPipeServerStream oggetto con le caratteristiche seguenti:

• Nessuna sicurezza della pipe aggiuntiva.

• Valore predefinito HandleInheritability di None.

• Nessun elemento aggiuntivo PipeAccessRightsspecificato.

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

Origine:

NamedPipeServerStream.cs

Inizializza una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe, il numero massimo di istanze del server, la modalità di trasmissione e le opzioni di pipe specificati.

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)

Parametri

pipeName

String

Nome della pipe.

direction

PipeDirection

Uno dei valori di enumerazione che determina la direzione della pipe.

maxNumberOfServerInstances

Int32

Numero massimo di istanze del server che condividono lo stesso nome. Per questo valore è possibile passare MaxAllowedServerInstances.

transmissionMode

PipeTransmissionMode

Uno dei valori di enumerazione che determina la modalità di trasmissione della pipe.

options

PipeOptions

Uno dei valori di enumerazione che determina come aprire o creare la pipe.

Eccezioni

ArgumentNullException

pipeName è null.

ArgumentException

pipeName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

-oppure-

direction non è un valore valido di PipeDirection.

-oppure-

maxNumberofServerInstances è minore di -1 o maggiore di 254 (-1 indica MaxAllowedServerInstances)

-oppure-

options non è un valore valido di PipeOptions.

NotSupportedException

pipeName contiene i due punti (":").

IOException

È stato superato il numero massimo di istanze del server.

Commenti

Questo costruttore crea un NamedPipeServerStream oggetto con le caratteristiche seguenti:

• Dimensioni predefinite del buffer di input e output.

• Nessuna sicurezza della pipe.

• Valore HandleInheritability di None.

• Nessun elemento aggiuntivo PipeAccessRightsspecificato.

NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Origine:

NamedPipeServerStream.Unix.cs

Inizializza una nuova istanza della classe NamedPipeServerStream dall'handle di pipe specificato.

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)

Parametri

direction

PipeDirection

Uno dei valori di enumerazione che determina la direzione della pipe.

isAsync

Boolean

true per indicare che l'handle è stato aperto in modo asincrono; in caso contrario, false.

isConnected

Boolean

true per indicare che la pipe è connessa; in caso contrario, false.

safePipeHandle

SafePipeHandle

Handle sicuro per la pipe che verrà incapsulata da questo oggetto NamedPipeServerStream.

Eccezioni

ArgumentOutOfRangeException

direction non è un valore valido di PipeDirection.

ArgumentNullException

safePipeHandle è null.

ArgumentException

safePipeHandle non è un handle valido.

IOException

safePipeHandle non è un handle di pipe valido.

-oppure-

È stato superato il numero massimo di istanze del server.

NamedPipeServerStream(String, PipeDirection, Int32)

Origine:

NamedPipeServerStream.cs

Inizializza una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe e il numero massimo di istanze del server specificati.

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)

Parametri

pipeName

String

Nome della pipe.

direction

PipeDirection

Uno dei valori di enumerazione che determina la direzione della pipe.

maxNumberOfServerInstances

Int32

Numero massimo di istanze del server che condividono lo stesso nome. Per questo valore è possibile passare MaxAllowedServerInstances.

Eccezioni

ArgumentNullException

pipeName è null.

ArgumentException

pipeName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

-oppure-

direction non è un valore valido di PipeDirection.

-oppure-

È richiesto un numero non negativo.

-oppure-

maxNumberofServerInstances è minore di -1 o maggiore di 254 (-1 indica MaxAllowedServerInstances)

-oppure-

È richiesto None o Inheritable.

-oppure-

I diritti di accesso sono limitati ai flag ChangePermissions, TakeOwnership e AccessSystemSecurity.

NotSupportedException

pipeName contiene i due punti (":").

IOException

È stato superato il numero massimo di istanze del server.

Commenti

Questo costruttore crea un NamedPipeServerStream oggetto con le caratteristiche seguenti:

• Valore predefinito 1 per il numero massimo di istanze del server che condividono lo stesso nome.

• Valore predefinito PipeTransmissionMode di Byte.

• Valore PipeOptions di None.

• Dimensioni predefinite del buffer di input e output.

• Nessuna sicurezza della pipe.

• Valore HandleInheritability di None.

• Nessun elemento aggiuntivo PipeAccessRightsspecificato.

NamedPipeServerStream(String, PipeDirection)

Origine:

NamedPipeServerStream.cs

Inizializza una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe specificati.

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)

Parametri

pipeName

String

Nome della pipe.

direction

PipeDirection

Uno dei valori di enumerazione che determina la direzione della pipe.

Eccezioni

ArgumentNullException

pipeName è null.

ArgumentException

pipeName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

-oppure-

direction non è un valore valido di PipeDirection.

NotSupportedException

pipeName contiene i due punti (":").

IOException

È stato superato il numero massimo di istanze del server.

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 NamedPipeServerStream oggetto in un processo padre. L'oggetto NamedPipeServerStream ha un valore di Out, che quindi blocca fino a quando un NamedPipeClientStream oggetto stabilisce una PipeDirection connessione all'oggetto correnteNamedPipeServerStream.

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

Commenti

Questo costruttore crea un NamedPipeServerStream oggetto con le caratteristiche seguenti:

• Valore PipeTransmissionMode di Byte.

• Valore PipeOptions di None.

• Dimensioni predefinite del buffer di input e output.

• Nessuna sicurezza della pipe.

• Valore HandleInheritability di None.

• Nessun elemento aggiuntivo PipeAccessRightsspecificato.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)

Origine:

NamedPipeServerStream.cs

Inizializza una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe, il numero massimo di istanze del server e la modalità di trasmissione specificati.

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)

Parametri

pipeName

String

Nome della pipe.

direction

PipeDirection

Uno dei valori di enumerazione che determina la direzione della pipe.

maxNumberOfServerInstances

Int32

Numero massimo di istanze del server che condividono lo stesso nome. Per questo valore è possibile passare MaxAllowedServerInstances.

transmissionMode

PipeTransmissionMode

Uno dei valori di enumerazione che determina la modalità di trasmissione della pipe.

Eccezioni

ArgumentNullException

pipeName è null.

ArgumentException

pipeName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

-oppure-

direction non è un valore valido di PipeDirection.

-oppure-

maxNumberofServerInstances è minore di -1 o maggiore di 254 (-1 indica MaxAllowedServerInstances)

NotSupportedException

pipeName contiene i due punti (":").

IOException

È stato superato il numero massimo di istanze del server.

Commenti

Questo costruttore crea un NamedPipeServerStream oggetto con le caratteristiche seguenti:

• Valore predefinito PipeOptions di None.

• Dimensioni predefinite del buffer di input e output.

• Nessuna sicurezza della pipe.

• Valore HandleInheritability di None.

• Nessun elemento aggiuntivo PipeAccessRightsspecificato.