NamedPipeClientStream Konstruktoren

Referenz

Definition

Namespace:: System.IO.Pipes

Assembly:: System.IO.Pipes.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse.

Überlädt

NamedPipeClientStream(String)	Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipenamen.
NamedPipeClientStream(String, String)	Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen.
NamedPipeClientStream(String, String, PipeDirection)	Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen und der angegebenen Piperichtung.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse für das angegebene Pipehandle mit der angegebenen Piperichtung.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen, der angegebenen Piperichtung und den angegebenen Pipeoptionen.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen, der angegebenen Piperichtung, den angegebenen Pipeoptionen und der angegebenen Ebene des Sicherheitsidentitätswechsels.
NamedPipeClientStream(String, String, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen, den angegebenen Pipeoptionen, der angegebenen Ebene des Sicherheitsidentitätswechsels und dem angegebenen Vererbbarkeitsmodus.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen, der angegebenen Piperichtung, den angegebenen Pipeoptionen, der angegebenen Ebene des Sicherheitsidentitätswechsels und dem angegebenen Vererbbarkeitsmodus.

NamedPipeClientStream(String)

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

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

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)

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.

Hinweise

Dieser Konstruktor verwendet die folgenden Standardwerte:

Der Standardservername ".".
Der Standardwert PipeDirection ist InOut.
Der Standardwert PipeOptions ist None.
Der Standardwert TokenImpersonationLevel ist None.
Der Standardwert HandleInheritability ist None.

Gilt für:

NamedPipeClientStream(String, String)

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen.

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)

Parameter

serverName: String

Der Name des Remotecomputers, mit dem eine Verbindung hergestellt werden soll, oder ".", um den lokalen Computer anzugeben.

pipeName: String

Der Name der Pipe.

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

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

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

Hinweise

Dieser Konstruktor verwendet die folgenden Standardwerte:

Der Standardwert PipeDirection ist InOut.
Der Standardwert PipeOptions ist None.
Der Standardwert TokenImpersonationLevel ist None.
Der Standardwert HandleInheritability ist None.

Gilt für:

NamedPipeClientStream(String, String, PipeDirection)

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen und der angegebenen Piperichtung.

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)

Parameter

serverName: String

Der Name des Remotecomputers, mit dem eine Verbindung hergestellt werden soll, oder ".", um den lokalen Computer anzugeben.

pipeName: String

Der Name der Pipe.

direction: PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

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

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

- oder -

direction ist kein gültiger PipeDirection -Wert.

Beispiele

Das folgende Beispiel veranschaulicht eine Methode zum Senden einer Zeichenfolge von einem übergeordneten Prozess an einen untergeordneten Prozess mithilfe von Named Pipes. In diesem Beispiel wird ein NamedPipeClientStream Objekt in einem untergeordneten Prozess erstellt, der dann eine Verbindung mit einer Pipe auf dem lokalen Computer herstellt. Das Serverbeispiel ist in der NamedPipeServerStream -Klasse zu sehen. Dieses Beispiel ist Teil eines größeren Beispiels, das für die NamedPipeServerStream Klassen und NamedPipeClientStream bereitgestellt wird.

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

Hinweise

Dieser Konstruktor verwendet die folgenden Standardwerte:

Der Standardwert PipeOptions ist None.
Der Standardwert TokenImpersonationLevel ist None.
Der Standardwert HandleInheritability ist None.

Gilt für:

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse für das angegebene Pipehandle mit der angegebenen Piperichtung.

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)

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 NamedPipeClientStream-Objekt gekapselt wird.

Attribute: SecurityCriticalAttribute

Ausnahmen

IOException

Der Stream wurde geschlossen.

ArgumentException

safePipeHandle ist kein gültiges Handle.

ArgumentNullException

safePipeHandle ist null.

ArgumentOutOfRangeException

direction ist kein gültiger PipeDirection -Wert.

Gilt für:

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen, der angegebenen Piperichtung und den angegebenen Pipeoptionen.

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)

Parameter

serverName: String

Der Name des Remotecomputers, mit dem eine Verbindung hergestellt werden soll, oder ".", um den lokalen Computer anzugeben.

pipeName: String

Der Name der Pipe.

direction: PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

options: PipeOptions

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

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

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

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

- oder -

direction ist kein gültiger PipeDirection -Wert.

- oder -

options ist kein gültiger PipeOptions -Wert.

Hinweise

Dieser Konstruktor verwendet die folgenden Standardwerte:

Der Standardwert TokenImpersonationLevel ist None.
Der Standardwert HandleInheritability ist None.

Gilt für:

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

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen, der angegebenen Piperichtung, den angegebenen Pipeoptionen und der angegebenen Ebene des Sicherheitsidentitätswechsels.

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)

Parameter

serverName: String

Der Name des Remotecomputers, mit dem eine Verbindung hergestellt werden soll, oder ".", um den lokalen Computer anzugeben.

pipeName: String

Der Name der Pipe.

direction: PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

options: PipeOptions

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

impersonationLevel: TokenImpersonationLevel

Einer der Enumerationswerte, der die Ebene des Sicherheitsidentitätswechsels bestimmt.

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

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

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

- oder -

direction ist kein gültiger PipeDirection -Wert.

- oder -

options ist kein gültiger PipeOptions -Wert.

- oder -

impersonationLevel ist kein gültiger TokenImpersonationLevel -Wert.

Hinweise

Dieser Konstruktor verwendet den Standardwert HandleInheritability .None

Gilt für:

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

Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen, den angegebenen Pipeoptionen, der angegebenen Ebene des Sicherheitsidentitätswechsels und dem angegebenen Vererbbarkeitsmodus.

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)

Parameter

serverName: String

Der Name des Remotecomputers, mit dem eine Verbindung hergestellt werden soll, oder ".", um den lokalen Computer anzugeben.

pipeName: String

Der Name der Pipe.

desiredAccessRights: PipeAccessRights

Einer der Enumerationswerte, der die gewünschten Zugriffsrechte der Pipe angibt.

options: PipeOptions

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

impersonationLevel: TokenImpersonationLevel

Einer der Enumerationswerte, der die Ebene des Sicherheitsidentitätswechsels bestimmt.

inheritability: HandleInheritability

Einer der Enumerationswerte, der bestimmt, ob das zugrunde liegende Handle von untergeordneten Prozessen geerbt werden kann.

Attribute: SupportedOSPlatformAttribute

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

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

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

- oder -

options ist kein gültiger PipeOptions -Wert.

- oder -

impersonationLevel ist kein gültiger TokenImpersonationLevel -Wert.

- oder -

inheritability ist kein gültiger HandleInheritability -Wert.

Hinweise

Die Piperichtung für diesen Konstruktor wird durch den desiredAccessRights Parameter bestimmt. Wenn der desiredAccessRights Wert ist, lautet ReadData Indie Piperichtung . Wenn der Wert von desiredAccessRights ist, lautet WriteData Outdie Piperichtung . Wenn der Wert von desiredAccessRights sowohl als WriteDataauch ReadData enthält, lautet InOutdie Piperichtung .

Gilt für:

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

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Quelle:: NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream-Klasse mit dem angegebenen Pipe- und Servernamen, der angegebenen Piperichtung, den angegebenen Pipeoptionen, der angegebenen Ebene des Sicherheitsidentitätswechsels und dem angegebenen Vererbbarkeitsmodus.

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)

Parameter

serverName: String

Der Name des Remotecomputers, mit dem eine Verbindung hergestellt werden soll, oder ".", um den lokalen Computer anzugeben.

pipeName: String

Der Name der Pipe.

direction: PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

options: PipeOptions

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

impersonationLevel: TokenImpersonationLevel

Einer der Enumerationswerte, der die Ebene des Sicherheitsidentitätswechsels bestimmt.

inheritability: HandleInheritability

Einer der Enumerationswerte, der bestimmt, ob das zugrunde liegende Handle von untergeordneten Prozessen geerbt werden kann.

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

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

ArgumentOutOfRangeException

pipeName ist auf „anonym“ festgelegt.

- oder -

direction ist kein gültiger PipeDirection -Wert.

- oder -

options ist kein gültiger PipeOptions -Wert.

- oder -

impersonationLevel ist kein gültiger TokenImpersonationLevel -Wert.

- oder -

inheritability ist kein gültiger HandleInheritability -Wert.

Gilt für:

Freigeben über

NamedPipeClientStream Konstruktoren

Definition

Überlädt

NamedPipeClientStream(String)

Parameter

Ausnahmen

Hinweise

Gilt für:

NamedPipeClientStream(String, String)

Parameter

Ausnahmen

Hinweise

Gilt für:

NamedPipeClientStream(String, String, PipeDirection)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Parameter

Ausnahmen

Gilt für:

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Parameter

Ausnahmen

Hinweise

Gilt für:

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

Parameter

Ausnahmen

Hinweise

Gilt für:

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

Parameter

Ausnahmen

Hinweise

Gilt für:

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

Parameter

Ausnahmen

Gilt für:

Zusätzliche Ressourcen