NamedPipeServerStream Konstruktoren

Definition

Namespace:

System.IO.Pipes

Assembly:

System.IO.Pipes.dll

Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse.

Überlädt

NamedPipeServerStream(String)	Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)	Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen, der angegebenen Piperichtung, der angegebenen maximalen Anzahl von Serverinstanzen, dem angegebenen Übertragungsmodus, den angegebenen Pipeoptionen und der empfohlenen Größe für Eingabe- und Ausgabepuffer.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)	Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen, der angegebenen Piperichtung, der angegebenen maximalen Anzahl von Serverinstanzen, dem angegebenen Übertragungsmodus und den angegebenen Pipeoptionen.
NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse aus dem angegebenen Pipehandle.
NamedPipeServerStream(String, PipeDirection, Int32)	Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen, der angegebenen Piperichtung und der angegebenen maximalen Anzahl von Serverinstanzen.
NamedPipeServerStream(String, PipeDirection)	Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit den angegebenen Werten für Pipename und Piperichtung.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)	Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen, der angegebenen Piperichtung, der angegebenen maximalen Anzahl von Serverinstanzen und dem angegebenen Übertragungsmodus.

NamedPipeServerStream(String)

Quelle:

NamedPipeServerStream.cs

Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen.

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)

Parameter

pipeName

String

Der Name der Pipe.

Ausnahmen

ArgumentNullException

pipeName ist null.

ArgumentException

pipeName ist eine Zeichenfolge der Länge 0 (null).

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

NotSupportedException

pipeName enthält einen Doppelpunkt (:).

IOException

Die maximale Anzahl von Serverinstanzen wurde überschritten.

Hinweise

Dieser Konstruktor erstellt ein NamedPipeServerStream -Objekt mit den folgenden Merkmalen:

• Eine Standardpiperichtung von InOut.

• Die maximale Anzahl von Serverinstanzen mit demselben Namen ist auf 1 festgelegt.

• Der PipeTransmissionMode-Wert Byte.

• Der PipeOptions-Wert None.

• Standardgrößen für Eingabe- und Ausgabepuffer.

• Keine Pipesicherheit.

• Der HandleInheritability-Wert None.

• Kein angegebener zusätzlicher PipeAccessRights.

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

Quelle:

NamedPipeServerStream.cs

Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen, der angegebenen Piperichtung, der angegebenen maximalen Anzahl von Serverinstanzen, dem angegebenen Übertragungsmodus, den angegebenen Pipeoptionen und der empfohlenen Größe für Eingabe- und Ausgabepuffer.

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)

Parameter

pipeName

String

Der Name der Pipe.

direction

PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

maxNumberOfServerInstances

Int32

Die maximale Anzahl von Serverinstanzen mit dem gleichen Namen. Für diesen Wert kann MaxAllowedServerInstances übergeben werden.

transmissionMode

PipeTransmissionMode

Einer der Enumerationswerte, der den Übertragungsmodus der Pipe bestimmt.

options

PipeOptions

Einer der Enumerationswerte, der bestimmt, wie die Pipe geöffnet oder erstellt wird.

inBufferSize

Int32

Ein positiver Wert größer als 0, der die Eingabepuffergröße angibt.

outBufferSize

Int32

Ein positiver Wert größer als 0, der die Ausgabepuffergröße angibt.

Ausnahmen

ArgumentNullException

pipeName ist null.

ArgumentException

pipeName ist eine Zeichenfolge der Länge 0 (null).

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

- oder -

direction ist kein gültiger PipeDirection -Wert.

- oder -

maxNumberofServerInstances ist kleiner als -1 oder größer als 254 (-1 gibt MaxAllowedServerInstances an).

- oder -

options ist kein gültiger PipeOptions -Wert.

- oder -

inBufferSize ist ein negativer Wert.

NotSupportedException

pipeName enthält einen Doppelpunkt (:).

IOException

Die maximale Anzahl von Serverinstanzen wurde überschritten.

Hinweise

Dieser Konstruktor erstellt ein NamedPipeServerStream Objekt mit den folgenden Merkmalen:

• Keine zusätzliche Pipesicherheit.

• Der Standardwert HandleInheritability ist None.

• Kein zusätzliches PipeAccessRightsangegeben.

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

Quelle:

NamedPipeServerStream.cs

Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen, der angegebenen Piperichtung, der angegebenen maximalen Anzahl von Serverinstanzen, dem angegebenen Übertragungsmodus und den angegebenen Pipeoptionen.

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)

Parameter

pipeName

String

Der Name der Pipe.

direction

PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

maxNumberOfServerInstances

Int32

Die maximale Anzahl von Serverinstanzen mit dem gleichen Namen. Für diesen Wert kann MaxAllowedServerInstances übergeben werden.

transmissionMode

PipeTransmissionMode

Einer der Enumerationswerte, der den Übertragungsmodus der Pipe bestimmt.

options

PipeOptions

Einer der Enumerationswerte, der bestimmt, wie die Pipe geöffnet oder erstellt wird.

Ausnahmen

ArgumentNullException

pipeName ist null.

ArgumentException

pipeName ist eine Zeichenfolge der Länge 0 (null).

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

- oder -

direction ist kein gültiger PipeDirection -Wert.

- oder -

maxNumberofServerInstances ist kleiner als -1 oder größer als 254 (-1 gibt MaxAllowedServerInstances an).

- oder -

options ist kein gültiger PipeOptions -Wert.

NotSupportedException

pipeName enthält einen Doppelpunkt (:).

IOException

Die maximale Anzahl von Serverinstanzen wurde überschritten.

Hinweise

Dieser Konstruktor erstellt ein NamedPipeServerStream Objekt mit den folgenden Merkmalen:

• Standardgrößen des Eingabe- und Ausgabepuffers.

• Keine Pipesicherheit.

• Der HandleInheritability-Wert None.

• Kein zusätzliches PipeAccessRightsangegeben.

NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Quelle:

NamedPipeServerStream.Unix.cs

Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse aus dem angegebenen Pipehandle.

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)

Parameter

direction

PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

isAsync

Boolean

true, um anzugeben, dass das Handle asynchron geöffnet wurde, andernfalls false.

isConnected

Boolean

true, um anzugeben, dass die Pipe verbunden ist, andernfalls false.

safePipeHandle

SafePipeHandle

Ein sicheres Handle für die Pipe, die von diesem NamedPipeServerStream-Objekt gekapselt wird.

Ausnahmen

ArgumentOutOfRangeException

direction ist kein gültiger PipeDirection-Wert.

ArgumentNullException

safePipeHandle ist null.

ArgumentException

safePipeHandle ist ein ungültiges Handle.

IOException

safePipeHandle ist kein gültiges Pipehandle.

- oder -

Die maximale Anzahl von Serverinstanzen wurde überschritten.

NamedPipeServerStream(String, PipeDirection, Int32)

Quelle:

NamedPipeServerStream.cs

Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen, der angegebenen Piperichtung und der angegebenen maximalen Anzahl von Serverinstanzen.

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)

Parameter

pipeName

String

Der Name der Pipe.

direction

PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

maxNumberOfServerInstances

Int32

Die maximale Anzahl von Serverinstanzen mit dem gleichen Namen. Für diesen Wert kann MaxAllowedServerInstances übergeben werden.

Ausnahmen

ArgumentNullException

pipeName ist null.

ArgumentException

pipeName ist eine Zeichenfolge der Länge 0 (null).

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

- oder -

direction ist kein gültiger PipeDirection -Wert.

- oder -

Es ist eine nicht negative Zahl erforderlich.

- oder -

maxNumberofServerInstances ist kleiner als -1 oder größer als 254 (-1 gibt MaxAllowedServerInstances an).

- oder -

None oder Inheritable ist erforderlich.

- oder -

Zugriffsrechte sind auf die Flags ChangePermissions, TakeOwnership und AccessSystemSecurity beschränkt.

NotSupportedException

pipeName enthält einen Doppelpunkt (:).

IOException

Die maximale Anzahl von Serverinstanzen wurde überschritten.

Hinweise

Dieser Konstruktor erstellt ein NamedPipeServerStream -Objekt mit den folgenden Merkmalen:

• Der Standardwert 1 für die maximale Anzahl von Serverinstanzen, die denselben Namen verwenden.

• Ein Standardwert PipeTransmissionMode von Byte.

• Der PipeOptions-Wert None.

• Standardgrößen für Eingabe- und Ausgabepuffer.

• Keine Pipesicherheit.

• Der HandleInheritability-Wert None.

• Kein angegebener zusätzlicher PipeAccessRights.

NamedPipeServerStream(String, PipeDirection)

Quelle:

NamedPipeServerStream.cs

Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit den angegebenen Werten für Pipename und Piperichtung.

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)

Parameter

pipeName

String

Der Name der Pipe.

direction

PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

Ausnahmen

ArgumentNullException

pipeName ist null.

ArgumentException

pipeName ist eine Zeichenfolge der Länge 0 (null).

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

- oder -

direction ist kein gültiger PipeDirection -Wert.

NotSupportedException

pipeName enthält einen Doppelpunkt (:).

IOException

Die maximale Anzahl von Serverinstanzen wurde überschritten.

Beispiele

Im folgenden Beispiel wird eine Methode zum Senden einer Zeichenfolge von einem übergeordneten Prozess an einen untergeordneten Prozess mithilfe von Named Pipes veranschaulicht. In diesem Beispiel wird ein NamedPipeServerStream -Objekt in einem übergeordneten Prozess erstellt. Das NamedPipeServerStream -Objekt hat den PipeDirection Wert , Outder dann blockiert, bis ein NamedPipeClientStream -Objekt eine Verbindung mit dem aktuellen NamedPipeServerStream -Objekt herstellt.

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

Hinweise

Dieser Konstruktor erstellt ein NamedPipeServerStream -Objekt mit den folgenden Merkmalen:

• Der PipeTransmissionMode-Wert Byte.

• Der PipeOptions-Wert None.

• Standardgrößen für Eingabe- und Ausgabepuffer.

• Keine Pipesicherheit.

• Der HandleInheritability-Wert None.

• Kein angegebener zusätzlicher PipeAccessRights.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)

Quelle:

NamedPipeServerStream.cs

Initialisiert eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen, der angegebenen Piperichtung, der angegebenen maximalen Anzahl von Serverinstanzen und dem angegebenen Übertragungsmodus.

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)

Parameter

pipeName

String

Der Name der Pipe.

direction

PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

maxNumberOfServerInstances

Int32

Die maximale Anzahl von Serverinstanzen mit dem gleichen Namen. Für diesen Wert kann MaxAllowedServerInstances übergeben werden.

transmissionMode

PipeTransmissionMode

Einer der Enumerationswerte, der den Übertragungsmodus der Pipe bestimmt.

Ausnahmen

ArgumentNullException

pipeName ist null.

ArgumentException

pipeName ist eine Zeichenfolge der Länge 0 (null).

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

- oder -

direction ist kein gültiger PipeDirection -Wert.

- oder -

maxNumberofServerInstances ist kleiner als -1 oder größer als 254 (-1 gibt MaxAllowedServerInstances an).

NotSupportedException

pipeName enthält einen Doppelpunkt (:).

IOException

Die maximale Anzahl von Serverinstanzen wurde überschritten.

Hinweise

Dieser Konstruktor erstellt ein NamedPipeServerStream -Objekt mit den folgenden Merkmalen:

• Ein Standardwert PipeOptions von None.

• Standardgrößen für Eingabe- und Ausgabepuffer.

• Keine Pipesicherheit.

• Der HandleInheritability-Wert None.

• Kein angegebener zusätzlicher PipeAccessRights.