NamedPipeServerStream Kelas

Definisi

Ruang nama:

System.IO.Pipes

Rakitan:

System.IO.Pipes.dll

Sumber:

NamedPipeServerStream.cs

Mengekspos Stream di sekitar pipa bernama, mendukung operasi baca dan tulis yang sinkron dan asinkron.

public ref class NamedPipeServerStream sealed : System::IO::Pipes::PipeStream

public sealed class NamedPipeServerStream : System.IO.Pipes.PipeStream

type NamedPipeServerStream = class
    inherit PipeStream

Public NotInheritable Class NamedPipeServerStream
Inherits PipeStream

Warisan

Object

MarshalByRefObject

Stream

PipeStream

NamedPipeServerStream

Contoh

Contoh berikut menunjukkan cara untuk mengirim string dari proses induk ke proses anak di komputer yang sama menggunakan pipa bernama. Contoh ini membuat objek NamedPipeServerStream dalam proses induk dengan nilai PipeDirectionOut. Server kemudian menunggu objek NamedPipeClientStream dalam proses anak untuk menyambungkannya. Dalam contoh ini, kedua proses berada di komputer yang sama dan objek NamedPipeClientStream memiliki nilai PipeDirectionIn. Proses induk kemudian mengirim string yang disediakan pengguna ke proses turunan. String ditampilkan ke konsol.

Contoh ini untuk proses server, yang menggunakan kelas NamedPipeServerStream. Untuk seluruh contoh kode, termasuk kode untuk klien pipa dan server, lihat Cara: Menggunakan Pipa Bernama untuk Komunikasi Interprosces Jaringan.

using System;
using System.IO;
using System.IO.Pipes;

class PipeServer
{
    static void Main()
    {
        using (NamedPipeServerStream pipeServer =
            new NamedPipeServerStream("testpipe", PipeDirection.Out))
        {
            Console.WriteLine("NamedPipeServerStream object created.");

            // Wait for a client to connect
            Console.Write("Waiting for client connection...");
            pipeServer.WaitForConnection();

            Console.WriteLine("Client connected.");
            try
            {
                // Read user input and send that to the client process.
                using (StreamWriter sw = new StreamWriter(pipeServer))
                {
                    sw.AutoFlush = true;
                    Console.Write("Enter text: ");
                    sw.WriteLine(Console.ReadLine());
                }
            }
            // Catch the IOException that is raised if the pipe is broken
            // or disconnected.
            catch (IOException e)
            {
                Console.WriteLine("ERROR: {0}", e.Message);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Pipes

Class PipeServer

    Shared Sub Main()
        Dim pipeServer As New NamedPipeServerStream("testpipe", PipeDirection.Out)

        Console.WriteLine("NamedPipeServerStream object created.")

        ' Wait for a client to connect
        Console.Write("Waiting for a client connection...")
        pipeServer.WaitForConnection()

        Console.WriteLine("Client connected.")
        Try
            'Read user input and send that to the client process.
            Dim sw As New StreamWriter(pipeServer)
            sw.AutoFlush = True
            Console.Write("Enter Text: ")
            sw.WriteLine(Console.ReadLine())
        Catch ex As IOException
            ' Catch the IOException that is raised if the pipe is broken
            ' or disconnected
            Console.WriteLine("ERROR: {0}", ex.Message)
        End Try
    End Sub
End Class

Keterangan

Pipa bernama menyediakan pipa satu arah atau dupleks untuk komunikasi antara server pipa dan satu atau beberapa klien pipa. Pipa bernama dapat digunakan untuk komunikasi antarproseksi secara lokal atau melalui jaringan. Satu nama pipa dapat dibagikan oleh beberapa objek NamedPipeClientStream.

Proses apa pun dapat bertindak sebagai server pipa atau klien bernama, atau keduanya.

Konstruktor

NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Menginisialisasi instans baru kelas NamedPipeServerStream dari handel pipa yang ditentukan.
NamedPipeServerStream(String)	Menginisialisasi instans baru kelas NamedPipeServerStream dengan nama pipa yang ditentukan.
NamedPipeServerStream(String, PipeDirection)	Menginisialisasi instans baru kelas NamedPipeServerStream dengan nama pipa dan arah pipa yang ditentukan.
NamedPipeServerStream(String, PipeDirection, Int32)	Menginisialisasi instans baru kelas NamedPipeServerStream dengan nama pipa, arah pipa, dan jumlah maksimum instans server yang ditentukan.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)	Menginisialisasi instans baru kelas NamedPipeServerStream dengan nama pipa, arah pipa, jumlah maksimum instans server, dan mode transmisi yang ditentukan.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)	Menginisialisasi instans baru kelas NamedPipeServerStream dengan nama pipa, arah pipa, jumlah maksimum instans server, mode transmisi, dan opsi pipa yang ditentukan.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)	Menginisialisasi instans baru kelas NamedPipeServerStream dengan nama pipa yang ditentukan, arah pipa, jumlah maksimum instans server, mode transmisi, opsi pipa, dan ukuran buffer masuk dan keluar yang ditentukan.

Bidang

MaxAllowedServerInstances

Mewakili jumlah maksimum instans server yang diizinkan sumber daya sistem.

Properti

CanRead	Mendapatkan nilai yang menunjukkan apakah aliran saat ini mendukung operasi baca. (Diperoleh dari PipeStream)
CanSeek	Mendapatkan nilai yang menunjukkan apakah aliran saat ini mendukung operasi pencarian. (Diperoleh dari PipeStream)
CanTimeout	Mendapatkan nilai yang menentukan apakah aliran saat ini dapat kehabisan waktu. (Diperoleh dari Stream)
CanWrite	Mendapatkan nilai yang menunjukkan apakah aliran saat ini mendukung operasi tulis. (Diperoleh dari PipeStream)
InBufferSize	Mendapatkan ukuran, dalam byte, dari buffer masuk untuk pipa. (Diperoleh dari PipeStream)
IsAsync	Mendapatkan nilai yang menunjukkan apakah objek PipeStream dibuka secara asinkron atau sinkron. (Diperoleh dari PipeStream)
IsConnected	Mendapatkan atau menetapkan nilai yang menunjukkan apakah objek PipeStream tersambung. (Diperoleh dari PipeStream)
IsHandleExposed	Mendapatkan nilai yang menunjukkan apakah handel ke objek PipeStream diekspos. (Diperoleh dari PipeStream)
IsMessageComplete	Mendapatkan nilai yang menunjukkan apakah ada lebih banyak data dalam pesan yang dikembalikan dari operasi baca terbaru. (Diperoleh dari PipeStream)
Length	Mendapatkan panjang aliran, dalam byte. (Diperoleh dari PipeStream)
OutBufferSize	Mendapatkan ukuran, dalam byte, dari buffer keluar untuk pipa. (Diperoleh dari PipeStream)
Position	Mendapatkan atau mengatur posisi aliran saat ini. (Diperoleh dari PipeStream)
ReadMode	Mendapatkan atau mengatur mode baca untuk objek PipeStream. (Diperoleh dari PipeStream)
ReadTimeout	Mendapatkan atau menetapkan nilai, dalam milidetik, yang menentukan berapa lama aliran akan mencoba membaca sebelum waktu habis. (Diperoleh dari Stream)
SafePipeHandle	Mendapatkan handel aman untuk ujung lokal pipa yang dienkapsulasi objek PipeStream saat ini. (Diperoleh dari PipeStream)
TransmissionMode	Mendapatkan mode transmisi pipa yang didukung oleh pipa saat ini. (Diperoleh dari PipeStream)
WriteTimeout	Mendapatkan atau menetapkan nilai, dalam milidetik, yang menentukan berapa lama aliran akan mencoba menulis sebelum waktu habis. (Diperoleh dari Stream)

Metode

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Memulai operasi baca asinkron. (Diperoleh dari PipeStream)
BeginWaitForConnection(AsyncCallback, Object)	Memulai operasi asinkron untuk menunggu klien tersambung.
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Memulai operasi penulisan asinkron. (Diperoleh dari PipeStream)
CheckPipePropertyOperations()	Memverifikasi bahwa pipa dalam keadaan yang tepat untuk mendapatkan atau mengatur properti. (Diperoleh dari PipeStream)
CheckReadOperations()	Memverifikasi bahwa pipa dalam status terhubung untuk operasi baca. (Diperoleh dari PipeStream)
CheckWriteOperations()	Memverifikasi bahwa pipa dalam status terhubung untuk operasi tulis. (Diperoleh dari PipeStream)
Close()	Menutup aliran saat ini dan merilis sumber daya apa pun (seperti soket dan handel file) yang terkait dengan aliran saat ini. Alih-alih memanggil metode ini, pastikan aliran dibuang dengan benar. (Diperoleh dari Stream)
CopyTo(Stream)	Membaca byte dari aliran saat ini dan menulisnya ke aliran lain. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyTo(Stream, Int32)	Membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan ukuran buffer tertentu. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream, CancellationToken)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan token pembatalan tertentu. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream, Int32)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan ukuran buffer tertentu. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream, Int32, CancellationToken)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan ukuran buffer dan token pembatalan yang ditentukan. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
CreateWaitHandle()	Kedaluwarsa. Mengalokasikan objek WaitHandle. (Diperoleh dari Stream)
Disconnect()	Memutuskan sambungan sambungan saat ini.
Dispose()	Merilis semua sumber daya yang digunakan oleh Stream. (Diperoleh dari Stream)
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang digunakan oleh kelas PipeStream dan secara opsional merilis sumber daya terkelola. (Diperoleh dari PipeStream)
DisposeAsync()	Secara asinkron merilis sumber daya yang tidak dikelola yang digunakan oleh Stream. (Diperoleh dari Stream)
EndRead(IAsyncResult)	Mengakhiri permintaan baca asinkron yang tertunda. (Diperoleh dari PipeStream)
EndWaitForConnection(IAsyncResult)	Mengakhiri operasi asinkron untuk menunggu klien tersambung.
EndWrite(IAsyncResult)	Mengakhiri permintaan tulis asinkron yang tertunda. (Diperoleh dari PipeStream)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Finalize()	Merilis sumber daya yang tidak dikelola dan melakukan operasi pembersihan lainnya sebelum instans NamedPipeServerStream diklaim kembali oleh pengumpulan sampah.
Flush()	Menghapus buffer untuk aliran saat ini dan menyebabkan data buffer ditulis ke perangkat yang mendasar. (Diperoleh dari PipeStream)
FlushAsync()	Secara asinkron menghapus semua buffer untuk aliran ini dan menyebabkan data yang di-buffer ditulis ke perangkat yang mendasar. (Diperoleh dari Stream)
FlushAsync(CancellationToken)	Secara asinkron menghapus buffer untuk aliran saat ini dan menyebabkan data buffer ditulis ke perangkat yang mendasar. (Diperoleh dari PipeStream)
GetAccessControl()	Mendapatkan objek PipeSecurity yang merangkum entri daftar kontrol akses (ACL) untuk pipa yang dijelaskan oleh objek PipeStream saat ini. (Diperoleh dari PipeStream)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetImpersonationUserName()	Mendapatkan nama pengguna klien di ujung pipa lainnya.
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
InitializeHandle(SafePipeHandle, Boolean, Boolean)	Menginisialisasi objek PipeStream dari objek SafePipeHandle yang ditentukan. (Diperoleh dari PipeStream)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
ObjectInvariant()	Kedaluwarsa. Menyediakan dukungan untuk Contract. (Diperoleh dari Stream)
Read(Byte[], Int32, Int32)	Membaca blok byte dari aliran dan menulis data ke buffer tertentu yang dimulai pada posisi tertentu untuk panjang yang ditentukan. (Diperoleh dari PipeStream)
Read(Span<Byte>)	Membaca urutan byte dari aliran saat ini, menulisnya ke array byte, dan memajukan posisi dalam aliran dengan jumlah byte yang dibaca. (Diperoleh dari PipeStream)
ReadAsync(Byte[], Int32, Int32)	Secara asinkron membaca urutan byte dari aliran saat ini dan memajukan posisi dalam aliran dengan jumlah byte yang dibaca. (Diperoleh dari Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Secara asinkron membaca urutan byte dari aliran saat ini ke array byte yang dimulai pada posisi tertentu untuk jumlah byte tertentu, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan. (Diperoleh dari PipeStream)
ReadAsync(Memory<Byte>, CancellationToken)	Secara asinkron membaca urutan byte dari aliran saat ini, menulisnya ke rentang memori byte, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan. (Diperoleh dari PipeStream)
ReadAtLeast(Span<Byte>, Int32, Boolean)	Membaca setidaknya jumlah minimum byte dari aliran saat ini dan memajukan posisi dalam aliran dengan jumlah byte yang dibaca. (Diperoleh dari Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	Secara asinkron membaca setidaknya jumlah minimum byte dari aliran saat ini, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
ReadByte()	Membaca byte dari pipa. (Diperoleh dari PipeStream)
ReadExactly(Byte[], Int32, Int32)	Membaca count jumlah byte dari aliran saat ini dan memajukan posisi dalam aliran. (Diperoleh dari Stream)
ReadExactly(Span<Byte>)	Membaca byte dari aliran saat ini dan memajukan posisi dalam aliran hingga buffer terisi. (Diperoleh dari Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Membaca secara asinkron count jumlah byte dari aliran saat ini, memajukan posisi dalam aliran, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Membaca byte secara asinkron dari aliran saat ini, memajukan posisi dalam aliran hingga buffer terisi, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
RunAsClient(PipeStreamImpersonationWorker)	Memanggil delegasi saat meniru klien.
Seek(Int64, SeekOrigin)	Mengatur posisi aliran saat ini ke nilai yang ditentukan. (Diperoleh dari PipeStream)
SetAccessControl(PipeSecurity)	Menerapkan entri daftar kontrol akses (ACL) yang ditentukan oleh objek PipeSecurity ke pipa yang ditentukan oleh objek PipeStream saat ini. (Diperoleh dari PipeStream)
SetLength(Int64)	Mengatur panjang aliran saat ini ke nilai yang ditentukan. (Diperoleh dari PipeStream)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
WaitForConnection()	Menunggu klien tersambung ke objek NamedPipeServerStream ini.
WaitForConnectionAsync()	Secara asinkron menunggu klien terhubung ke objek NamedPipeServerStream ini.
WaitForConnectionAsync(CancellationToken)	Secara asinkron menunggu klien terhubung ke objek NamedPipeServerStream ini dan memantau permintaan pembatalan.
WaitForPipeDrain()	Menunggu ujung pipa lainnya membaca semua byte yang dikirim. (Diperoleh dari PipeStream)
Write(Byte[], Int32, Int32)	Menulis blok byte ke aliran saat ini menggunakan data dari buffer. (Diperoleh dari PipeStream)
Write(ReadOnlySpan<Byte>)	Menulis urutan byte ke aliran saat ini dan memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis. (Diperoleh dari PipeStream)
WriteAsync(Byte[], Int32, Int32)	Secara asinkron menulis urutan byte ke aliran saat ini dan memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis. (Diperoleh dari Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Secara asinkron menulis jumlah byte tertentu dari array byte yang dimulai pada posisi tertentu, memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis, dan memantau permintaan pembatalan. (Diperoleh dari PipeStream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Secara asinkron menulis urutan byte ke aliran saat ini, memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis, dan memantau permintaan pembatalan. (Diperoleh dari PipeStream)
WriteByte(Byte)	Menulis byte ke aliran saat ini. (Diperoleh dari PipeStream)

Metode Ekstensi

CopyToAsync(Stream, PipeWriter, CancellationToken)	Secara asinkron membaca byte dari Stream dan menulisnya ke PipeWriteryang ditentukan , menggunakan token pembatalan.
GetAccessControl(PipeStream)	Mengembalikan informasi keamanan aliran pipa.
SetAccessControl(PipeStream, PipeSecurity)	Mengubah atribut keamanan aliran pipa yang ada.
ConfigureAwait(IAsyncDisposable, Boolean)	Mengonfigurasi bagaimana menunggu tugas yang dikembalikan dari asinkron sekali pakai akan dilakukan.