ChannelServices.RegisterChannel Metoda

Definicja

Przestrzeń nazw:

System.Runtime.Remoting.Channels

Zestaw:

mscorlib.dll

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

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

Parametry

chnl

IChannel

Kanał do zarejestrowania.

Atrybuty

ObsoleteAttribute

Wyjątki

ArgumentNullException

Parametr chnl ma wartość null.

RemotingException

Kanał został już zarejestrowany.

SecurityException

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

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

ArgumentNullException

Parametr chnl ma wartość null.

RemotingException

Kanał został już zarejestrowany.

SecurityException

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.

NotSupportedException

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.