DispatchRuntime Třída

Definice

Obor názvů:

System.ServiceModel.Dispatcher

Sestavení:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v10.0.652802

Zdroj:

DispatchRuntime.cs

Zveřejňuje vlastnosti, které lze použít ke změně výchozího chování služby, a také k připojení vlastních objektů, které mohou změnit způsob transformace příchozích zpráv na objekty a odesílání do operací. Tuto třídu nelze zdědit.

public ref class DispatchRuntime sealed

public sealed class DispatchRuntime

type DispatchRuntime = class

Public NotInheritable Class DispatchRuntime

Dědičnost

Object

DispatchRuntime

Poznámky

DispatchRuntime Třídu použijte buď ke změně výchozího chování služby nebo jednotlivého koncového bodu, nebo k vložení objektů, které implementují vlastní úpravy jednoho nebo obou následujících procesů služby:

1. Transformace příchozích zpráv na objekty a uvolnění těchto objektů jako metody vyvolání objektu služby.

2. Transformace objektů přijatých z odpovědi na vyvolání operace služby do odchozích zpráv.

Ve Službě Windows Communication Foundation (WCF) jsou kanály a dispečery koncových bodů komponentami služby zodpovědné za přijímání nových kanálů, příjem zpráv, odesílání metod a vyvolání a zpracování odpovědí. Každý koncový bod vystavený objektem ServiceHost má jednoho dispečera koncového bodu a přidružený dispečer kanálu. Každý klient, který se účastní duplexní komunikace, má také dispečer koncového bodu a dispečer kanálu pro každý koncový bod zpětného volání.

DispatchRuntime vám umožňuje zachytit a rozšířit dispečera kanálu nebo koncového bodu pro všechny zprávy v rámci určitého kontraktu, a to i v případě, že není zpráva rozpoznána. Když přijde zpráva, která neodpovídá žádným zprávám deklarovaným ve smlouvě, je odeslána do operace, která byla vrácena UnhandledDispatchOperation vlastností. Pokud chcete zachytit nebo rozšířit všechny zprávy pro konkrétní operaci, podívejte se na třídu DispatchOperation.

Čtyři hlavní oblasti rozšiřitelnosti dispečera jsou vystaveny třídou DispatchRuntime.

1. Komponenty dispatch používají vlastnosti a vlastnosti DispatchRuntime přidruženého dispečera kanálu vráceného ChannelDispatcher vlastností k přizpůsobení způsobu, jakým dispečer kanálu přijímá a ukončuje kanály. Tato kategorie obsahuje vlastnosti ChannelInitializers a InputSessionShutdownHandlers.

2. Součásti zpráv jsou přizpůsobené pro každou zpracovanou zprávu. Tato kategorie zahrnuje vlastnosti MessageInspectors, OperationSelector, Operations a ErrorHandlers.

3. Komponenty instance přizpůsobují vytváření, životnost a odstraňování instancí typu služby. Další informace o životnosti objektů služby naleznete v InstanceContextMode vlastnosti. Tato kategorie zahrnuje vlastnosti InstanceContextInitializers a InstanceProvider.

4. Součásti související se zabezpečením můžou používat následující vlastnosti:

   • SecurityAuditLogLocation označuje, kde se zapisují události auditu.

   • ImpersonateCallerForAllOperations určuje, jestli se služba pokusí napodobit pomocí přihlašovacích údajů z příchozí zprávy.

   • MessageAuthenticationAuditLevel určuje, zda jsou události úspěšného ověřování zpráv zapsány do protokolu událostí určeného SecurityAuditLogLocation.

   • PrincipalPermissionMode určuje, jak CurrentPrincipal je vlastnost nastavena.

   • ServiceAuthorizationAuditLevel určuje, jak se provádí auditování událostí autorizace.

   • SuppressAuditFailure určuje, zda se mají potlačit nekritické výjimky, ke kterým dochází během procesu protokolování.

Vlastní rozšiřující objekty jsou obvykle přiřazeny k DispatchRuntime vlastnosti nebo vloženy do kolekce chováním služby (objekt, který implementuje IServiceBehavior), chování kontraktu (objekt, který implementuje IContractBehavior) nebo chování koncového bodu (objekt, který implementuje IEndpointBehavior). Pak se objekt chování instalace přidá do příslušné kolekce chování buď programově, nebo implementací vlastního BehaviorExtensionElement objektu, který umožní vložení chování pomocí konfiguračního souboru aplikace.

Vlastnosti

Name	Description
ChannelDispatcher	ChannelDispatcher Získá pro tento dispečer runtime objekt.
MessageInspectors	Získá kolekci IDispatchMessageInspector objektů, které lze použít k připojení vlastního inspektoru zpráv pro všechny příchozí a odchozí zprávy přes koncový bod.