Condividi tramite


NamedPipeClientStream Costruttori

Definizione

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

pipeName è null.

pipeName è una stringa di lunghezza zero.

pipeName è impostato su "anonymous".

Commenti

Questo costruttore usa i valori predefiniti seguenti:

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

pipeName o serverName è null.

pipeName oppure serverName è una stringa di lunghezza zero.

pipeName è impostato su "anonymous".

Commenti

Questo costruttore usa i valori predefiniti seguenti:

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

pipeName o serverName è null.

pipeName oppure serverName è una stringa di lunghezza zero.

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:

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

Eccezioni

Il flusso è stato chiuso.

safePipeHandle non è un handle valido.

safePipeHandle è null.

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

pipeName o serverName è null.

pipeName oppure serverName è una stringa di lunghezza zero.

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:

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

pipeName o serverName è null.

pipeName oppure serverName è una stringa di lunghezza zero.

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

Eccezioni

pipeName o serverName è null.

pipeName oppure serverName è una stringa di lunghezza zero.

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 WriteDataReadData , 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

pipeName o serverName è null.

pipeName oppure serverName è una stringa di lunghezza zero.

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