NamedPipeClientStream Konstruktoren

Definition

Namespace:

System.IO.Pipes

Assemblys:

netstandard.dll, System.IO.Pipes.dll

Initialisiert eine neue instance der NamedPipeClientStream -Klasse.

Überlädt

Name	Beschreibung
NamedPipeClientStream(String)	Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit dem angegebenen Pipenamen.
NamedPipeClientStream(String, String)	Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den angegebenen Pipe- und Servernamen.
NamedPipeClientStream(String, String, PipeDirection)	Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den angegebenen Pipe- und Servernamen und der angegebenen Piperichtung.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Initialisiert eine neue Instanz der NamedPipeClientStream Klasse für den angegebenen Pipehandle mit der angegebenen Piperichtung.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den angegebenen Pipe- und Servernamen sowie den angegebenen Piperichtungs- und Pipeoptionen.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den angegebenen Pipe- und Servernamen sowie die angegebene Piperichtung, Pipeoptionen und Sicherheitsidentitätswechselebene.
NamedPipeClientStream(String, String, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den angegebenen Pipe- und Servernamen sowie die angegebenen Pipeoptionen, die Sicherheitsidentitätswechselstufe und den Vererbbarkeitsmodus.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den angegebenen Pipe- und Servernamen sowie die angegebene Piperichtung, Pipeoptionen, Identitätswechselstufe und Vererbbarkeitsmodus.

NamedPipeClientStream(String)

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

Ausnahmen

ArgumentNullException

pipeName ist null.

ArgumentException

pipeName ist eine leere Zeichenfolge.

ArgumentOutOfRangeException

pipeName ist auf "anonym" festgelegt.

Hinweise

Dieser Konstruktor verwendet die folgenden Standardwerte:

• Ein Standardservername von ".".

• Ein Standardwert PipeDirection von InOut.

• Ein Standardwert PipeOptions von None.

• Ein Standardwert TokenImpersonationLevel von None.

• Ein Standardwert HandleInheritability von None.

NamedPipeClientStream(String, String)

Quelle:

NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den 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 Pfeife.

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

pipeName oder serverName ist eine leere Zeichenfolge.

ArgumentOutOfRangeException

pipeName ist auf "anonym" festgelegt.

Hinweise

Dieser Konstruktor verwendet die folgenden Standardwerte:

• Ein Standardwert PipeDirection von InOut.

• Ein Standardwert PipeOptions von None.

• Ein Standardwert TokenImpersonationLevel von None.

• Ein Standardwert HandleInheritability von None.

NamedPipeClientStream(String, String, PipeDirection)

Quelle:

NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den 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 Pfeife.

direction

PipeDirection

Einer der Enumerationswerte, die die Richtung der Pipe bestimmt.

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

pipeName oder serverName ist eine leere Zeichenfolge.

ArgumentOutOfRangeException

pipeName ist auf "anonym" festgelegt.

-oder-

direction ist kein gültiger PipeDirection Wert.

Beispiele

Im folgenden Beispiel wird eine Methode zum Senden einer Zeichenfolge aus einem übergeordneten Prozess an einen untergeordneten Prozess mithilfe von benannten Rohren veranschaulicht. In diesem Beispiel wird ein NamedPipeClientStream Objekt in einem untergeordneten Prozess erstellt, das dann eine Verbindung mit einer Pipe auf dem lokalen Computer herstellt. Das Serverbeispiel kann in der NamedPipeServerStream Klasse angezeigt werden. Dieses Beispiel ist Teil eines größeren Beispiels, das für die Klassen und NamedPipeClientStream die NamedPipeServerStream Klassen 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:

• Ein Standardwert PipeOptions von None.

• Ein Standardwert TokenImpersonationLevel von None.

• Ein Standardwert HandleInheritability von None.

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Quelle:

NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream Klasse für den angegebenen 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);

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, die die Richtung der Pipe bestimmt.

isAsync

Boolean

trueum anzugeben, dass das Handle asynchron geöffnet wurde; andernfalls . false

isConnected

Boolean

trueum anzugeben, dass das Rohr verbunden ist; andernfalls . false

safePipeHandle

SafePipeHandle

Ein sicherer Handle für die Pipe, die dieses NamedPipeClientStream Objekt kapselt.

Ausnahmen

IOException

Der Datenstrom wurde geschlossen.

ArgumentException

safePipeHandle ist kein gültiger Handle.

ArgumentNullException

safePipeHandle ist null.

ArgumentOutOfRangeException

direction ist kein gültiger PipeDirection Wert.

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Quelle:

NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den angegebenen Pipe- und Servernamen sowie den angegebenen Piperichtungs- und 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 Pfeife.

direction

PipeDirection

Einer der Enumerationswerte, die die Richtung der Pipe bestimmt.

options

PipeOptions

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

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

pipeName oder serverName ist eine leere Zeichenfolge.

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:

• Ein Standardwert TokenImpersonationLevel von None.

• Ein Standardwert HandleInheritability von None.

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

Quelle:

NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den angegebenen Pipe- und Servernamen sowie die angegebene Piperichtung, Pipeoptionen und Sicherheitsidentitätswechselebene.

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

direction

PipeDirection

Einer der Enumerationswerte, die die Richtung der Pipe bestimmt.

options

PipeOptions

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

impersonationLevel

TokenImpersonationLevel

Einer der Enumerationswerte, die die Sicherheitsidentitätswechselebene bestimmt.

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

pipeName oder serverName ist eine leere Zeichenfolge.

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 einen Standardwert HandleInheritability von None.

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

Quelle:

NamedPipeClientStream.Unix.cs

Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den angegebenen Pipe- und Servernamen sowie die angegebenen Pipeoptionen, die Sicherheitsidentitätswechselstufe und den 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);

[<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

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

desiredAccessRights

PipeAccessRights

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

options

PipeOptions

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

impersonationLevel

TokenImpersonationLevel

Einer der Enumerationswerte, die die Sicherheitsidentitätswechselebene bestimmt.

inheritability

HandleInheritability

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

Attribute

SupportedOSPlatformAttribute

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

pipeName oder serverName ist eine leere Zeichenfolge.

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 lautet ReadData, lautet Indie Piperichtung . Wenn der Wert desiredAccessRights des Werts ist WriteData, lautet Outdie Piperichtung . Wenn der Wert von desiredAccessRights "Enthält" und ReadData "Beide" enthält WriteData, lautet InOutdie Piperichtung .

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

Quelle:

NamedPipeClientStream.cs

Initialisiert eine neue Instanz der NamedPipeClientStream Klasse mit den angegebenen Pipe- und Servernamen sowie die angegebene Piperichtung, Pipeoptionen, Identitätswechselstufe und 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 Pfeife.

direction

PipeDirection

Einer der Enumerationswerte, die die Richtung der Pipe bestimmt.

options

PipeOptions

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

impersonationLevel

TokenImpersonationLevel

Einer der Enumerationswerte, die die Sicherheitsidentitätswechselebene bestimmt.

inheritability

HandleInheritability

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

Ausnahmen

ArgumentNullException

pipeName oder serverName ist null.

ArgumentException

pipeName oder serverName ist eine leere Zeichenfolge.

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.