ChannelServices.RegisterChannel Metode

Definisi

Ruang nama:

System.Runtime.Remoting.Channels

Rakitan:

mscorlib.dll

Overload

RegisterChannel(IChannel)	Kedaluwarsa. Mendaftarkan saluran dengan layanan saluran. RegisterChannel(IChannel) sudah usang. Harap gunakan RegisterChannel(IChannel, Boolean) sebagai gantinya.
RegisterChannel(IChannel, Boolean)	Mendaftarkan saluran dengan layanan saluran.

RegisterChannel(IChannel)

Perhatian

Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.

Mendaftarkan saluran dengan layanan saluran. RegisterChannel(IChannel) sudah usang. Harap gunakan RegisterChannel(IChannel, Boolean) sebagai gantinya.

public:
 static void RegisterChannel(System::Runtime::Remoting::Channels::IChannel ^ chnl);

[System.Obsolete("Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.", false)]
public static void RegisterChannel (System.Runtime.Remoting.Channels.IChannel chnl);

[<System.Obsolete("Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.", false)>]
static member RegisterChannel : System.Runtime.Remoting.Channels.IChannel -> unit

Public Shared Sub RegisterChannel (chnl As IChannel)

Parameter

chnl

IChannel

Saluran untuk mendaftar.

Atribut

ObsoleteAttribute

Pengecualian

ArgumentNullException

Parameternya chnl adalah null.

RemotingException

Saluran telah didaftarkan.

SecurityException

Setidaknya salah satu penelepon yang lebih tinggi di tumpukan panggilan tidak memiliki izin untuk mengonfigurasi jenis dan saluran jarak jauh.

Contoh

HttpChannel^ channel = gcnew HttpChannel( 9000 );
ChannelServices::RegisterChannel( channel, false );
RemotingConfiguration::RegisterWellKnownServiceType( SampleNamespace::SampleService::typeid, "MySampleService/SampleService::soap", WellKnownObjectMode::Singleton );
Console::WriteLine( "** Press enter to end the server process. **" );
Console::ReadLine();

HttpChannel channel = new HttpChannel(9000);
ChannelServices.RegisterChannel(channel);

RemotingConfiguration.RegisterWellKnownServiceType( typeof(SampleService),
"MySampleService/SampleService.soap", WellKnownObjectMode.Singleton);

Console.WriteLine("** Press enter to end the server process. **");
Console.ReadLine();

Dim channel As New HttpChannel(9000)
ChannelServices.RegisterChannel(channel)
RemotingConfiguration.RegisterWellKnownServiceType(GetType(SampleService), "MySampleService/SampleService.soap", WellKnownObjectMode.Singleton)

Console.WriteLine("** Press enter to end the server process. **")
Console.ReadLine()

Keterangan

Catatan

RegisterChannel(IChannel) sudah usang. Harap gunakan RegisterChannel(IChannel, Boolean) sebagai gantinya.

Metode ini RegisterChannel mengambil IChannel antarmuka dari objek saluran. Saluran ChannelName harus unik, atau saluran harus anonim. Saluran bersifat anonim jika IChannel.ChannelName diatur ke salah satu null atau Empty dengan menggunakan name properti konfigurasi.

Anda tidak dapat mendaftarkan dua saluran dengan nama yang sama dalam AppDomain. Secara default, nama adalah HttpChannel "http" dan nama adalah TcpChannel "tcp." Oleh karena itu, jika Anda ingin mendaftarkan dua saluran dengan jenis yang sama, Anda harus menentukan nama yang berbeda untuk salah satunya melalui properti konfigurasi.

Untuk informasi selengkapnya tentang properti konfigurasi saluran, lihat HttpChannelElemen , dan <saluran> (Templat).

RegisterChannel(IChannel, Boolean)

Mendaftarkan saluran dengan layanan saluran.

public:
 static void RegisterChannel(System::Runtime::Remoting::Channels::IChannel ^ chnl, bool ensureSecurity);

public static void RegisterChannel (System.Runtime.Remoting.Channels.IChannel chnl, bool ensureSecurity);

static member RegisterChannel : System.Runtime.Remoting.Channels.IChannel * bool -> unit

Public Shared Sub RegisterChannel (chnl As IChannel, ensureSecurity As Boolean)

Parameter

chnl

IChannel

Saluran untuk mendaftar.

ensureSecurity

Boolean

true memastikan bahwa keamanan diaktifkan; jika tidak false. Mengatur nilai ke false tidak memengaruhi pengaturan keamanan pada saluran TCP atau IPC.

Pengecualian

ArgumentNullException

Parameternya chnl adalah null.

RemotingException

Saluran telah didaftarkan.

SecurityException

Setidaknya salah satu penelepon yang lebih tinggi dalam tumpukan panggilan tidak memiliki izin untuk mengonfigurasi jenis dan saluran jarak jauh.

NotSupportedException

Tidak didukung untuk HttpServerChannel. Host layanan menggunakan Internet Information Services (IIS) jika Anda memerlukan saluran HTTP yang aman.

Keterangan

Metode RegisterChannel(IChannel, Boolean) menerima IChannel antarmuka dari objek saluran. Saluran ChannelName harus unik, atau saluran harus anonim. Saluran bersifat anonim jika IChannel.ChannelName diatur ke salah satu null atau Empty dengan menggunakan name properti konfigurasi.

Anda tidak dapat mendaftarkan dua saluran dengan nama yang sama dalam AppDomain. Secara default, nama adalah HttpChannel "http" dan nama TcpChannel adalah "tcp". Oleh karena itu, jika Anda ingin mendaftarkan dua saluran dengan jenis yang sama, Anda harus menentukan nama yang berbeda untuk salah satunya melalui properti konfigurasi.

Untuk informasi selengkapnya tentang properti konfigurasi saluran, lihat Properti Konfigurasi Saluran dan Formatter dan <> Elemen saluran (Templat).

ensureSecurity Jika parameter diatur ke true, sistem jarak jauh menentukan apakah saluran mengimplementasikan ISecurableChannel, dan jika demikian, mengaktifkan enkripsi dan tanda tangan digital. Pengecualian dilemparkan jika saluran tidak mengimplementasikan ISecurableChannel.

Catatan

Pengaturan ensureSecurity ke true melemparkan RemotingException untuk HttpServerChannel saluran di semua platform. Anda harus menghosting layanan Anda di IIS jika Anda ingin menggunakan saluran http yang aman.