NamedPipeClientStream Konstruktorer

Definition

Namnområde:: System.IO.Pipes

Sammansättning:: System.Core.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Initierar en ny instans av NamedPipeClientStream klassen.

Överlagringar

Name	Description
NamedPipeClientStream(String)	Initierar en ny instans av NamedPipeClientStream klassen med det angivna pipenamnet.
NamedPipeClientStream(String, String)	Initierar en ny instans av NamedPipeClientStream klassen med angivna pipe- och servernamn.
NamedPipeClientStream(String, String, PipeDirection)	Initierar en ny instans av NamedPipeClientStream klassen med de angivna pipe- och servernamnen och den angivna rörriktningen.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Initierar en ny instans av NamedPipeClientStream klassen för det angivna rörhandtaget med angiven rörriktning.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Initierar en ny instans av NamedPipeClientStream klassen med de angivna pipe- och servernamnen och de angivna rörriktnings- och röralternativen.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Initierar en ny instans av NamedPipeClientStream klassen med angivna pipe- och servernamn samt angiven rörriktning, pipe-alternativ och säkerhetspersonifieringsnivå.
NamedPipeClientStream(String, String, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Initierar en ny instans av NamedPipeClientStream klassen med de angivna pipe- och servernamnen och de angivna pipe-alternativen, säkerhets personifieringsnivån och ärvbarhetsläget.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Initierar en ny instans av NamedPipeClientStream klassen med angivna pipe- och servernamn och angiven rörriktning, pipe-alternativ, säkerhets personifieringsnivå och ärverbarhetsläge.

NamedPipeClientStream(String)

Initierar en ny instans av NamedPipeClientStream klassen med det angivna pipenamnet.

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)

Parametrar

pipeName: String

Namnet på röret.

Undantag

ArgumentNullException

pipeName är null.

ArgumentException

pipeName är en sträng med noll längd.

ArgumentOutOfRangeException

pipeName är inställd på "anonym".

Kommentarer

Den här konstruktorn använder följande standardvärden:

Ett standardservernamn på ".".
Ett standardvärde PipeDirection på InOut.
Ett standardvärde PipeOptions på None.
Ett standardvärde TokenImpersonationLevel på None.
Ett standardvärde HandleInheritability på None.

Gäller för

NamedPipeClientStream(String, String)

Initierar en ny instans av NamedPipeClientStream klassen med angivna pipe- och servernamn.

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)

Parametrar

serverName: String

Namnet på fjärrdatorn som ska anslutas till eller "." för att ange den lokala datorn.

pipeName: String

Namnet på röret.

Undantag

ArgumentNullException

pipeName eller serverName är null.

ArgumentException

pipeName eller serverName är en sträng med noll längd.

ArgumentOutOfRangeException

pipeName är inställd på "anonym".

Kommentarer

Den här konstruktorn använder följande standardvärden:

Ett standardvärde PipeDirection på InOut.
Ett standardvärde PipeOptions på None.
Ett standardvärde TokenImpersonationLevel på None.
Ett standardvärde HandleInheritability på None.

Gäller för

NamedPipeClientStream(String, String, PipeDirection)

Initierar en ny instans av NamedPipeClientStream klassen med de angivna pipe- och servernamnen och den angivna rörriktningen.

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)

Parametrar

serverName: String

Namnet på fjärrdatorn som ska anslutas till eller "." för att ange den lokala datorn.

pipeName: String

Namnet på röret.

direction: PipeDirection

Ett av uppräkningsvärdena som bestämmer riktningen för röret.

Undantag

ArgumentNullException

pipeName eller serverName är null.

ArgumentException

pipeName eller serverName är en sträng med noll längd.

ArgumentOutOfRangeException

pipeName är inställd på "anonym".

-eller-

direction är inte ett giltigt PipeDirection värde.

Exempel

I följande exempel visas en metod för att skicka en sträng från en överordnad process till en underordnad process med hjälp av namngivna pipes. Det här exemplet skapar ett NamedPipeClientStream objekt i en underordnad process som sedan ansluter till ett rör på den lokala datorn. Serverexemplet kan visas i NamedPipeServerStream klassen. Det här exemplet är en del av ett större exempel som tillhandahålls för klasserna NamedPipeServerStream och NamedPipeClientStream .

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

Kommentarer

Den här konstruktorn använder följande standardvärden:

Ett standardvärde PipeOptions på None.
Ett standardvärde TokenImpersonationLevel på None.
Ett standardvärde HandleInheritability på None.

Gäller för

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Initierar en ny instans av NamedPipeClientStream klassen för det angivna rörhandtaget med angiven rörriktning.

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)

Parametrar

direction: PipeDirection

Ett av uppräkningsvärdena som bestämmer riktningen för röret.

isAsync: Boolean

trueför att ange att handtaget öppnades asynkront; annars . false

isConnected: Boolean

trueför att indikera att röret är anslutet; annars . false

safePipeHandle: SafePipeHandle

Ett säkert handtag för röret som det här NamedPipeClientStream objektet kapslar in.

Attribut: SecurityCriticalAttribute

Undantag

IOException

Strömmen har stängts.

ArgumentException

safePipeHandle är inte ett giltigt handtag.

ArgumentNullException

safePipeHandle är null.

ArgumentOutOfRangeException

direction är inte ett giltigt PipeDirection värde.

Gäller för

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Initierar en ny instans av NamedPipeClientStream klassen med de angivna pipe- och servernamnen och de angivna rörriktnings- och röralternativen.

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)

Parametrar

serverName: String

Namnet på fjärrdatorn som ska anslutas till eller "." för att ange den lokala datorn.

pipeName: String

Namnet på röret.

direction: PipeDirection

Ett av uppräkningsvärdena som bestämmer riktningen för röret.

options: PipeOptions

Ett av uppräkningsvärdena som avgör hur du öppnar eller skapar röret.

Undantag

ArgumentNullException

pipeName eller serverName är null.

ArgumentException

pipeName eller serverName är en sträng med noll längd.

ArgumentOutOfRangeException

pipeName är inställd på "anonym".

-eller-

direction är inte ett giltigt PipeDirection värde.

-eller-

options är inte ett giltigt PipeOptions värde.

Kommentarer

Den här konstruktorn använder följande standardvärden:

Ett standardvärde TokenImpersonationLevel på None.
Ett standardvärde HandleInheritability på None.

Gäller för

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

Initierar en ny instans av NamedPipeClientStream klassen med angivna pipe- och servernamn samt angiven rörriktning, pipe-alternativ och säkerhetspersonifieringsnivå.

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)

Parametrar

serverName: String

Namnet på fjärrdatorn som ska anslutas till eller "." för att ange den lokala datorn.

pipeName: String

Namnet på röret.

direction: PipeDirection

Ett av uppräkningsvärdena som bestämmer riktningen för röret.

options: PipeOptions

Ett av uppräkningsvärdena som avgör hur du öppnar eller skapar röret.

impersonationLevel: TokenImpersonationLevel

Ett av uppräkningsvärdena som avgör säkerhetspersonifieringsnivån.

Undantag

ArgumentNullException

pipeName eller serverName är null.

ArgumentException

pipeName eller serverName är en sträng med noll längd.

ArgumentOutOfRangeException

pipeName är inställd på "anonym".

-eller-

direction är inte ett giltigt PipeDirection värde.

-eller-

options är inte ett giltigt PipeOptions värde.

-eller-

impersonationLevel är inte ett giltigt TokenImpersonationLevel värde.

Kommentarer

Den här konstruktorn använder standardvärdet HandleInheritability None.

Gäller för

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

Initierar en ny instans av NamedPipeClientStream klassen med de angivna pipe- och servernamnen och de angivna pipe-alternativen, säkerhets personifieringsnivån och ärvbarhetsläget.

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)

Parametrar

serverName: String

Namnet på fjärrdatorn som ska anslutas till eller "." för att ange den lokala datorn.

pipeName: String

Namnet på röret.

desiredAccessRights: PipeAccessRights

Ett av uppräkningsvärdena som anger önskade åtkomsträttigheter för röret.

options: PipeOptions

Ett av uppräkningsvärdena som avgör hur du öppnar eller skapar röret.

impersonationLevel: TokenImpersonationLevel

Ett av uppräkningsvärdena som avgör säkerhetspersonifieringsnivån.

inheritability: HandleInheritability

Ett av uppräkningsvärdena som avgör om den underliggande referensen kan ärvas av underordnade processer.

Undantag

ArgumentNullException

pipeName eller serverName är null.

ArgumentException

pipeName eller serverName är en sträng med noll längd.

ArgumentOutOfRangeException

pipeName är inställd på "anonym".

-eller-

options är inte ett giltigt PipeOptions värde.

-eller-

impersonationLevel är inte ett giltigt TokenImpersonationLevel värde.

-eller-

inheritability är inte ett giltigt HandleInheritability värde.

Kommentarer

Rörriktningen för den här konstruktorn bestäms av parametern desiredAccessRights . Om värdet desiredAccessRights är ReadDatablir Inrörriktningen . Om värdet desiredAccessRights för är blir WriteDatarörriktningen Out. Om värdet desiredAccessRights för inkluderar både ReadData och WriteDatablir InOutrörriktningen .

Gäller för

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

Initierar en ny instans av NamedPipeClientStream klassen med angivna pipe- och servernamn och angiven rörriktning, pipe-alternativ, säkerhets personifieringsnivå och ärverbarhetsläge.

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)

Parametrar

serverName: String

Namnet på fjärrdatorn som ska anslutas till eller "." för att ange den lokala datorn.

pipeName: String

Namnet på röret.

direction: PipeDirection

Ett av uppräkningsvärdena som bestämmer riktningen för röret.

options: PipeOptions

Ett av uppräkningsvärdena som avgör hur du öppnar eller skapar röret.

impersonationLevel: TokenImpersonationLevel

Ett av uppräkningsvärdena som avgör säkerhetspersonifieringsnivån.

inheritability: HandleInheritability

Ett av uppräkningsvärdena som avgör om den underliggande referensen kan ärvas av underordnade processer.

Undantag

ArgumentNullException

pipeName eller serverName är null.

ArgumentException

pipeName eller serverName är en sträng med noll längd.

ArgumentOutOfRangeException

pipeName är inställd på "anonym".

-eller-

direction är inte ett giltigt PipeDirection värde.

-eller-

options är inte ett giltigt PipeOptions värde.

-eller-

impersonationLevel är inte ett giltigt TokenImpersonationLevel värde.

-eller-

inheritability är inte ett giltigt HandleInheritability värde.

Gäller för

Feedback

Var den här sidan till hjälp?