NamedPipeServerStream Constructeurs

Définition

Espace de noms:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Initialise une nouvelle instance de la classe NamedPipeServerStream.

Surcharges

NamedPipeServerStream(String)	Initialise une nouvelle instance de la classe NamedPipeServerStream à l’aide du nom de canal spécifié.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)	Initialise une nouvelle instance de la classe NamedPipeServerStream avec le nom du canal, le sens du canal, le nombre maximal d’instances de serveur, le mode de transmission et les options du canal spécifiés, ainsi que les tailles des mémoires tampon entrée et sortie recommandées.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)	Initialise une nouvelle instance de la classe NamedPipeServerStream avec le nom du canal, le sens du canal, le nombre maximal d’instances de serveur, le mode de transmission et les options du canal spécifiés.
NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Initialise une nouvelle instance de la classe NamedPipeServerStream à partir du handle de canal spécifié.
NamedPipeServerStream(String, PipeDirection, Int32)	Initialise une nouvelle instance de la classe NamedPipeServerStream avec le nom du canal, le sens du canal et le nombre maximal d'instances de serveur spécifiés.
NamedPipeServerStream(String, PipeDirection)	Initialise une nouvelle instance de la classe NamedPipeServerStream avec le nom et le sens du canal spécifiés.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)	Initialise une nouvelle instance de la classe NamedPipeServerStream avec le nom du canal, le sens du canal, le nombre maximal d’instances de serveur et le mode de transmission spécifiés.

NamedPipeServerStream(String)

Source:

NamedPipeServerStream.cs

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

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

public NamedPipeServerStream (string pipeName);

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

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

NotSupportedException

pipeName contient un signe deux-points (« : »).

IOException

Le nombre maximal d’instances de serveur est dépassé.

Remarques

Ce constructeur crée un NamedPipeServerStream objet qui a les caractéristiques suivantes :

• Direction de canal par défaut de InOut.

• Nombre maximal d’instances de serveur partageant le même nom défini sur 1.

• Valeur PipeTransmissionMode de Byte.

• Valeur PipeOptions de None.

• Tailles de mémoire tampon d’entrée et de sortie par défaut.

• Aucune sécurité de canal.

• Valeur HandleInheritability de None.

• Aucun élément supplémentaire PipeAccessRightsspécifié.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)

Source:

NamedPipeServerStream.cs

Initialise une nouvelle instance de la classe NamedPipeServerStream avec le nom du canal, le sens du canal, le nombre maximal d’instances de serveur, le mode de transmission et les options du canal spécifiés, ainsi que les tailles des mémoires tampon entrée et sortie recommandées.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode, System::IO::Pipes::PipeOptions options, int inBufferSize, int outBufferSize);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options, int inBufferSize, int outBufferSize);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions * int * int -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions, inBufferSize As Integer, outBufferSize As Integer)

Paramètres

pipeName

String

Nom du canal.

direction

PipeDirection

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

maxNumberOfServerInstances

Int32

Nombre maximal d'instances de serveur partageant le même nom. Vous pouvez passer MaxAllowedServerInstances pour cette valeur.

transmissionMode

PipeTransmissionMode

L'une des valeurs d'énumération déterminant le mode de transmission du canal.

options

PipeOptions

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

inBufferSize

Int32

Valeur positive supérieure à 0 qui indique la taille de la mémoire tampon d'entrée.

outBufferSize

Int32

Valeur positive supérieure à 0 qui indique la taille de la mémoire tampon de sortie.

Exceptions

ArgumentNullException

pipeName a la valeur null.

ArgumentException

pipeName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

- ou -

direction n’est pas une valeur de PipeDirection valide.

- ou -

maxNumberofServerInstances est inférieur à 1 ou supérieur à 254 (-1 indique MaxAllowedServerInstances)

- ou -

options n’est pas une valeur de PipeOptions valide.

- ou -

inBufferSize est un nombre négatif.

NotSupportedException

pipeName contient un signe deux-points (« : »).

IOException

Le nombre maximal d’instances de serveur est dépassé.

Remarques

Ce constructeur crée un NamedPipeServerStream objet qui a les caractéristiques suivantes :

• Aucune sécurité de canal supplémentaire.

• Valeur par défaut HandleInheritability .None

• Aucun élément supplémentaire PipeAccessRightsspécifié.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)

Source:

NamedPipeServerStream.cs

Initialise une nouvelle instance de la classe NamedPipeServerStream avec le nom du canal, le sens du canal, le nombre maximal d’instances de serveur, le mode de transmission et les options du canal spécifiés.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode, System::IO::Pipes::PipeOptions options);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions)

Paramètres

pipeName

String

Nom du canal.

direction

PipeDirection

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

maxNumberOfServerInstances

Int32

Nombre maximal d'instances de serveur partageant le même nom. Vous pouvez passer MaxAllowedServerInstances pour cette valeur.

transmissionMode

PipeTransmissionMode

L'une des valeurs d'énumération déterminant le mode de transmission 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 a la valeur null.

ArgumentException

pipeName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

- ou -

direction n’est pas une valeur de PipeDirection valide.

- ou -

maxNumberofServerInstances est inférieur à 1 ou supérieur à 254 (-1 indique MaxAllowedServerInstances)

- ou -

options n’est pas une valeur de PipeOptions valide.

NotSupportedException

pipeName contient un signe deux-points (« : »).

IOException

Le nombre maximal d’instances de serveur est dépassé.

Remarques

Ce constructeur crée un NamedPipeServerStream objet qui a les caractéristiques suivantes :

• Tailles de mémoire tampon d’entrée et de sortie par défaut.

• Aucune sécurité de canal.

• Valeur HandleInheritability de None.

• Aucun élément supplémentaire PipeAccessRightsspécifié.

NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Source:

NamedPipeServerStream.Unix.cs

Initialise une nouvelle instance de la classe NamedPipeServerStream à partir du handle de canal spécifié.

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

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

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

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 NamedPipeServerStream doit encapsuler.

Exceptions

ArgumentOutOfRangeException

direction n’est pas une valeur de PipeDirection valide.

ArgumentNullException

safePipeHandle a la valeur null.

ArgumentException

safePipeHandle est un handle non valide.

IOException

safePipeHandle n’est pas un handle de canal valide.

- ou -

Le nombre maximal d’instances de serveur est dépassé.

NamedPipeServerStream(String, PipeDirection, Int32)

Source:

NamedPipeServerStream.cs

Initialise une nouvelle instance de la classe NamedPipeServerStream avec le nom du canal, le sens du canal et le nombre maximal d'instances de serveur spécifiés.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer)

Paramètres

pipeName

String

Nom du canal.

direction

PipeDirection

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

maxNumberOfServerInstances

Int32

Nombre maximal d'instances de serveur partageant le même nom. Vous pouvez passer MaxAllowedServerInstances pour cette valeur.

Exceptions

ArgumentNullException

pipeName a la valeur null.

ArgumentException

pipeName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

- ou -

direction n’est pas une valeur de PipeDirection valide.

- ou -

Un nombre non négatif est nécessaire.

- ou -

maxNumberofServerInstances est inférieur à 1 ou supérieur à 254 (-1 indique MaxAllowedServerInstances)

- ou -

None ou Inheritable est nécessaire.

- ou -

Les droits d’accès sont limités à ChangePermissions, à TakeOwnership et aux indicateurs AccessSystemSecurity.

NotSupportedException

pipeName contient un signe deux-points (« : »).

IOException

Le nombre maximal d’instances de serveur est dépassé.

Remarques

Ce constructeur crée un NamedPipeServerStream objet qui a les caractéristiques suivantes :

• Valeur par défaut de 1 pour le nombre maximal d’instances de serveur qui partagent le même nom.

• Valeur par défaut PipeTransmissionMode de Byte.

• Valeur PipeOptions de None.

• Tailles de mémoire tampon d’entrée et de sortie par défaut.

• Aucune sécurité de canal.

• Valeur HandleInheritability de None.

• Aucun élément supplémentaire PipeAccessRightsspécifié.

NamedPipeServerStream(String, PipeDirection)

Source:

NamedPipeServerStream.cs

Initialise une nouvelle instance de la classe NamedPipeServerStream avec le nom et le sens du canal spécifiés.

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

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

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

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

Paramètres

pipeName

String

Nom du canal.

direction

PipeDirection

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

Exceptions

ArgumentNullException

pipeName a la valeur null.

ArgumentException

pipeName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

- ou -

direction n’est pas une valeur de PipeDirection valide.

NotSupportedException

pipeName contient un signe deux-points (« : »).

IOException

Le nombre maximal d’instances de serveur est dépassé.

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 NamedPipeServerStream objet dans un processus parent. L’objet a une PipeDirection valeur de Out, qui se bloque ensuite jusqu’à ce qu’un NamedPipeClientStream objet établisse une connexion à l’objet actuelNamedPipeServerStream.NamedPipeServerStream

using System;
using System.IO;
using System.IO.Pipes;

class PipeServer
{
    static void Main()
    {
        using (NamedPipeServerStream pipeServer =
            new NamedPipeServerStream("testpipe", PipeDirection.Out))
        {
            Console.WriteLine("NamedPipeServerStream object created.");

            // Wait for a client to connect
            Console.Write("Waiting for client connection...");
            pipeServer.WaitForConnection();

            Console.WriteLine("Client connected.");
            try
            {
                // Read user input and send that to the client process.
                using (StreamWriter sw = new StreamWriter(pipeServer))
                {
                    sw.AutoFlush = true;
                    Console.Write("Enter text: ");
                    sw.WriteLine(Console.ReadLine());
                }
            }
            // Catch the IOException that is raised if the pipe is broken
            // or disconnected.
            catch (IOException e)
            {
                Console.WriteLine("ERROR: {0}", e.Message);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Pipes

Class PipeServer

    Shared Sub Main()
        Dim pipeServer As New NamedPipeServerStream("testpipe", PipeDirection.Out)

        Console.WriteLine("NamedPipeServerStream object created.")

        ' Wait for a client to connect
        Console.Write("Waiting for a client connection...")
        pipeServer.WaitForConnection()

        Console.WriteLine("Client connected.")
        Try
            'Read user input and send that to the client process.
            Dim sw As New StreamWriter(pipeServer)
            sw.AutoFlush = True
            Console.Write("Enter Text: ")
            sw.WriteLine(Console.ReadLine())
        Catch ex As IOException
            ' Catch the IOException that is raised if the pipe is broken
            ' or disconnected
            Console.WriteLine("ERROR: {0}", ex.Message)
        End Try
    End Sub
End Class

Remarques

Ce constructeur crée un NamedPipeServerStream objet qui a les caractéristiques suivantes :

• Valeur PipeTransmissionMode de Byte.

• Valeur PipeOptions de None.

• Tailles de mémoire tampon d’entrée et de sortie par défaut.

• Aucune sécurité de canal.

• Valeur HandleInheritability de None.

• Aucun élément supplémentaire PipeAccessRightsspécifié.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)

Source:

NamedPipeServerStream.cs

Initialise une nouvelle instance de la classe NamedPipeServerStream avec le nom du canal, le sens du canal, le nombre maximal d’instances de serveur et le mode de transmission spécifiés.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode)

Paramètres

pipeName

String

Nom du canal.

direction

PipeDirection

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

maxNumberOfServerInstances

Int32

Nombre maximal d'instances de serveur partageant le même nom. Vous pouvez passer MaxAllowedServerInstances pour cette valeur.

transmissionMode

PipeTransmissionMode

L'une des valeurs d'énumération déterminant le mode de transmission du canal.

Exceptions

ArgumentNullException

pipeName a la valeur null.

ArgumentException

pipeName est une chaîne de longueur nulle.

ArgumentOutOfRangeException

pipeName a la valeur « anonyme ».

- ou -

direction n’est pas une valeur de PipeDirection valide.

- ou -

maxNumberofServerInstances est inférieur à 1 ou supérieur à 254 (-1 indique MaxAllowedServerInstances)

NotSupportedException

pipeName contient un signe deux-points (« : »).

IOException

Le nombre maximal d’instances de serveur est dépassé.

Remarques

Ce constructeur crée un NamedPipeServerStream objet qui a les caractéristiques suivantes :

• Valeur par défaut PipeOptions de None.

• Tailles de mémoire tampon d’entrée et de sortie par défaut.

• Aucune sécurité de canal.

• Valeur HandleInheritability de None.

• Aucun élément supplémentaire PipeAccessRightsspécifié.