ChannelServices.RegisterChannel Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.Remoting.Channels

Zestaw:: mscorlib.dll

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

RegisterChannel(IChannel)	Nieaktualne. Nieaktualne. Rejestruje kanał w usługach kanału. RegisterChannel(IChannel) jest przestarzałe. Użyj RegisterChannel(IChannel, Boolean) zamiast tego.
RegisterChannel(IChannel, Boolean)	Rejestruje kanał w usługach kanału.

RegisterChannel(IChannel)

Przestroga

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

Przestroga

Use RegisterChannel(IChannel,Boolean)

Rejestruje kanał w usługach kanału. RegisterChannel(IChannel) jest przestarzałe. Użyj RegisterChannel(IChannel, Boolean) zamiast tego.

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

[System.Obsolete("Use RegisterChannel(IChannel,Boolean)")]
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

[<System.Obsolete("Use RegisterChannel(IChannel,Boolean)")>]
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 to 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 komunikacji telefonicznej i kanałów.

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łe. Użyj RegisterChannel(IChannel, Boolean) zamiast tego.

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 lub null Empty przy użyciu właściwości konfiguracji.

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

Dotyczy

RegisterChannel(IChannel, Boolean)

Rejestruje kanał w usługach 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 -> 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 wartość nie wpływa na ustawienie zabezpieczeń na kanale TCP lub IPC.

Wyjątki

ArgumentNullException

Parametr chnl to 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 komunikacji telefonicznej i kanałów.

NotSupportedException

Nieobsługiwane dla HttpServerChannelprogramu . 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 właściwość jest ustawiona name na lub null Empty przy użyciu właściwości konfiguracji.

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

ensureSecurity Jeśli parametr jest ustawiony na true, system komunikacji zdalnie określa, czy kanał implementuje ISecurableChannel, 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ć true wartość dla RemotingException kanału HttpServerChannel na wszystkich platformach. Musisz hostować usługę w usługach IIS, jeśli chcesz użyć bezpiecznego kanału http.

Dotyczy