ChannelServices.RegisterChannel Methode

Definition

Namespace:

System.Runtime.Remoting.Channels

Assembly:

mscorlib.dll

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

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

Parameter

chnl

IChannel

Der zu registrierende Channel.

Attribute

ObsoleteAttribute

Ausnahmen

ArgumentNullException

Der chnl-Parameter ist null.

RemotingException

Der Channel wurde bereits registriert.

SecurityException

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 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 ist 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 von ihnen über Konfigurationseigenschaften angeben.

Weitere Informationen zu Kanalkonfigurationseigenschaften finden Sie unter HttpChannel, und <Kanalelement> (Vorlage).

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

ArgumentNullException

Der chnl-Parameter ist null.

RemotingException

Der Channel wurde bereits registriert.

SecurityException

Mindestens einer der Aufrufer an höherer Position im Aufrufstapel verfügt nicht über die Berechtigung zum Konfigurieren von Remotetypen und Channels.

NotSupportedException

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 ist 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 von ihnen über Konfigurationseigenschaften angeben.

Weitere Informationen zu Kanalkonfigurationseigenschaften finden Sie unter Eigenschaften der Kanal- und Formatiererkonfiguration und <des Kanalelements> (Vorlage).

Wenn der ensureSecurity Parameter auf truefestgelegt ist, bestimmt das Remotingsystem, ob der Kanal implementiert ISecurableChannelund wenn ja, die Verschlüsselung und digitale Signaturen aktiviert. Eine Ausnahme wird ausgelöst, wenn der Kanal nicht implementiert ISecurableChannel.

Hinweis

Die Einstellung ensureSecurity auf true löst einen für den HttpServerChannel Kanal auf allen Plattformen ausRemotingException. Sie müssen Ihren Dienst in IIS hosten, wenn Sie einen sicheren HTTP-Kanal verwenden möchten.