ChannelServices.RegisterChannel Methode

Referenz

Definition

Namespace:: System.Runtime.Remoting.Channels

Assembly:: mscorlib.dll

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

Achtung

Use RegisterChannel(IChannel,Boolean)

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

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

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 aus einem Kanalobjekt. Der Kanal ChannelName muss eindeutig sein, oder der Kanal muss anonym sein. Ein Kanal ist anonym, wenn der IChannel.ChannelName Wert entweder oder Empty mithilfe der name Konfigurationseigenschaft festgelegt null 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 "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 HttpChannelund <channel> Element (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

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 der IChannel.ChannelName Wert entweder oder Empty mithilfe der name Konfigurationseigenschaft festgelegt null ist.

Weitere Informationen zu Kanalkonfigurationseigenschaften finden Sie unter Kanal- und Formatterkonfigurationseigenschaften und <channel> -element (Vorlage).

Wenn der Parameter auf true"Festgelegt" festgelegt ist, bestimmt das ensureSecurity Remotingsystem, ob der Kanal implementiert ISecurableChannelwird und falls ja, Verschlüsselung und digitale Signaturen ermöglicht. Eine Ausnahme wird ausgelöst, wenn der Kanal nicht implementiert wird ISecurableChannel.

Hinweis

Einstellung ensureSecurity zum true Auslösen eines RemotingException HttpServerChannel Kanals auf allen Plattformen. Sie müssen Ihren Dienst in IIS hosten, wenn Sie einen sicheren HTTP-Kanal verwenden möchten.

Gilt für: