ChannelServices.RegisterChannel Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
RegisterChannel(IChannel) |
Veraltet.
Registriert einen Channel bei den Channeldiensten. RegisterChannel(IChannel) ist veraltet. Verwenden Sie stattdessen RegisterChannel(IChannel, Boolean). |
RegisterChannel(IChannel, Boolean) |
Registriert einen Channel bei den Channeldiensten. |
RegisterChannel(IChannel)
Achtung
Use System.Runtime.Remoting.ChannelServices.RegisterChannel(IChannel chnl, bool ensureSecurity) instead.
Registriert einen Channel bei den Channeldiensten. RegisterChannel(IChannel) ist veraltet. Verwenden Sie stattdessen 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)
Parameter
- chnl
- IChannel
Der zu registrierende Channel.
- Attribute
Ausnahmen
Der chnl
-Parameter ist null
.
Der Channel wurde bereits registriert.
Mindestens einer der Aufrufer an höherer Position im Aufrufstapel verfügt nicht über die Berechtigung zum Konfigurieren von Remotetypen und Channels.
Beispiele
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()
Hinweise
Hinweis
RegisterChannel(IChannel) ist veraltet. Verwenden Sie stattdessen RegisterChannel(IChannel, Boolean).
Die RegisterChannel -Methode übernimmt die IChannel -Schnittstelle aus einem Kanalobjekt. Der Kanal ChannelName muss eindeutig sein, oder der Kanal muss anonym sein. Ein Kanal ist anonym, wenn entweder IChannel.ChannelName oder mithilfe der name
Konfigurationseigenschaft auf null
oder Empty festgelegt ist.
Sie können nicht zwei Kanäle mit demselben Namen in einem AppDomainregistrieren. Standardmäßig lautet der Name eines HttpChannel "http", und der Name eines TcpChannel ist "tcp". Wenn Sie also zwei Kanäle desselben Typs registrieren möchten, müssen Sie einen anderen Namen für einen dieser Kanäle über Konfigurationseigenschaften angeben.
Weitere Informationen zu Kanalkonfigurationseigenschaften finden Sie unter HttpChannel, und <Kanalelement> (Vorlage).
Gilt für:
RegisterChannel(IChannel, Boolean)
Registriert einen Channel bei den Channeldiensten.
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
Der zu registrierende Channel.
- ensureSecurity
- Boolean
true
stellt sicher, dass die Sicherheit aktiviert ist, andernfalls false
. Das Festlegen des Werts auf false
beeinflusst nicht die Sicherheitseinstellung auf dem TCP- oder IPC-Channel.
Ausnahmen
Der chnl
-Parameter ist null
.
Der Channel wurde bereits registriert.
Mindestens einer der Aufrufer an höherer Position im Aufrufstapel verfügt nicht über die Berechtigung zum Konfigurieren von Remotetypen und Channels.
Wird für HttpServerChannel nicht unterstützt. Hosten Sie den Dienst mit Internetinformationsdiensten (IIS), wenn Sie einen sicheren HTTP-Channel benötigen.
Hinweise
Die RegisterChannel(IChannel, Boolean) -Methode empfängt die IChannel -Schnittstelle von einem Kanalobjekt. Der Kanal ChannelName muss eindeutig sein, oder der Kanal muss anonym sein. Ein Kanal ist anonym, wenn entweder IChannel.ChannelName oder mithilfe der name
Konfigurationseigenschaft auf null
oder Empty festgelegt ist.
Sie können nicht zwei Kanäle mit demselben Namen in einem AppDomainregistrieren. Standardmäßig lautet der Name eines HttpChannel "http", und der Name eines TcpChannel ist "tcp". Wenn Sie also zwei Kanäle desselben Typs registrieren möchten, müssen Sie einen anderen Namen für einen dieser Kanäle über Konfigurationseigenschaften angeben.
Weitere Informationen zu Kanalkonfigurationseigenschaften finden Sie unter Konfigurationseigenschaften für Kanal und Formatter und <Kanalelement> (Vorlage).
Wenn der ensureSecurity
Parameter auf true
festgelegt ist, bestimmt das Remotingsystem, ob der Kanal implementiert ISecurableChannel, und wenn ja, die Verschlüsselung und digitale Signaturen aktiviert. Eine Ausnahme wird ausgelöst, wenn der Kanal nicht implementiert ISecurableChannel.
Hinweis
Wenn Sie ensureSecurity
auf festlegen, true
wird ein RemotingException für den HttpServerChannel Kanal auf allen Plattformen ausgelöst. Sie müssen Ihren Dienst in IIS hosten, wenn Sie einen sicheren HTTP-Kanal verwenden möchten.