NamedPipeClientStream Konstruktor

Definisi

Ruang nama:

System.IO.Pipes

Rakitan:

netstandard.dll, System.IO.Pipes.dll

Menginisialisasi instans baru kelas NamedPipeClientStream.

Overload

Nama	Deskripsi
NamedPipeClientStream(String)	Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa yang ditentukan.
NamedPipeClientStream(String, String)	Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan.
NamedPipeClientStream(String, String, PipeDirection)	Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan, dan arah pipa yang ditentukan.
NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Menginisialisasi instans NamedPipeClientStream baru kelas untuk handel pipa yang ditentukan dengan arah pipa yang ditentukan.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions)	Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan, dan arah pipa dan opsi pipa yang ditentukan.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel)	Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan, dan arah pipa, opsi pipa, dan tingkat peniruan keamanan yang ditentukan.
NamedPipeClientStream(String, String, PipeAccessRights, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan, dan opsi pipa yang ditentukan, tingkat peniruan identitas keamanan, dan mode warisan.
NamedPipeClientStream(String, String, PipeDirection, PipeOptions, TokenImpersonationLevel, HandleInheritability)	Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan, dan arah pipa yang ditentukan, opsi pipa, tingkat peniruan keamanan, dan mode pewarisan.

NamedPipeClientStream(String)

Sumber:

NamedPipeClientStream.cs

Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa yang ditentukan.

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

Nama pipa.

Pengecualian

ArgumentNullException

pipeName adalah null.

ArgumentException

pipeName adalah string panjang nol.

ArgumentOutOfRangeException

pipeName diatur ke "anonim".

Keterangan

Konstruktor ini menggunakan nilai default berikut:

• Nama server default ".".

• Nilai default PipeDirection .InOut

• Nilai default PipeOptions .None

• Nilai default TokenImpersonationLevel .None

• Nilai default HandleInheritability .None

NamedPipeClientStream(String, String)

Sumber:

NamedPipeClientStream.cs

Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan.

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

Nama komputer jarak jauh yang akan disambungkan, atau "." untuk menentukan komputer lokal.

pipeName

String

Nama pipa.

Pengecualian

ArgumentNullException

pipeName atau serverName adalah null.

ArgumentException

pipeName atau serverName adalah string panjang nol.

ArgumentOutOfRangeException

pipeName diatur ke "anonim".

Keterangan

Konstruktor ini menggunakan nilai default berikut:

• Nilai default PipeDirection .InOut

• Nilai default PipeOptions .None

• Nilai default TokenImpersonationLevel .None

• Nilai default HandleInheritability .None

NamedPipeClientStream(String, String, PipeDirection)

Sumber:

NamedPipeClientStream.cs

Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan, dan arah pipa yang ditentukan.

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

Nama komputer jarak jauh yang akan disambungkan, atau "." untuk menentukan komputer lokal.

pipeName

String

Nama pipa.

direction

PipeDirection

Salah satu nilai enumerasi yang menentukan arah pipa.

Pengecualian

ArgumentNullException

pipeName atau serverName adalah null.

ArgumentException

pipeName atau serverName adalah string panjang nol.

ArgumentOutOfRangeException

pipeName diatur ke "anonim".

-atau-

direction bukan nilai yang valid PipeDirection .

Contoh

Contoh berikut menunjukkan metode untuk mengirim string dari proses induk ke proses anak menggunakan pipa bernama. Contoh ini membuat NamedPipeClientStream objek dalam proses anak, yang kemudian tersambung ke pipa di komputer lokal. Contoh server dapat dilihat di NamedPipeServerStream kelas . Contoh ini adalah bagian dari contoh yang lebih besar yang disediakan untuk NamedPipeServerStream kelas dan 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

Keterangan

Konstruktor ini menggunakan nilai default berikut:

• Nilai default PipeOptions .None

• Nilai default TokenImpersonationLevel .None

• Nilai default HandleInheritability .None

NamedPipeClientStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Sumber:

NamedPipeClientStream.cs

Menginisialisasi instans NamedPipeClientStream baru kelas untuk handel pipa yang ditentukan dengan arah pipa yang ditentukan.

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

Salah satu nilai enumerasi yang menentukan arah pipa.

isAsync

Boolean

true untuk menunjukkan bahwa handel dibuka secara asinkron; jika tidak, false.

isConnected

Boolean

true untuk menunjukkan bahwa pipa terhubung; jika tidak, false.

safePipeHandle

SafePipeHandle

Handel yang aman untuk pipa yang akan dirangkum objek ini NamedPipeClientStream .

Pengecualian

IOException

Aliran telah ditutup.

ArgumentException

safePipeHandle bukan handel yang valid.

ArgumentNullException

safePipeHandle adalah null.

ArgumentOutOfRangeException

direction bukan nilai yang valid PipeDirection .

NamedPipeClientStream(String, String, PipeDirection, PipeOptions)

Sumber:

NamedPipeClientStream.cs

Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan, dan arah pipa dan opsi pipa yang ditentukan.

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

Nama komputer jarak jauh yang akan disambungkan, atau "." untuk menentukan komputer lokal.

pipeName

String

Nama pipa.

direction

PipeDirection

Salah satu nilai enumerasi yang menentukan arah pipa.

options

PipeOptions

Salah satu nilai enumerasi yang menentukan cara membuka atau membuat pipa.

Pengecualian

ArgumentNullException

pipeName atau serverName adalah null.

ArgumentException

pipeName atau serverName adalah string panjang nol.

ArgumentOutOfRangeException

pipeName diatur ke "anonim".

-atau-

direction bukan nilai yang valid PipeDirection .

-atau-

options bukan nilai yang valid PipeOptions .

Keterangan

Konstruktor ini menggunakan nilai default berikut:

• Nilai default TokenImpersonationLevel .None

• Nilai default HandleInheritability .None

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

Sumber:

NamedPipeClientStream.cs

Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan, dan arah pipa, opsi pipa, dan tingkat peniruan keamanan yang ditentukan.

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

Nama komputer jarak jauh yang akan disambungkan, atau "." untuk menentukan komputer lokal.

pipeName

String

Nama pipa.

direction

PipeDirection

Salah satu nilai enumerasi yang menentukan arah pipa.

options

PipeOptions

Salah satu nilai enumerasi yang menentukan cara membuka atau membuat pipa.

impersonationLevel

TokenImpersonationLevel

Salah satu nilai enumerasi yang menentukan tingkat peniruan keamanan.

Pengecualian

ArgumentNullException

pipeName atau serverName adalah null.

ArgumentException

pipeName atau serverName adalah string panjang nol.

ArgumentOutOfRangeException

pipeName diatur ke "anonim".

-atau-

direction bukan nilai yang valid PipeDirection .

-atau-

options bukan nilai yang valid PipeOptions .

-atau-

impersonationLevel bukan nilai yang valid TokenImpersonationLevel .

Keterangan

Konstruktor ini menggunakan nilai default HandleInheritability .None

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

Sumber:

NamedPipeClientStream.Unix.cs

Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan, dan opsi pipa yang ditentukan, tingkat peniruan identitas keamanan, dan mode warisan.

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

Nama komputer jarak jauh yang akan disambungkan, atau "." untuk menentukan komputer lokal.

pipeName

String

Nama pipa.

desiredAccessRights

PipeAccessRights

Salah satu nilai enumerasi yang menentukan hak akses yang diinginkan dari pipa.

options

PipeOptions

Salah satu nilai enumerasi yang menentukan cara membuka atau membuat pipa.

impersonationLevel

TokenImpersonationLevel

Salah satu nilai enumerasi yang menentukan tingkat peniruan keamanan.

inheritability

HandleInheritability

Salah satu nilai enumerasi yang menentukan apakah handel yang mendasar akan diwariskan oleh proses anak.

Atribut

SupportedOSPlatformAttribute

Pengecualian

ArgumentNullException

pipeName atau serverName adalah null.

ArgumentException

pipeName atau serverName adalah string panjang nol.

ArgumentOutOfRangeException

pipeName diatur ke "anonim".

-atau-

options bukan nilai yang valid PipeOptions .

-atau-

impersonationLevel bukan nilai yang valid TokenImpersonationLevel .

-atau-

inheritability bukan nilai yang valid HandleInheritability .

Keterangan

Arah pipa untuk konstruktor ini ditentukan oleh desiredAccessRights parameter . Jika nilainya desiredAccessRights adalah ReadData, arah pipa akan menjadi In. Jika nilai desiredAccessRights adalah WriteData, arah pipa akan menjadi Out. Jika nilai desiredAccessRights menyertakan dan ReadDataWriteData, arah pipa akan menjadi InOut.

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

Sumber:

NamedPipeClientStream.cs

Menginisialisasi instans NamedPipeClientStream baru kelas dengan nama pipa dan server yang ditentukan, dan arah pipa yang ditentukan, opsi pipa, tingkat peniruan keamanan, dan mode pewarisan.

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

Nama komputer jarak jauh yang akan disambungkan, atau "." untuk menentukan komputer lokal.

pipeName

String

Nama pipa.

direction

PipeDirection

Salah satu nilai enumerasi yang menentukan arah pipa.

options

PipeOptions

Salah satu nilai enumerasi yang menentukan cara membuka atau membuat pipa.

impersonationLevel

TokenImpersonationLevel

Salah satu nilai enumerasi yang menentukan tingkat peniruan keamanan.

inheritability

HandleInheritability

Salah satu nilai enumerasi yang menentukan apakah handel yang mendasar akan diwariskan oleh proses anak.

Pengecualian

ArgumentNullException

pipeName atau serverName adalah null.

ArgumentException

pipeName atau serverName adalah string panjang nol.

ArgumentOutOfRangeException

pipeName diatur ke "anonim".

-atau-

direction bukan nilai yang valid PipeDirection .

-atau-

options bukan nilai yang valid PipeOptions .

-atau-

impersonationLevel bukan nilai yang valid TokenImpersonationLevel .

-atau-

inheritability bukan nilai yang valid HandleInheritability .