ChannelServices.RegisterChannel Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
| Nazwa | Opis |
|---|---|
| RegisterChannel(IChannel) |
Przestarzałe.
Rejestruje kanał z usługami kanału. RegisterChannel(IChannel) jest przestarzałe. Zamiast tego użyj RegisterChannel(IChannel, Boolean). |
| RegisterChannel(IChannel, Boolean) |
Rejestruje kanał z usługami kanału. |
RegisterChannel(IChannel)
Uwaga
Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.
Rejestruje kanał z usługami kanału. RegisterChannel(IChannel) jest przestarzałe. Zamiast tego użyj RegisterChannel(IChannel, Boolean).
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 -> unitPublic Shared Sub RegisterChannel (chnl As IChannel)Parametry
- chnl
- IChannel
Kanał do zarejestrowania.
- Atrybuty
Wyjątki
Parametr chnl jest null.
Kanał został już zarejestrowany.
Co najmniej jeden z wywołujących wyżej w stosie wywołań nie ma uprawnień do konfigurowania typów i kanałów komunikacji telefonicznej.
Uwagi
Uwaga / Notatka
RegisterChannel(IChannel) jest przestarzałe. Zamiast tego użyj RegisterChannel(IChannel, Boolean).
Metoda RegisterChannel pobiera interfejs IChannel z obiektu kanału. Kanał ChannelName musi być unikatowy lub kanał musi być anonimowy. Kanał jest anonimowy, jeśli IChannel.ChannelName parametr jest ustawiony na null wartość lub Empty przy użyciu name właściwości konfiguracji.
Nie można zarejestrować dwóch kanałów o tej samej nazwie w pliku AppDomain. Domyślnie nazwa elementu HttpChannel to "http", a nazwa obiektu TcpChannel to "tcp". W związku z tym, jeśli chcesz zarejestrować dwa kanały tego samego typu, musisz określić inną nazwę dla jednej z nich za pomocą właściwości konfiguracji.
Aby uzyskać więcej informacji na temat właściwości konfiguracji kanału, zobacz HttpChannel.
Dotyczy
RegisterChannel(IChannel, Boolean)
Rejestruje kanał z usługami kanału.
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 -> unitPublic Shared Sub RegisterChannel (chnl As IChannel, ensureSecurity As Boolean)Parametry
- chnl
- IChannel
Kanał do zarejestrowania.
- ensureSecurity
- Boolean
true zapewnia włączenie zabezpieczeń; w przeciwnym razie false. Ustawienie wartości na false wartość nie wpływa na ustawienie zabezpieczeń na kanale TCP lub IPC.
Wyjątki
Parametr chnl jest null.
Kanał został już zarejestrowany.
Co najmniej jeden z wywołujących wyżej w stosie wywołań nie ma uprawnień do konfigurowania typów i kanałów komunikacji telefonicznej.
Nieobsługiwane dla programu HttpServerChannel. Hostuj usługę przy użyciu Internet Information Services (IIS), jeśli potrzebujesz bezpiecznego kanału HTTP.
Uwagi
Metoda RegisterChannel(IChannel, Boolean) odbiera IChannel interfejs z obiektu kanału. Kanał ChannelName musi być unikatowy lub kanał musi być anonimowy. Kanał jest anonimowy, jeśli IChannel.ChannelName parametr jest ustawiony na null wartość lub Empty przy użyciu name właściwości konfiguracji.
Nie można zarejestrować dwóch kanałów o tej samej nazwie w pliku AppDomain. Domyślnie nazwa elementu HttpChannel to "http", a nazwa elementu TcpChannel to "tcp". W związku z tym, jeśli chcesz zarejestrować dwa kanały tego samego typu, musisz określić inną nazwę dla jednej z nich za pomocą właściwości konfiguracji.
ensureSecurity Jeśli parametr jest ustawiony na truewartość , system komunikacji automatycznej określa, czy kanał implementuje ISecurableChannelelement , a jeśli tak, włącza szyfrowanie i podpisy cyfrowe. Zgłaszany jest wyjątek, jeśli kanał nie implementuje ISecurableChannelelementu .
Uwaga / Notatka
Ustawienie ensureSecurity , aby zgłaszać RemotingExceptiontrue dla kanału HttpServerChannel na wszystkich platformach. Jeśli chcesz użyć bezpiecznego kanału HTTP, musisz hostować usługę w usługach IIS.
