NamedPipeClientStream Constructors

Definitie

Naamruimte:: System.IO.Pipes

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse.

Overloads

Name	Description
NamedPipeClientStream(String)	Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijpnaam.
NamedPipeClientStream(String, String)	Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen.
NamedPipeClientStream(String, String, PipeDirection)	Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen en de opgegeven pijprichting.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse voor de opgegeven pijpgreep met de opgegeven pijprichting.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen en de opgegeven pijprichting en pijpopties.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen, en de opgegeven pijprichting, pijpopties en beveiligingsimitatieniveau.
NamedPipeClientStream(String, String, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen, en de opgegeven pijpopties, het beveiligingsimitatieniveau en de modus overname.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen, en de opgegeven pijprichting, pijpopties, beveiligingsimitatieniveau en de modus overname.

NamedPipeClientStream(String)

Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijpnaam.

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)

Parameters

pipeName: String

De naam van de pijp.

Uitzonderingen

ArgumentNullException

pipeName is null.

ArgumentException

pipeName is een tekenreeks met lengte nul.

ArgumentOutOfRangeException

pipeName is ingesteld op 'anoniem'.

Opmerkingen

Deze constructor maakt gebruik van de volgende standaardwaarden:

Een standaardservernaam van '.'.
Een standaardwaarde PipeDirection van InOut.
Een standaardwaarde PipeOptions van None.
Een standaardwaarde TokenImpersonationLevel van None.
Een standaardwaarde HandleInheritability van None.

Van toepassing op

NamedPipeClientStream(String, String)

Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en 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)

Parameters

serverName: String

De naam van de externe computer waarmee verbinding moet worden gemaakt of '.' om de lokale computer op te geven.

pipeName: String

De naam van de pijp.

Uitzonderingen

ArgumentNullException

pipeName of serverName is null.

ArgumentException

pipeName of serverName is een tekenreeks met lengte nul.

ArgumentOutOfRangeException

pipeName is ingesteld op 'anoniem'.

Opmerkingen

Deze constructor maakt gebruik van de volgende standaardwaarden:

Een standaardwaarde PipeDirection van InOut.
Een standaardwaarde PipeOptions van None.
Een standaardwaarde TokenImpersonationLevel van None.
Een standaardwaarde HandleInheritability van None.

Van toepassing op

NamedPipeClientStream(String, String, PipeDirection)

Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen en de opgegeven pijprichting.

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)

Parameters

serverName: String

De naam van de externe computer waarmee verbinding moet worden gemaakt of '.' om de lokale computer op te geven.

pipeName: String

De naam van de pijp.

direction: PipeDirection

Een van de opsommingswaarden die de richting van de pijp bepalen.

Uitzonderingen

ArgumentNullException

pipeName of serverName is null.

ArgumentException

pipeName of serverName is een tekenreeks met lengte nul.

ArgumentOutOfRangeException

pipeName is ingesteld op 'anoniem'.

– of –

direction is geen geldige PipeDirection waarde.

Voorbeelden

In het volgende voorbeeld ziet u een methode voor het verzenden van een tekenreeks van een bovenliggend proces naar een onderliggend proces met behulp van benoemde pijpen. In dit voorbeeld wordt een NamedPipeClientStream object gemaakt in een onderliggend proces, dat vervolgens verbinding maakt met een pipe op de lokale computer. Het servervoorbeeld is te zien in de NamedPipeServerStream klasse. Dit voorbeeld maakt deel uit van een groter voorbeeld voor de NamedPipeServerStream en NamedPipeClientStream klassen.

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

Opmerkingen

Deze constructor maakt gebruik van de volgende standaardwaarden:

Een standaardwaarde PipeOptions van None.
Een standaardwaarde TokenImpersonationLevel van None.
Een standaardwaarde HandleInheritability van None.

Van toepassing op

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse voor de opgegeven pijpgreep met de opgegeven pijprichting.

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);

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

[<System.Security.SecurityCritical>]
new System.IO.Pipes.NamedPipeClientStream : System.IO.Pipes.PipeDirection * bool * bool * Microsoft.Win32.SafeHandles.SafePipeHandle -> System.IO.Pipes.NamedPipeClientStream

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)

Parameters

direction: PipeDirection

Een van de opsommingswaarden die de richting van de pijp bepalen.

isAsync: Boolean

true om aan te geven dat de ingang asynchroon is geopend; anders, false.

isConnected: Boolean

true om aan te geven dat de pijp is aangesloten; anders, false.

safePipeHandle: SafePipeHandle

Een veilige handgreep voor de pijp die door dit NamedPipeClientStream object wordt ingekapseld.

Kenmerken: SecurityCriticalAttribute

Uitzonderingen

IOException

De stream is gesloten.

ArgumentException

safePipeHandle is geen geldige ingang.

ArgumentNullException

safePipeHandle is null.

ArgumentOutOfRangeException

direction is geen geldige PipeDirection waarde.

Van toepassing op

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen en de opgegeven pijprichting en pijpopties.

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)

Parameters

serverName: String

De naam van de externe computer waarmee verbinding moet worden gemaakt of '.' om de lokale computer op te geven.

pipeName: String

De naam van de pijp.

direction: PipeDirection

Een van de opsommingswaarden die de richting van de pijp bepalen.

options: PipeOptions

Een van de opsommingswaarden die bepalen hoe de pijp moet worden geopend of gemaakt.

Uitzonderingen

ArgumentNullException

pipeName of serverName is null.

ArgumentException

pipeName of serverName is een tekenreeks met lengte nul.

ArgumentOutOfRangeException

pipeName is ingesteld op 'anoniem'.

– of –

direction is geen geldige PipeDirection waarde.

– of –

options is geen geldige PipeOptions waarde.

Opmerkingen

Deze constructor maakt gebruik van de volgende standaardwaarden:

Een standaardwaarde TokenImpersonationLevel van None.
Een standaardwaarde HandleInheritability van None.

Van toepassing op

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

Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen, en de opgegeven pijprichting, pijpopties en beveiligingsimitatieniveau.

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)

Parameters

serverName: String

De naam van de externe computer waarmee verbinding moet worden gemaakt of '.' om de lokale computer op te geven.

pipeName: String

De naam van de pijp.

direction: PipeDirection

Een van de opsommingswaarden die de richting van de pijp bepalen.

options: PipeOptions

Een van de opsommingswaarden die bepalen hoe de pijp moet worden geopend of gemaakt.

impersonationLevel: TokenImpersonationLevel

Een van de opsommingswaarden die het beveiligingsimitatieniveau bepalen.

Uitzonderingen

ArgumentNullException

pipeName of serverName is null.

ArgumentException

pipeName of serverName is een tekenreeks met lengte nul.

ArgumentOutOfRangeException

pipeName is ingesteld op 'anoniem'.

– of –

direction is geen geldige PipeDirection waarde.

– of –

options is geen geldige PipeOptions waarde.

– of –

impersonationLevel is geen geldige TokenImpersonationLevel waarde.

Opmerkingen

Deze constructor gebruikt een standaardwaarde HandleInheritability van None.

Van toepassing op

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

Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen, en de opgegeven pijpopties, het beveiligingsimitatieniveau en de modus overname.

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);

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);

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)

Parameters

serverName: String

De naam van de externe computer waarmee verbinding moet worden gemaakt of '.' om de lokale computer op te geven.

pipeName: String

De naam van de pijp.

desiredAccessRights: PipeAccessRights

Een van de opsommingswaarden waarmee de gewenste toegangsrechten van de pijp worden opgegeven.

options: PipeOptions

Een van de opsommingswaarden die bepalen hoe de pijp moet worden geopend of gemaakt.

impersonationLevel: TokenImpersonationLevel

Een van de opsommingswaarden die het beveiligingsimitatieniveau bepalen.

inheritability: HandleInheritability

Een van de opsommingswaarden die bepaalt of de onderliggende ingang kan worden overgenomen door onderliggende processen.

Uitzonderingen

ArgumentNullException

pipeName of serverName is null.

ArgumentException

pipeName of serverName is een tekenreeks met lengte nul.

ArgumentOutOfRangeException

pipeName is ingesteld op 'anoniem'.

– of –

options is geen geldige PipeOptions waarde.

– of –

impersonationLevel is geen geldige TokenImpersonationLevel waarde.

– of –

inheritability is geen geldige HandleInheritability waarde.

Opmerkingen

De pijprichting voor deze constructor wordt bepaald door de desiredAccessRights parameter. Als de desiredAccessRights waarde is ReadData, is Inde richting van de pijp . Als de waarde isWriteData, is Outde richting van desiredAccessRights de pijp . Als de waarde van desiredAccessRights zowel en ReadData WriteData, de pijprichting zal zijnInOut.

Van toepassing op

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

Initialiseert een nieuw exemplaar van de NamedPipeClientStream klasse met de opgegeven pijp- en servernamen, en de opgegeven pijprichting, pijpopties, beveiligingsimitatieniveau en de modus overname.

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)

Parameters

serverName: String

De naam van de externe computer waarmee verbinding moet worden gemaakt of '.' om de lokale computer op te geven.

pipeName: String

De naam van de pijp.

direction: PipeDirection

Een van de opsommingswaarden die de richting van de pijp bepalen.

options: PipeOptions

Een van de opsommingswaarden die bepalen hoe de pijp moet worden geopend of gemaakt.

impersonationLevel: TokenImpersonationLevel

Een van de opsommingswaarden die het beveiligingsimitatieniveau bepalen.

inheritability: HandleInheritability

Een van de opsommingswaarden die bepaalt of de onderliggende ingang kan worden overgenomen door onderliggende processen.

Uitzonderingen

ArgumentNullException

pipeName of serverName is null.

ArgumentException

pipeName of serverName is een tekenreeks met lengte nul.

ArgumentOutOfRangeException

pipeName is ingesteld op 'anoniem'.

– of –

direction is geen geldige PipeDirection waarde.

– of –

options is geen geldige PipeOptions waarde.

– of –

impersonationLevel is geen geldige TokenImpersonationLevel waarde.

– of –

inheritability is geen geldige HandleInheritability waarde.

Van toepassing op

Feedback

Is deze pagina nuttig?