DispatchRuntime Třída

Definice

Obor názvů:

System.ServiceModel.Dispatcher

Sestavení:

System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v8.0.0

Zdroj:

DispatchRuntime.cs

Zpřístupňuje vlastnosti, které lze použít k úpravě 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 dě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 Pomocí třídy můžete upravit výchozí chování služby nebo jednotlivého koncového bodu nebo vložit objekty, 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 volání metody na objekt služby.

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

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

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

Existují čtyři hlavní oblasti rozšiřitelnosti dispečera vystavené DispatchRuntime třídou :

1. Součásti dispatch používají vlastnosti DispatchRuntime a vlastnosti 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 zavírá kanály. Tato kategorie zahrnuje ChannelInitializers vlastnosti a InputSessionShutdownHandlers .

2. Součásti zpráv jsou přizpůsobené pro každou zpracovávanou zprávu. Tato kategorie zahrnuje MessageInspectorsvlastnosti , OperationSelector, Operationsa .ErrorHandlers

3. Komponenty instance přizpůsobují vytváření, životnost a vyřazení instancí typu služby. Další informace o životnostech objektů služby najdete ve InstanceContextMode vlastnosti . Tato kategorie zahrnuje InstanceContextInitializers vlastnosti a InstanceProvider .

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

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

   • ImpersonateCallerForAllOperations určuje, jestli se služba pokusí zosobnit pomocí přihlašovacích údajů poskytnutých příchozí zprávou.

   • MessageAuthenticationAuditLevel určuje, jestli se úspěšné události ověřování zpráv zapisují do protokolu událostí určeného parametrem SecurityAuditLogLocation.

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

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

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

Vlastní objekty rozšíření se obvykle přiřazují DispatchRuntime vlastnosti nebo se do kolekce vkládají chováním služby (objekt, který implementuje IServiceBehavior), chováním kontraktu (objekt, který implementuje IContractBehavior) nebo chováním 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žňuje vložit chování pomocí konfiguračního souboru aplikace.

Vlastnosti

ChannelDispatcher	ChannelDispatcher Získá pro tento dispečer běh-time 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 v rámci koncového bodu.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)