IChannel Antarmuka
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menentukan antarmuka dasar yang harus diterapkan oleh semua objek saluran. Ini mengharuskan mereka mengimplementasikan antarmuka mesin status yang dibagikan oleh semua objek komunikasi dan menerapkan metode untuk mengambil objek dari tumpukan saluran.
public interface class IChannel : System::ServiceModel::ICommunicationObject
public interface IChannel : System.ServiceModel.ICommunicationObject
type IChannel = interface
interface ICommunicationObject
Public Interface IChannel
Implements ICommunicationObject
- Turunan
- Penerapan
Keterangan
Penting
Memanggil metode 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.
Saluran harus memenuhi kontrak mesin status seperti yang didefinisikan oleh ICommunicationObject antarmuka.
Antarmuka IChannel menambahkan
GetProperty metode ke ICommunicationObject antarmuka. Metode ini menyediakan mekanisme untuk mengambil properti dari tumpukan saluran terlepas dari tempat di tumpukan properti tersebut berada. Istilah "properti" dalam nama metode mengacu pada sepotong informasi milik salah satu saluran dalam tumpukan. Jenis CLR untuk properti tersebut ditentukan oleh T
. Metode pengambilan ini juga digunakan pada pabrik saluran dan pendengar saluran.
IChannel
diwarisi oleh masing-masing antarmuka saluran yang terkait dengan pola pertukaran pesan dasar:
IInputChannel untuk menerima pesan.
IOutputChannel untuk mengirim pesan.
IRequestChannel untuk mengirim permintaan.
IReplyChannel untuk mengirim balasan.
IDuplexChannel untuk olahpesan dua arah.
Properti
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) |
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) |
GetProperty<T>() |
Mengembalikan objek jenis yang diminta, jika ada, dari lapisan yang sesuai di tumpukan saluran. |
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 tertentu. (Diperoleh dari ICommunicationObject) |
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) |
Metode Ekstensi
CloseHelperAsync(ICommunicationObject, TimeSpan) |
Menentukan antarmuka dasar yang harus diterapkan oleh semua objek saluran. Ini mengharuskan mereka mengimplementasikan antarmuka mesin status yang dibagikan oleh semua objek komunikasi dan menerapkan metode untuk mengambil objek dari tumpukan saluran. |
OpenHelperAsync(ICommunicationObject, TimeSpan) |
Menentukan antarmuka dasar yang harus diterapkan oleh semua objek saluran. Ini mengharuskan mereka mengimplementasikan antarmuka mesin status yang dibagikan oleh semua objek komunikasi dan menerapkan metode untuk mengambil objek dari tumpukan saluran. |