ChannelServices.RegisterChannel Metode
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.
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);
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);
static member RegisterChannel : System.Runtime.Remoting.Channels.IChannel -> unit
[<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
Pengecualian
Parameternya chnl
adalah null
.
Saluran telah didaftarkan.
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).
Berlaku untuk
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
Parameternya chnl
adalah null
.
Saluran telah didaftarkan.
Setidaknya salah satu penelepon yang lebih tinggi dalam tumpukan panggilan tidak memiliki izin untuk mengonfigurasi jenis dan saluran jarak jauh.
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.