IChannel Antarmuka

Definisi

Ruang nama:

System.ServiceModel.Channels

Rakitan:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Sumber:

IChannel.cs

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

System.ServiceModel.Channels.ChannelBase

System.ServiceModel.Channels.IAsyncInputChannel

System.ServiceModel.Channels.IAsyncOutputChannel

System.ServiceModel.Channels.IAsyncOutputSessionChannel

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputChannel

System.ServiceModel.Channels.IInputSessionChannel

System.ServiceModel.Channels.IOutputChannel

System.ServiceModel.Channels.IOutputSessionChannel

System.ServiceModel.Channels.IReplyChannel

System.ServiceModel.Channels.IReplySessionChannel

System.ServiceModel.Channels.IRequestChannel

System.ServiceModel.Channels.IRequestSessionChannel

System.ServiceModel.Channels.OutputChannel

System.ServiceModel.Channels.RequestChannel

System.ServiceModel.Channels.ServiceChannelProxy

System.ServiceModel.Channels.TransportDuplexSessionChannel

System.ServiceModel.ClientBase<TChannel>.ChannelBase<T>

System.ServiceModel.Federation.WSTrustChannel

System.ServiceModel.IClientChannel

System.ServiceModel.IContextChannel

System.ServiceModel.IDuplexContextChannel

System.ServiceModel.IServiceChannel

System.ServiceModel.Security.WSTrustChannel

Penerapan

ICommunicationObject

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.