NamedPipeClientStream Constructeurs

Définition

Espace de noms:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Initialise une nouvelle instance de la classe NamedPipeClientStream.

Surcharges

NamedPipeClientStream(String)	Initialise une nouvelle instance de la classe NamedPipeClientStream à l’aide du nom de canal spécifié.
NamedPipeClientStream(String, String)	Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms de canal et de serveur spécifiés.
NamedPipeClientStream(String, String, PipeDirection)	Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms du canal et du serveur, et le sens du canal spécifiés.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Initialise une nouvelle instance de la classe NamedPipeClientStream pour le handle de canal spécifié avec le sens du canal spécifié.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms de canal et de serveur spécifiés, ainsi que le sens du canal et les options de canal spécifiés.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms de canal et de serveur spécifiés, ainsi que le sens du canal, les options de canal et le niveau de sécurité pour l’emprunt d’identité spécifiés.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms de canal et de serveur spécifiés, ainsi que le sens du canal, les options de canal, le niveau de sécurité pour l’emprunt d’identité et le mode d’héritage spécifiés.

NamedPipeClientStream(String)

Source:

NamedPipeClientStream.cs

Initialise une nouvelle instance de la classe NamedPipeClientStream à l’aide du nom de canal spécifié.

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)

Paramètres

pipeName

String

Nom du canal.

Exceptions

ArgumentNullException

pipeName a la valeur null.

ArgumentException

pipeName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

Remarques

Ce constructeur utilise les valeurs par défaut suivantes :

• Nom de serveur par défaut « ».

• Valeur par défaut PipeDirection de InOut.

• Valeur par défaut PipeOptions de None.

• Valeur par défaut TokenImpersonationLevel de None.

• Valeur par défaut HandleInheritability de None.

NamedPipeClientStream(String, String)

Source:

NamedPipeClientStream.cs

Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms de canal et de serveur spécifiés.

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)

Paramètres

serverName

String

Nom de l'ordinateur distant auquel se connecter ou "." pour indiquer l'ordinateur local.

pipeName

String

Nom du canal.

Exceptions

ArgumentNullException

pipeName ou serverName est null.

ArgumentException

pipeName ou serverName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

Remarques

Ce constructeur utilise les valeurs par défaut suivantes :

• Valeur par défaut PipeDirection de InOut.

• Valeur par défaut PipeOptions de None.

• Valeur par défaut TokenImpersonationLevel de None.

• Valeur par défaut HandleInheritability de None.

NamedPipeClientStream(String, String, PipeDirection)

Source:

NamedPipeClientStream.cs

Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms du canal et du serveur, et le sens du canal spécifiés.

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)

Paramètres

serverName

String

Nom de l'ordinateur distant auquel se connecter ou "." pour indiquer l'ordinateur local.

pipeName

String

Nom du canal.

direction

PipeDirection

L'une des valeurs d'énumération qui détermine le sens du canal.

Exceptions

ArgumentNullException

pipeName ou serverName est null.

ArgumentException

pipeName ou serverName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

- ou -

direction n’est pas une valeur de PipeDirection valide.

Exemples

L’exemple suivant illustre une méthode permettant d’envoyer une chaîne d’un processus parent à un processus enfant à l’aide de canaux nommés. Cet exemple crée un NamedPipeClientStream objet dans un processus enfant, qui se connecte ensuite à un canal sur l’ordinateur local. L’exemple de serveur est visible dans la NamedPipeServerStream classe . Cet exemple fait partie d’un exemple plus grand fourni pour les NamedPipeServerStream classes et 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

Remarques

Ce constructeur utilise les valeurs par défaut suivantes :

• Valeur par défaut PipeOptions de None.

• Valeur par défaut TokenImpersonationLevel de None.

• Valeur par défaut HandleInheritability de None.

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Source:

NamedPipeClientStream.cs

Initialise une nouvelle instance de la classe NamedPipeClientStream pour le handle de canal spécifié avec le sens du canal spécifié.

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)

Paramètres

direction

PipeDirection

L'une des valeurs d'énumération qui détermine le sens du canal.

isAsync

Boolean

true pour indiquer que le handle a été ouvert de façon asynchrone ; sinon, false.

isConnected

Boolean

true pour indiquer que le canal est connecté ; sinon, false.

safePipeHandle

SafePipeHandle

Handle sécurisé pour le canal que cet objet NamedPipeClientStream doit encapsuler.

Exceptions

IOException

Le flux a été fermé.

ArgumentException

safePipeHandle n’est pas un handle valide.

ArgumentNullException

safePipeHandle a la valeur null.

ArgumentOutOfRangeException

direction n’est pas une valeur de PipeDirection valide.

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Source:

NamedPipeClientStream.cs

Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms de canal et de serveur spécifiés, ainsi que le sens du canal et les options de canal spécifiés.

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)

Paramètres

serverName

String

Nom de l'ordinateur distant auquel se connecter ou "." pour indiquer l'ordinateur local.

pipeName

String

Nom du canal.

direction

PipeDirection

L'une des valeurs d'énumération qui détermine le sens du canal.

options

PipeOptions

L'une des valeurs d'énumération déterminant le mode d'ouverture ou de création du canal.

Exceptions

ArgumentNullException

pipeName ou serverName est null.

ArgumentException

pipeName ou serverName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

- ou -

direction n’est pas une valeur de PipeDirection valide.

- ou -

options n’est pas une valeur de PipeOptions valide.

Remarques

Ce constructeur utilise les valeurs par défaut suivantes :

• Valeur par défaut TokenImpersonationLevel de None.

• Valeur par défaut HandleInheritability de None.

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

Source:

NamedPipeClientStream.cs

Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms de canal et de serveur spécifiés, ainsi que le sens du canal, les options de canal et le niveau de sécurité pour l’emprunt d’identité spécifiés.

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)

Paramètres

serverName

String

Nom de l'ordinateur distant auquel se connecter ou "." pour indiquer l'ordinateur local.

pipeName

String

Nom du canal.

direction

PipeDirection

L'une des valeurs d'énumération qui détermine le sens du canal.

options

PipeOptions

L'une des valeurs d'énumération déterminant le mode d'ouverture ou de création du canal.

impersonationLevel

TokenImpersonationLevel

Une des valeurs d'énumération qui détermine le niveau de sécurité pour l'emprunt d'identité.

Exceptions

ArgumentNullException

pipeName ou serverName est null.

ArgumentException

pipeName ou serverName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

- ou -

direction n’est pas une valeur de PipeDirection valide.

- ou -

options n’est pas une valeur de PipeOptions valide.

- ou -

impersonationLevel n’est pas une valeur de TokenImpersonationLevel valide.

Remarques

Ce constructeur utilise une valeur par défaut HandleInheritability de None.

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

Source:

NamedPipeClientStream.cs

Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms de canal et de serveur spécifiés, ainsi que le sens du canal, les options de canal, le niveau de sécurité pour l’emprunt d’identité et le mode d’héritage spécifiés.

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)

Paramètres

serverName

String

Nom de l'ordinateur distant auquel se connecter ou "." pour indiquer l'ordinateur local.

pipeName

String

Nom du canal.

direction

PipeDirection

L'une des valeurs d'énumération qui détermine le sens du canal.

options

PipeOptions

L'une des valeurs d'énumération déterminant le mode d'ouverture ou de création du canal.

impersonationLevel

TokenImpersonationLevel

Une des valeurs d'énumération qui détermine le niveau de sécurité pour l'emprunt d'identité.

inheritability

HandleInheritability

L'une des valeurs d'énumération qui détermine si des processus enfant peuvent hériter du handle sous-jacent.

Exceptions

ArgumentNullException

pipeName ou serverName est null.

ArgumentException

pipeName ou serverName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

- ou -

direction n’est pas une valeur de PipeDirection valide.

- ou -

options n’est pas une valeur de PipeOptions valide.

- ou -

impersonationLevel n’est pas une valeur de TokenImpersonationLevel valide.

- ou -

inheritability n’est pas une valeur de HandleInheritability valide.