Podelement filter elementu deviceFilters (schéma nastavení ASP.NET)

Článek
08/11/2011

Poskytuje funkci pro filtrování pro třídu MobileCapabilities.

<filter name="capability"
        compare="capabilityName"
        argument="argument" />
<filter name="capability"
        type="className"
        method="methodName" />

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
argument	Volitelný String atributu. Určuje argument, oproti kterému by měla být schopnost porovnávána. Pokud je definován atribut compare, je tento atribut požadován.
compare	Nepovinný atribut String. Určuje schopnosti prohlížeče vyhodnocovacím filtrem kompatibility. Schopnost může být jakákoli integrovaná schopnost nebo název jiného vlastního vyhodnocovače schopností. Pokud zadáváte filtr porovnání, je požadován tento atribut.
method	Nepovinný atribut String. Určuje metodu, která dodává delegáta vyhodnocení. Používá se při zadání filtru delegáta vyhodnocení. Při zadání atributu type je tento atribut požadován a atributy compare a argument nelze zadat.
name	Požadovaný atribut typu String. Určuje jedinečný název, podle kterého je filtr identifikován. Poznámka Filtr se stejným názvem jako dříve definovaný filtr (dále v konfiguračním souboru nebo později v hierarchii konfiguračních souborů) přepíše ten dříve definovaný.
type	Nepovinný atribut String. Určuje typ třídy, která poskytuje delegáta vyhodnocení.

Podřízené prvky

Žádný

Nadřazené prvky

Prvek	Popis
configuration	Požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element pro nastavení konfigurace technologie ASP.NET v konfiguračním souboru. Obsahuje konfigurační prvky, které konfigurují webové aplikace technologie ASP.NET a ovládají chování aplikací.
deviceFilters	Určuje zařízení nebo třídu zařízení v systému MobileCapabilities technologie ASP.NET založeném na agentu nebo prohlížeči uživatele.

Poznámky

Při vytváření Webové aplikace, která má obsah specifický pro zařízení, je třeba přidat jeden nebo více filtrů v oddílu deviceFilters konfiguračního souboru. Každý filtr určuje některá kritéria, oproti kterým budou cílová zařízení porovnávána.

Konfigurace filtrů zařízení poskytuje mechanismus pro vyhodnocení dvou typů filtrů: filtr založený na porovnání a filtr založený na delegátu vyhodnocení. Syntaxe určuje oba typy filtrů. První filtr zobrazuje filtr založený na porovnání a druhý filtr zobrazuje vyhodnocení založené na delegátu vyhodnocení. Podrobné informace o vytváření filtrů v konfiguračním souboru naleznete v Vykreslení specifické pro zařízení.

Filtry zařízení rozlišují malá a velká písmena. Filtr s názvem "isColor" a filtr s názvem "IsColor" jsou považovány za různé.

Výchozí konfigurace

Výchozí hodnota následujícího elementu deviceFilters není explicitně konfigurována v konfiguračním souboru počítače nebo v kořenovém souboru Web.config, ale její výchozí konfigurace je vrácena aplikací v rozhraní .NET Framework verze 2.0.

<deviceFilters>
    <filter name="isJPhone" compare="Type" argument="J-Phone"/>
    <filter name="isHTML32" compare="PreferredRenderingType" argument="html32"/>
    <filter name="isWML11" compare="PreferredRenderingType" argument="wml11"/>
    <filter name="isCHTML10" compare="PreferredRenderingType" argument="chtml10"/>
    <filter name="isGoAmerica" compare="Browser" argument="Go.Web"/>
    <filter name="isMME" compare="Browser" argument="Microsoft Mobile Explorer"/>
    <filter name="isMyPalm" compare="Browser" argument="MyPalm"/>
    <filter name="isPocketIE" compare="Browser" argument="Pocket IE"/>
    <filter name="isUP3x" compare="Type" argument="Phone.com 3.x Browser"/>
    <filter name="isUP4x" compare="Type" argument="Phone.com 4.x Browser"/>
    <filter name="isEricssonR380" compare="Type" argument="Ericsson R380"/>
    <filter name="isNokia7110" compare="Type" argument="Nokia 7110"/>
    <filter name="prefersGIF" compare="PreferredImageMIME" argument="image/gif"/>
    <filter name="prefersWBMP" compare="PreferredImageMIME" argument="image/vnd.wap.wbmp"/>
    <filter name="supportsColor" compare="IsColor" argument="true"/>
    <filter name="supportsCookies" compare="Cookies" argument="true"/>
    <filter name="supportsJavaScript" compare="Javascript" argument="true"/>
    <filter name="supportsVoiceCalls" compare="CanInitiateVoiceCall" argument="true"/>
</deviceFilters>

Příklad

Následující příklad konfiguruje porovnávací filtr i filtr vyhodnocení delegátem. První filtr zobrazuje filtr založený na porovnání a druhý filtr zobrazuje vyhodnocení založené na delegátu vyhodnocení.

<deviceFilters>
  <filter name="IsHtml" 
    compare="PreferredRendering" 
    argument="html32" />
  <filter name="IsGPSEnabled" 
    type="Application1.CapabilityEvaluators1,Application1" 
    method="IsGPSEnabled" />
</deviceFilters>

Informace prvku

Obslužná rutina konfigurace oddílu	System.Web.Mobile.DeviceFiltersSection
Konfigurační člen	SystemWebSectionGroup.DeviceFilters DeviceSpecificChoice.Filter
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor Web.config na úrovni fyzického adresáře
Požadavky	Služba IIS 5.0, služba IIS 5.1 nebo služba IIS 6.0 Rozhraní .NET Framework 1.1 nebo 2.0 Visual Studio 2003 nebo Visual Studio 2005

Viz také

Sdílet prostřednictvím

Podelement filter elementu deviceFilters (schéma nastavení ASP.NET)

Atributy a prvky

v případě vícehodnotových atributů

Podřízené prvky

Nadřazené prvky

Poznámky

Výchozí konfigurace

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály