IInputChannel Antarmuka

Definisi

Ruang nama:

System.ServiceModel.Channels

Rakitan:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Sumber:

IInputChannel.cs

Menentukan antarmuka yang harus diterapkan saluran untuk menerima pesan.

public interface class IInputChannel : System::ServiceModel::Channels::IChannel

public interface IInputChannel : System.ServiceModel.Channels.IChannel

type IInputChannel = interface
    interface IChannel
    interface ICommunicationObject

Public Interface IInputChannel
Implements IChannel

Turunan

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputSessionChannel

Penerapan

IChannel ICommunicationObject

Keterangan

Penting

Metode panggilan dari kelas yang mengimplementasikan antarmuka ini dengan data yang tidak tepercaya adalah risiko keamanan. Panggil metode dari kelas yang mengimplementasikan antarmuka ini hanya dengan data tepercaya. Untuk informasi selengkapnya, lihat Memvalidasi Semua Input.

Kontrak ini IInputChannel mencakup varian penerimaan yang sinkron dan asinkron, fungsionalitas try-to-receive, dan wait-for-a-message.

Model penarikan biasanya digunakan dengan IInputChannel pesan untuk menerima: Anda memanggil Receive (untuk "menarik" pesan keluar dari saluran) lalu menunggu pesan tiba. Pola penggunaan alternatif adalah memanggil BeginWaitForMessage(TimeSpan, AsyncCallback, Object) atau BeginWaitForMessage(TimeSpan, AsyncCallback, Object), lalu memanggil Receive(TimeSpan). Pendekatan ini umum untuk penggunaan transaksi di mana Anda memulai transaksi antara panggilan ke WaitForMessage(TimeSpan) dan Receive.

IInputChannel belum tentu terikat ke satu pengirim. Saluran dan antarmuka saluran lain dapat memberikan korelasi antara pengirim tertentu dan IInputChannel, tetapi kontrak dasar tidak membuat batasan tersebut. Implementasi dapat membuat baru IInputChannel untuk setiap pesan atau menggunakan kembali hal yang sama IInputChannel untuk beberapa pesan dan pengirim.

Properti

LocalAddress	Mendapatkan alamat tempat saluran input menerima pesan.
State	Mendapatkan status objek berorientasi komunikasi saat ini. (Diperoleh dari ICommunicationObject)

Metode

Abort()	Menyebabkan objek komunikasi segera beralih dari statusnya saat ini ke status tertutup. (Diperoleh dari ICommunicationObject)
BeginClose(AsyncCallback, Object)	Memulai operasi asinkron untuk menutup objek komunikasi. (Diperoleh dari ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Memulai operasi asinkron untuk menutup objek komunikasi dengan batas waktu yang ditentukan. (Diperoleh dari ICommunicationObject)
BeginOpen(AsyncCallback, Object)	Memulai operasi asinkron untuk membuka objek komunikasi. (Diperoleh dari ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Memulai operasi asinkron untuk membuka objek komunikasi dalam interval waktu tertentu. (Diperoleh dari ICommunicationObject)
BeginReceive(AsyncCallback, Object)	Memulai operasi asinkron untuk menerima pesan yang memiliki objek status yang terkait dengannya.
BeginReceive(TimeSpan, AsyncCallback, Object)	Memulai operasi asinkron untuk menerima pesan yang memiliki waktu habis yang ditentukan dan objek status yang terkait dengannya.
BeginTryReceive(TimeSpan, AsyncCallback, Object)	Memulai operasi asinkron untuk menerima pesan yang memiliki waktu habis yang ditentukan dan objek status yang terkait dengannya.
BeginWaitForMessage(TimeSpan, AsyncCallback, Object)	Memulai operasi wait-for-a-message-to-arrive asinkron yang memiliki waktu habis dan objek status yang ditentukan yang terkait dengannya.
Close()	Menyebabkan objek komunikasi beralih dari statusnya saat ini ke status tertutup. (Diperoleh dari ICommunicationObject)
Close(TimeSpan)	Menyebabkan objek komunikasi beralih dari statusnya saat ini ke status tertutup. (Diperoleh dari ICommunicationObject)
EndClose(IAsyncResult)	Menyelesaikan operasi asinkron untuk menutup objek komunikasi. (Diperoleh dari ICommunicationObject)
EndOpen(IAsyncResult)	Menyelesaikan operasi asinkron untuk membuka objek komunikasi. (Diperoleh dari ICommunicationObject)
EndReceive(IAsyncResult)	Menyelesaikan operasi asinkron untuk menerima pesan.
EndTryReceive(IAsyncResult, Message)	Menyelesaikan operasi asinkron yang ditentukan untuk menerima pesan.
EndWaitForMessage(IAsyncResult)	Menyelesaikan operasi wait-for-a-message asinkron yang ditentukan.
GetProperty<T>()	Mengembalikan objek jenis yang diminta, jika ada, dari lapisan yang sesuai di tumpukan saluran. (Diperoleh dari IChannel)
Open()	Menyebabkan objek komunikasi beralih dari status yang dibuat ke status dibuka. (Diperoleh dari ICommunicationObject)
Open(TimeSpan)	Menyebabkan objek komunikasi beralih dari status yang dibuat ke status dibuka dalam interval waktu yang ditentukan. (Diperoleh dari ICommunicationObject)
Receive()	Mengembalikan pesan yang diterima, jika tersedia. Jika pesan tidak tersedia, blokir untuk interval waktu default.
Receive(TimeSpan)	Mengembalikan pesan yang diterima, jika tersedia. Jika pesan tidak tersedia, blokir untuk interval waktu tertentu.
TryReceive(TimeSpan, Message)	Mencoba menerima pesan dalam interval waktu tertentu.
WaitForMessage(TimeSpan)	Mengembalikan nilai yang menunjukkan apakah pesan telah tiba dalam interval waktu tertentu.

Acara

Closed	Terjadi ketika objek komunikasi menyelesaikan transisinya dari status penutupan ke status tertutup. (Diperoleh dari ICommunicationObject)
Closing	Terjadi ketika objek komunikasi pertama kali memasuki status penutupan. (Diperoleh dari ICommunicationObject)
Faulted	Terjadi ketika objek komunikasi pertama kali memasuki status rusak. (Diperoleh dari ICommunicationObject)
Opened	Terjadi ketika objek komunikasi menyelesaikan transisinya dari status pembukaan ke status dibuka. (Diperoleh dari ICommunicationObject)
Opening	Terjadi ketika objek komunikasi pertama kali memasuki status pembukaan. (Diperoleh dari ICommunicationObject)