Partager via

NamedPipeClientStream Constructeurs

  • Référence

Définition

Espace de noms:
System.IO.Pipes
Assembly:
System.IO.Pipes.dll
Assembly:
System.Core.dll
Assembly:
netstandard.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, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)

Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms de canal et de serveur spécifiés, ainsi que 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, 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
Source:
NamedPipeClientStream.cs
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 :

S’applique à

NamedPipeClientStream(String, String)

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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 :

S’applique à

NamedPipeClientStream(String, String, PipeDirection)

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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 peut être vu 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 :

S’applique à

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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);
[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)

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.

Attributs
SecurityCriticalAttribute

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.

S’applique à

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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 :

S’applique à

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

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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.

S’applique à

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

Initialise une nouvelle instance de la classe NamedPipeClientStream avec les noms de canal et de serveur spécifiés, ainsi que 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::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)

Paramètres

serverName
String

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

pipeName
String

Nom du canal.

desiredAccessRights
PipeAccessRights

L'une des valeurs d'énumération qui spécifie les autorisations d'accès du canal souhaitées.

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.

Attributs
SupportedOSPlatformAttribute

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 -

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.

Remarques

La direction du canal pour ce constructeur est déterminée par le desiredAccessRights paramètre . Si la desiredAccessRights valeur est ReadData, la direction du canal sera In. Si la valeur de desiredAccessRights est WriteData, la direction du canal est Out. Si la valeur de desiredAccessRights inclut à la fois ReadData et WriteData, la direction du canal sera InOut.

S’applique à

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

Source:
NamedPipeClientStream.cs
Source:
NamedPipeClientStream.cs
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.

S’applique à