NamedPipeClientStream Costruttori

Definizione

Spazio dei nomi:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Inizializza una nuova istanza della classe NamedPipeClientStream.

Overload

NamedPipeClientStream(String)	Inizializza una nuova istanza della classe NamedPipeClientStream con il nome di pipe specificato.
NamedPipeClientStream(String, String)	Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati.
NamedPipeClientStream(String, String, PipeDirection)	Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati e la direzione della pipe indicata.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Inizializza una nuova istanza della classe NamedPipeClientStream per l'handle di pipe specificato con la direzione della pipe indicata.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati nonché la direzione e le opzioni della pipe indicate.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati nonché la direzione e le opzioni della pipe e il livello di rappresentazione di sicurezza indicati.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati nonché la direzione e le opzioni della pipe, il livello di rappresentazione di sicurezza e la modalità di ereditarietà indicati.

NamedPipeClientStream(String)

Origine:

NamedPipeClientStream.cs

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

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

public NamedPipeClientStream (string pipeName);

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

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".

Commenti

Questo costruttore usa i valori predefiniti seguenti:

• Nome del server predefinito ".".

• Valore predefinito PipeDirection di InOut.

• Valore predefinito PipeOptions di None.

• Valore predefinito TokenImpersonationLevel di None.

• Valore predefinito HandleInheritability di None.

NamedPipeClientStream(String, String)

Origine:

NamedPipeClientStream.cs

Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati.

public:
 NamedPipeClientStream(System::String ^ serverName, System::String ^ pipeName);

public NamedPipeClientStream (string serverName, string pipeName);

new System.IO.Pipes.NamedPipeClientStream : string * string -> System.IO.Pipes.NamedPipeClientStream

Public Sub New (serverName As String, pipeName As String)

Parametri

serverName

String

Nome del computer remoto a cui connettersi oppure "." per specificare il computer locale.

pipeName

String

Nome della pipe.

Eccezioni

ArgumentNullException

pipeName o serverName è null.

ArgumentException

pipeName oppure serverName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

Commenti

Questo costruttore usa i valori predefiniti seguenti:

• Valore predefinito PipeDirection di InOut.

• Valore predefinito PipeOptions di None.

• Valore predefinito TokenImpersonationLevel di None.

• Valore predefinito HandleInheritability di None.

NamedPipeClientStream(String, String, PipeDirection)

Origine:

NamedPipeClientStream.cs

Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati e la direzione della pipe indicata.

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

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

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

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

Parametri

serverName

String

Nome del computer remoto a cui connettersi oppure "." per specificare il computer locale.

pipeName

String

Nome della pipe.

direction

PipeDirection

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

Eccezioni

ArgumentNullException

pipeName o serverName è null.

ArgumentException

pipeName oppure serverName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

-oppure-

direction non è un valore valido di PipeDirection.

Esempio

Nell'esempio seguente viene illustrato un metodo per inviare una stringa da un processo padre a un processo figlio tramite named pipe. In questo esempio viene creato un NamedPipeClientStream oggetto in un processo figlio, che quindi si connette a una pipe nel computer locale. L'esempio del server può essere visualizzato nella NamedPipeServerStream classe . Questo esempio fa parte di un esempio più ampio fornito per le NamedPipeServerStream classi 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

Commenti

Questo costruttore usa i valori predefiniti seguenti:

• Valore predefinito PipeOptions di None.

• Valore predefinito TokenImpersonationLevel di None.

• Valore predefinito HandleInheritability di None.

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Origine:

NamedPipeClientStream.cs

Inizializza una nuova istanza della classe NamedPipeClientStream per l'handle di pipe specificato con la direzione della pipe indicata.

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

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

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

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 NamedPipeClientStream.

Eccezioni

IOException

Il flusso è stato chiuso.

ArgumentException

safePipeHandle non è un handle valido.

ArgumentNullException

safePipeHandle è null.

ArgumentOutOfRangeException

direction non è un valore valido di PipeDirection.

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Origine:

NamedPipeClientStream.cs

Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati nonché la direzione e le opzioni della pipe indicate.

public:
 NamedPipeClientStream(System::String ^ serverName, System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, System::IO::Pipes::PipeOptions options);

public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeDirection direction, System.IO.Pipes.PipeOptions options);

new System.IO.Pipes.NamedPipeClientStream : string * string * System.IO.Pipes.PipeDirection * System.IO.Pipes.PipeOptions -> System.IO.Pipes.NamedPipeClientStream

Public Sub New (serverName As String, pipeName As String, direction As PipeDirection, options As PipeOptions)

Parametri

serverName

String

Nome del computer remoto a cui connettersi oppure "." per specificare il computer locale.

pipeName

String

Nome della pipe.

direction

PipeDirection

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

options

PipeOptions

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

Eccezioni

ArgumentNullException

pipeName o serverName è null.

ArgumentException

pipeName oppure serverName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

-oppure-

direction non è un valore valido di PipeDirection.

-oppure-

options non è un valore valido di PipeOptions.

Commenti

Questo costruttore usa i valori predefiniti seguenti:

• Valore predefinito TokenImpersonationLevel di None.

• Valore predefinito HandleInheritability di None.

NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)

Origine:

NamedPipeClientStream.cs

Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati nonché la direzione e le opzioni della pipe e il livello di rappresentazione di sicurezza indicati.

public:
 NamedPipeClientStream(System::String ^ serverName, System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, System::IO::Pipes::PipeOptions options, System::Security::Principal::TokenImpersonationLevel impersonationLevel);

public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeDirection direction, System.IO.Pipes.PipeOptions options, System.Security.Principal.TokenImpersonationLevel impersonationLevel);

new System.IO.Pipes.NamedPipeClientStream : string * string * System.IO.Pipes.PipeDirection * System.IO.Pipes.PipeOptions * System.Security.Principal.TokenImpersonationLevel -> System.IO.Pipes.NamedPipeClientStream

Public Sub New (serverName As String, pipeName As String, direction As PipeDirection, options As PipeOptions, impersonationLevel As TokenImpersonationLevel)

Parametri

serverName

String

Nome del computer remoto a cui connettersi oppure "." per specificare il computer locale.

pipeName

String

Nome della pipe.

direction

PipeDirection

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

options

PipeOptions

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

impersonationLevel

TokenImpersonationLevel

Uno dei valori di enumerazione che determina il livello di rappresentazione di sicurezza.

Eccezioni

ArgumentNullException

pipeName o serverName è null.

ArgumentException

pipeName oppure serverName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

-oppure-

direction non è un valore valido di PipeDirection.

-oppure-

options non è un valore valido di PipeOptions.

-oppure-

impersonationLevel non è un valore valido di TokenImpersonationLevel.

Commenti

Questo costruttore usa un valore predefinito HandleInheritability di None.

NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)

Origine:

NamedPipeClientStream.cs

Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati nonché la direzione e le opzioni della pipe, il livello di rappresentazione di sicurezza e la modalità di ereditarietà indicati.

public:
 NamedPipeClientStream(System::String ^ serverName, System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, System::IO::Pipes::PipeOptions options, System::Security::Principal::TokenImpersonationLevel impersonationLevel, System::IO::HandleInheritability inheritability);

public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeDirection direction, System.IO.Pipes.PipeOptions options, System.Security.Principal.TokenImpersonationLevel impersonationLevel, System.IO.HandleInheritability inheritability);

new System.IO.Pipes.NamedPipeClientStream : string * string * System.IO.Pipes.PipeDirection * System.IO.Pipes.PipeOptions * System.Security.Principal.TokenImpersonationLevel * System.IO.HandleInheritability -> System.IO.Pipes.NamedPipeClientStream

Public Sub New (serverName As String, pipeName As String, direction As PipeDirection, options As PipeOptions, impersonationLevel As TokenImpersonationLevel, inheritability As HandleInheritability)

Parametri

serverName

String

Nome del computer remoto a cui connettersi oppure "." per specificare il computer locale.

pipeName

String

Nome della pipe.

direction

PipeDirection

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

options

PipeOptions

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

impersonationLevel

TokenImpersonationLevel

Uno dei valori di enumerazione che determina il livello di rappresentazione di sicurezza.

inheritability

HandleInheritability

Uno dei valori di enumerazione che determina se l'handle sottostante sarà ereditabile dai processi figlio.

Eccezioni

ArgumentNullException

pipeName o serverName è null.

ArgumentException

pipeName oppure serverName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

-oppure-

direction non è un valore valido di PipeDirection.

-oppure-

options non è un valore valido di PipeOptions.

-oppure-

impersonationLevel non è un valore valido di TokenImpersonationLevel.

-oppure-

inheritability non è un valore valido di HandleInheritability.