NamedPipeClientStream Costruttori

Riferimento

Definizione

Spazio dei nomi:: System.IO.Pipes

Assembly:: System.IO.Pipes.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Inizializza una nuova istanza della classe NamedPipeClientStream con i nomi della pipe e del server specificati e le opzioni di pipe, il livello di rappresentazione di sicurezza e la modalità di ereditarietà 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

Origine:: NamedPipeClientStream.cs

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.

Si applica a

NamedPipeClientStream(String, String)

Origine:: NamedPipeClientStream.cs

Origine:: NamedPipeClientStream.cs

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.

Si applica a

NamedPipeClientStream(String, String, PipeDirection)

Origine:: NamedPipeClientStream.cs

Origine:: NamedPipeClientStream.cs

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.

Si applica a

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Origine:: NamedPipeClientStream.cs

Origine:: NamedPipeClientStream.cs

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);

[System.Security.SecurityCritical]
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

[<System.Security.SecurityCritical>]
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.

Attributi: SecurityCriticalAttribute

Eccezioni

IOException

Il flusso è stato chiuso.

ArgumentException

safePipeHandle non è un handle valido.

ArgumentNullException

safePipeHandle è null.

ArgumentOutOfRangeException

direction non è un valore valido di PipeDirection.

Si applica a

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Origine:: NamedPipeClientStream.cs

Origine:: NamedPipeClientStream.cs

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.

Si applica a

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

Origine:: NamedPipeClientStream.cs

Origine:: NamedPipeClientStream.cs

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.

Si applica a

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

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

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeAccessRights desiredAccessRights, System.IO.Pipes.PipeOptions options, System.Security.Principal.TokenImpersonationLevel impersonationLevel, System.IO.HandleInheritability inheritability);

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

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
new System.IO.Pipes.NamedPipeClientStream : string * string * System.IO.Pipes.PipeAccessRights * System.IO.Pipes.PipeOptions * System.Security.Principal.TokenImpersonationLevel * System.IO.HandleInheritability -> System.IO.Pipes.NamedPipeClientStream

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

Public Sub New (serverName As String, pipeName As String, desiredAccessRights As PipeAccessRights, 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.

desiredAccessRights: PipeAccessRights

Uno dei valori di enumerazione che specifica le autorizzazioni di accesso della pipe desiderate.

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.

Attributi: SupportedOSPlatformAttribute

Eccezioni

ArgumentNullException

pipeName o serverName è null.

ArgumentException

pipeName oppure serverName è una stringa di lunghezza zero.

ArgumentOutOfRangeException

pipeName è impostato su "anonymous".

-oppure-

options non è un valore valido di PipeOptions.

-oppure-

impersonationLevel non è un valore valido di TokenImpersonationLevel.

-oppure-

inheritability non è un valore valido di HandleInheritability.

Commenti

La direzione della pipe per questo costruttore è determinata dal desiredAccessRights parametro . Se il desiredAccessRights valore è ReadData, la direzione della pipe sarà In. Se il valore di desiredAccessRights è WriteData, la direzione della pipe sarà Out. Se il valore di desiredAccessRights include sia che WriteData ReadData , la direzione della pipe sarà InOut.

Si applica a

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

Origine:: NamedPipeClientStream.cs

Origine:: NamedPipeClientStream.cs

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.

Si applica a

Condividi tramite

NamedPipeClientStream Costruttori

Definizione

Overload

NamedPipeClientStream(String)

Parametri

Eccezioni

Commenti

Si applica a

NamedPipeClientStream(String, String)

Parametri

Eccezioni

Commenti

Si applica a

NamedPipeClientStream(String, String, PipeDirection)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Parametri

Eccezioni

Si applica a

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Parametri

Eccezioni

Commenti

Si applica a

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

Parametri

Eccezioni

Commenti

Si applica a

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

Parametri

Eccezioni

Commenti

Si applica a

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

Parametri

Eccezioni

Si applica a

Risorse aggiuntive