Udostępnij za pośrednictwem


ChannelServices.RegisterChannel Metoda

Definicja

Przeciążenia

RegisterChannel(IChannel)
Przestarzałe.

Rejestruje kanał w usługach kanałowych. RegisterChannel(IChannel) jest przestarzały. Zamiast tego użyj polecenia RegisterChannel(IChannel, Boolean) .

RegisterChannel(IChannel, Boolean)

Rejestruje kanał w usługach kanałowych.

RegisterChannel(IChannel)

Przestroga

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

Rejestruje kanał w usługach kanałowych. RegisterChannel(IChannel) jest przestarzały. Zamiast tego użyj polecenia 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 -> unit
Public Shared Sub RegisterChannel (chnl As IChannel)

Parametry

chnl
IChannel

Kanał do zarejestrowania.

Atrybuty

Wyjątki

Parametr chnl ma wartość 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.

Przykłady

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()

Uwagi

Uwaga

RegisterChannel(IChannel) jest przestarzały. Zamiast tego użyj polecenia RegisterChannel(IChannel, Boolean) .

Metoda RegisterChannel przyjmuje interfejs IChannel z obiektu kanału. Kanał ChannelName musi być unikatowy lub kanał musi być anonimowy. Kanał jest anonimowy, jeśli IChannel.ChannelName właściwość jest ustawiona name na null wartość lub Empty przy użyciu właściwości konfiguracji.

Nie można zarejestrować dwóch kanałów o tej samej nazwie w obiekcie AppDomain. Domyślnie nazwa obiektu HttpChannel to "http", a nazwa TcpChannel obiektu 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, i <channel> , element (szablon).

Dotyczy

RegisterChannel(IChannel, Boolean)

Rejestruje kanał w usługach kanałowych.

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)

Parametry

chnl
IChannel

Kanał do zarejestrowania.

ensureSecurity
Boolean

true zapewnia włączenie zabezpieczeń; w przeciwnym razie false. Ustawienie wartości false na nie wpływa na ustawienie zabezpieczeń w kanale TCP lub IPC.

Wyjątki

Parametr chnl ma wartość 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 w przypadku programu HttpServerChannel. Hostuj usługę przy użyciu usług 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 właściwość jest ustawiona name na null wartość lub Empty przy użyciu właściwości konfiguracji.

Nie można zarejestrować dwóch kanałów o tej samej nazwie w obiekcie AppDomain. Domyślnie nazwa obiektu HttpChannel to "http", a nazwa TcpChannel elementu 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 o właściwościach konfiguracji kanału, zobacz Właściwości konfiguracji kanału i formatteraoraz< element kanału> (szablon).

ensureSecurity Jeśli parametr jest ustawiony na truewartość , system komunikacji e-mail określa, czy kanał implementuje ISecurableChannelelement , a jeśli tak, włącza szyfrowanie i podpisy cyfrowe. Wyjątek jest zgłaszany, jeśli kanał nie implementuje ISecurableChannelelementu .

Uwaga

Ustawienie ensureSecurity , aby zgłaszać RemotingExceptiontrue wartość dla kanału HttpServerChannel na wszystkich platformach. Musisz hostować usługę w usługach IIS, jeśli chcesz użyć bezpiecznego kanału HTTP.

Dotyczy