Udostępnij za pośrednictwem

Schemat pliku definicji przeglądarki (przeglądarek Element)

  • Artykuł

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Pliki definicji przeglądarki zawiera definicje dla poszczególnych przeglądarek. W czasie wykonywania, ASP.NET używa informacji w nagłówku żądania, aby określić, jaki typ przeglądarki złożył wniosek. Następnie ASP.NET używa plików .browser w celu określenia możliwości przeglądarki. ASP.Informacji tych można używać do dostosowania zachowanie aplikacji ASP netto formantu karty.NET formant serwera sieci Web, w zależności od typu urządzenia. Na przykład formant serwera może wygenerować różne HTML dla graficznych przeglądarki, takiej jak Internet Explorer, niż miałoby to miejsce dla urządzenia przenośnego.

Uwaga

Pliki definicji przeglądarki zostały wprowadzone.NET Framework w wersji 2.0.We wcześniejszych wersjach.NET Framework browserCaps element był używany do zdefiniowania definicji przeglądarki w plikach konfiguracyjnych.

<browsers>
    <browser id="browser name"
             parentID="parent browser name"
             refID="reference ID">
        <identification>
            <userAgent match="regular expression"
                       nonMatch="regular expression" />
            <header match="regular expression"
                    name="header name"
                    nonMatch="regular expression" />
            <capability match="regular expression"
                        name="capability name"
                        nonMatch="regular expression" />
        </identification>
        <capture>
            <userAgent match="regular expression" />
            <header match="regular expression"
                    name="header name" />
            <capability match="regular expression"
                        name="capability name" />
        </capture>
        <capabilities>
            <capability name="capability name"
                        value="capability value" />
        </capabilities>
        <controlAdapters markupTextWriterType="type name">
            <adapter adapterType="name of adapter class"
                     controlType="name of control class" />
        </controlAdapters>
        <sampleHeaders>
            <header name="header name"
                    value="header value" />
        </sampleHeaders>
    </browser>
    <gateway id="gateway ID"
             parentID="parent browser ID">
        <!-- Same child elements as for <browser>.
        <identification></identification>
        <capture></capture>
        <capabilities></capabilities>
        <controlAdapters></controlAdapters>
        <sampleHeaders></sampleHeaders>
         -->
    </gateway>
    <defaultBrowser id="Default" 
                    parentID="parent browser ID"
                    refID="reference ID" >
        <!-- Same child elements as for <browser>.
        <identification></identification>
        <capture></capture>
        <capabilities></capabilities>
        <controlAdapters></controlAdapters>
        <sampleHeaders></sampleHeaders>
         -->
    </defaultBrowser>
</browsers>

Atrybuty i elementy

Element

Opis

adapter

Określa mapowanie między aplikacją ASP.Formant serwera sieci Web i karty, używany do odwzorowania go w bieżącej przeglądarce. Na przykład następującą definicję dla NokiaMobileBrowserRainbow Określa, że przeglądarka zawarte w pliku Nokia.browser Menu formanty serwera można dostosować przy użyciu przeglądarki MenuAdapter kontroli klasy karty:

    <controlAdapters markupTextWriterType="System.Web.UI.XhtmlTextWriter" >
        <adapter
          controlType="System.Web.UI.WebControls.Menu"
          adapterType="System.Web.UI.WebControls.Adapters.MenuAdapter">
        </adapter>
    </controlAdapters>

W poniższej tabeli opisano wymagane atrybuty, które są zawarte w adapter element.

AtrybutOpis
adapterType Wymagane String atrybut.Określa nazwę klasy, która jest używana, aby zmienić sposób, w jaki formant jest dostosowany do przeglądarki.
controlType Wymagane String atrybut.Określa nazwę formantu Aby mapować do karty sieciowej.

adapter Element nie zawiera żadnych elementów podrzędnych.

browser

Definiuje definicja jednej przeglądarki.

W poniższej tabeli przedstawiono atrybuty, browser może zawierać elementu.

NoteNote
Nie należy zmieniać plików definicji przeglądarki, które pochodzą z ASP.NET, ponieważ dodatki service pack może zaktualizować te pliki, zastępując zmiany wprowadzone przez użytkownika.Zamiast tworzyć nowe pliki .browser i używać parentID atrybutu w nowych definicji przeglądarki, aby dziedziczyć ustawienia lub użyj refID atrybutu, aby dodać zdolności do istniejących definicji przeglądarki.

Definicja przeglądarki należy zdefiniować albo refID atrybutu lub obu id i parentID atrybuty.

AtrybutOpis
id String atrybut, jeśli wymagane parentID atrybut jest używany.Określa unikatową nazwę dla przeglądarki, która jest zdefiniowany.
parentID String atrybut, jeśli wymagane id atrybut jest używany.Określa unikatową nazwę definicji przeglądarki nadrzędnej, z której można odziedziczyć ustawienia.Te ustawienia mogą zostać zastąpione w bieżącym definicji przeglądarki.Definicja przeglądarki nadrzędnej nie muszą być w tym samym pliku definicji przeglądarki, ale muszą być zdefiniowane w tej samej aplikacji lub w %SystemRoot%\Microsoft.NET\Framework\wersjikatalog \CONFIG\Browsers.Na przykład, następujące definicje dla WebTV przeglądarki jest zdefiniowany w pliku WebTV.browser.Definicja IE2 przeglądarki nadrzędnej jest zdefiniowany w pliku IE.browser w tym samym katalogu. <browser id=" WebTV " parentID=" IE2 ">
refID
String atrybut, nie mogą być używane, jeśli id i parentID atrybuty są używane.Określa istniejący identyfikator definicji przeglądarki.Użyj refID atrybutu, aby skojarzyć nowe możliwości z istniejących definicji przeglądarki.Można skonfigurować wiele węzłów przeglądarki, aby odwołać się do tej samej refID.Jeśli refID atrybut jest określony, browser nie może zawierać elementu identification element podrzędny. refID Atrybut zabezpieczeń nie zastępuje element docelowy; zamiast jego ustawienia są stosowane po wszystkie inne ustawienia atrybutu został zastosowany.Zamówienie które ustawienia są stosowane jest:

  • wszystkie < bramy parentID > węzły

  • wszystkie < bramy refID > węzły

  • wszystkie < przeglądarki parentID > węzły

  • wszystkie < przeglądarki refID > węzły

Następujące definicje przykład dodaje nowe możliwości do istniejących IE definicji przeglądarki, zawarte w pliku IE.browser. 
<browser refID="IE">
    <capabilities>
        <capability name="UseRichTextBox" value="true" />
    </capabilities>
    <controlAdapters>
        <adapter controlType="System.Web.UI.Calendar"
adapterType="ExampleAdapters.ExampleIECalendarAdapter"
        />
    </controlAdapters>
</browser>

browser Element może zawierać zero lub jeden z następujących elementów podrzędnych:

  • capabilities

  • capture

  • controlAdapters

  • identification

  • sampleHeaders

browsers

Reprezentuje element główny wymaganego pliku .browser.

capabilities

Definiuje wartości zdolności, aby ustawić dla bieżącej definicji przeglądarki. Dla listy jednoznacznie określony browser capabilities, zobacz właściwości HttpCapabilitiesBase klasy. Większość z tych właściwości używać Pascala w plikach definicji przeglądarki. Można również dodać własne wartości zdolności.

capabilities Element nie zawiera żadnych atrybutów.

capabilities Element może zawierać zero lub więcej następujących element podrzędny:

  • capability

capability(element podrzędny z capabilities)

Określa wartość możliwości pojedynczego, aby ustawić dla bieżącej definicji przeglądarki. Na przykład, następujące funkcje są zdefiniowane dla IE definicji przeglądarki w pliku IE.browser. Definicja ta przykład dziedziczy innych możliwości, z Mozilla definicji przeglądarki w pliku Mozilla.browser. Wartości, które zawierają tekst wewnątrz symbolu dolara następują nawiasy klamrowe ({}$) są zastępowane wartościami przechwyconych z wyrażenie dopasowania w userAgent elementu podrzędnego elementu identification elementu "^Mozilla[^(]*\([C|c]ompatible;\s*MSIE (?'version'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))(?'extra'[^)]*)".

    <capabilities>
        <capability name="browser"          value="IE" />
        <capability name="extra"            value="${extra}" />
        <capability name="isColor"          value="true" />
        <capability name="letters"          value="${letters}" />
        <capability name="majorversion"     value="${major}" />
        <capability name="minorversion"     value="${minor}" />
        <capability name="screenBitDepth"   value="8" />
        <capability name="type"             value="IE${major}" />
        <capability name="version"          value="${version}" />
    </capabilities>

capability Element zawiera następujące wymagane atrybuty.

AtrybutOpis
name Wymagane String atrybut.Określa nazwę zdolności.Dla listy jednoznacznie określony browser capabilities, zobacz właściwości HttpCapabilitiesBase klasy.Większość z tych właściwości użyć Pascala w plikach definicji przeglądarki, na przykład, canSendMail zamiast CanSendMail.Można również dodać własne wartości zdolności.
value Wymagane String atrybut.Określa wartość zdolności.Możliwe wartości dla każdego jednoznacznie określony browser capabilities są wymienione we właściwościach HttpCapabilitiesBase klasy.Wartość atrybutu może zawierać przechwyconych zmiennych wewnątrz "$ {}."

capability Element nie zawiera żadnych elementów podrzędnych.

capability(element podrzędny z identification lub capture)

Określa, że wartość zdolności z klasy nadrzędnej przeglądarki być dopasowywane przez wyrażenie regularne. Na przykład, następujące definicje dla IE5to9 przeglądarki zawartych w IE.browser, korzysta z pliku capability element, aby określić, że majorversion ustawienie zdolności IE definicji nadrzędny musi odpowiadać uwzględniane wyrażenia regularnego w celu tej definicji przeglądarki, musi być dopasowana do przeglądarki klienta. Definicja przeglądarki przykład ta obejmuje capability elementów, które Dodaj do lub zastępować elementy w definicji nadrzędnej.

    <browser id="IE5to9" parentID="IE">
        <identification>
            <capability name="majorversion" match="^[5-9]" />
        </identification>
        <!-- Capability elements. -->
    </browser>

W poniższej tabeli przedstawiono atrybuty, capability zawiera element. Albo match lub nonMatch atrybut musi być zdefiniowane, ale nie obu.

AtrybutOpis
match String atrybut, nie mogą być używane w ten sam element jako nonMatch atrybut.Określa wyrażenie regularne, która ustawienie możliwości nadrzędny musi pasować do zaspokojenia tej identyfikacji.Aby uzyskać informacje o formatowaniu wyrażeń regularnych, zobacz .NET Framework w wyrażeniach regularnych.
name Wymagane String atrybut.Określa nazwę funkcji nadrzędnej.
nonMatch String atrybut, nie mogą być używane w ten sam element jako match atrybut.Ten atrybut nie jest używany w capability elementu podrzędnego elementu capture element.Określa wyrażenie regularne, że ustawienie zdolności nadrzędny musi być zgodne, że nie spełniają ten identyfikator.

capability Element nie zawiera żadnych elementów podrzędnych.

capture

Określa, jakie informacje dodatkowe header, userAgent lub capability elementy, które służy do przechwytywania informacji o przeglądarce. Jest to przydatne, gdy próby wykrycia nowej przeglądarki, które nie były dostępne obowiązującymi.NET Framework 2.0 został wydany. Aby przechwytywać tylko wartości, definicja przeglądarki mogą zawierać przechwytywanie wyrażenia regularnego w match atrybut dowolnego elementu identyfikacji. Na przykład, następujące userAgent element jest zdefiniowany w pliku IE.browser przechwytuje wysokość ekranu w pikselach z nagłówka żądanie agenta użytkownika.

    <capture>
        <userAgent match="PalmSource; Blazer 3\.0\)\s\d+;(?'screenPixelsHeight'\d+)x(?'screenPixelsWidth'\d+)$" />
    </capture>

Definicja przeglądarki może być również konieczna przechwytywać dodatkowe informacje przez skanowanie nagłówków żądania, które nie są używane do rozróżniania klasy przeglądarki. Na przykład, następujące capture element przechwytuje liczba miękkich klawisze służące do telefonu komórkowego OpenWave. Miękkie klucze wyświetlania menu i poleceń, po naciśnięciu odpowiadające im przyciski sprzętowe na Smartphone z systemem Windows Mobile:

    <capture>
        <header name="HTTP_X_UP_DEVCAP_NUMSOFTKEYS" 
                match="(?'softkeys'\d+)" />
    </capture>

capture Element nie zawiera żadnych atrybutów.

capture Element może zawierać zero lub więcej z następujących elementów podrzędnych:

  • header

  • userAgent

  • capability

controlAdapters

Definiuje karty kontroli dostosowanie formant serwera w przeglądarce.

W poniższej tabeli opisano atrybut, controlAdapters zawiera element.

AtrybutOpis
markupTextWriterType Opcjonalny String atrybut.Określa.NET Framework typu użyć modułu zapisującego tekst adiustacji.Domyślnym typem jest System.Web.UI.XhtmlTextWriter, ale są inne wartości możliwości dla tego atrybutu System.Web.UI.Html32TextWriter, System.Web.UI.HtmlTextWriter, System.Web.UI.ChtmlTextWriter, lub wszelkie niestandardowe klasy pochodzące z jednego z tych klas.

controlAdapters Element może zawierać zero lub więcej następujących element podrzędny:

  • adapter

defaultBrowser

Definiuje domyślny możliwości przeglądarki w pliku Default.browser. Definicje przeglądarki domyślnej nie pasują do wszelkich szczególnych fizycznych przeglądarki, ale są używane przez inne definicje do dziedziczą ustawienia. Na przykład, następujące Default definicji przeglądarki jest zawarte w pliku Default.browser:

    <defaultBrowser id="Default">
        <capabilities>
            <capability name="ecmascriptversion"   value="0.0" />
            <capability name="javascript"          value="false" />
            <capability name="jscriptversion"      value="0.0" />
        </capabilities>
    </defaultBrowser>

Definicja przeglądarki domyślnej jest dziedziczona przez inne definicje przeglądarki. Na przykład, następujące definicje dla Panasonic przeglądarki jest zawarte w pliku Panasonic.browser.

<browser id="Panasonic" parentID="Default">

W poniższej tabeli opisano atrybut, defaultBrowser zawiera element.

AtrybutOpis
id Wymagane String atrybut.Określa unikatową nazwę dla przeglądarki.

defaultBrowser Element może zawierać te same elementy podrzędne jako browser element.

gateway

Określa definicję pojedyncza brama. Niektóre przeglądarki mobilne są podłączone do serwera sieci Web za pośrednictwem bramy, które można dodać własne możliwości. Jest możliwe dla wielu elementów bramy do odwoływania się do tej samej refID atrybut.

gateway Element może zawierać te same atrybuty i elementy podrzędne jako browser element. Na przykład, następujące definicje dla IE3AK brama jest z pliku IE.browser.

    <gateway id="IE3AK" parentID="IE3">
        <identification>
            <capability name="extra" match="; AK;" />
        </identification>
        <capture>
        </capture>
        <capabilities>
            <capability name="ak"  value="true" />
        </capabilities>
    </gateway>
NoteNote
Plik definicji przeglądarki nie może mieć w aplikacji, która zawiera browser element którego parentID atrybut odnosi się do gateway element w domyślnych plików definicji znajduje się w katalogu %SystemRoot\Microsoft.NET\Framework\versionNumber\CONFIG\Browsers.Można jednak ustawić parentID atrybut do odwoływania się do pliku definicji innej przeglądarki, w tym samym folderze App_Browsers.

header(element podrzędny z identification lub capture)

Określa wyrażenie w stosunku do którego ma odpowiadać lub przechwytywania określonego nagłówka HTTP w żądaniu. Na przykład, następujące definicje dla Wml przeglądarki zawarte w pliku Default.browser identyfikuje pasujące przeglądarki przez porównanie Accept nagłówka do dwóch wyrażeń regularnych.

<identification>
    <header name="Accept" 
            match="text/vnd\.wap\.wml|text/hdml" />
    <header name="Accept" 
            nonMatch="application/xhtml\+xml; profile|application/vnd\.wap\.xhtml\+xml" />
</identification>

W poniższej tabeli przedstawiono atrybuty, header zawiera element. Albo match lub nonMatch atrybut musi być obecny, ale nie obu.

AtrybutOpis
match String atrybut, nie mogą być używane w ten sam element jako nonMatch atrybut.Określa wyrażenie regularne, która wartość nagłówka żądania musi pasować do zaspokojenia ten identyfikator.Aby uzyskać informacje o formatowaniu wyrażeń regularnych, zobacz .NET Framework w wyrażeniach regularnych.
name Wymagane String atrybut.Określa nazwę nagłówka.
nonMatch String atrybut, nie mogą być używane w ten sam element jako match atrybut.Ten atrybut nie jest używany w capability elementu podrzędnego elementu capture element.Określa wyrażenie regularne, która wartość nagłówka żądania nie musi pasować do zaspokojenia ten identyfikator.

header Element nie zawiera żadnych elementów podrzędnych.

header(element podrzędny z sampleHeaders)

Określa nagłówek pojedynczej próbki dla tej przeglądarki. Element ten jest opcjonalny i tylko w celach informacyjnych. Symulator lub narzędzia do debugowania można używać tego zestawu nagłówków do emulowania przeglądarki na żądanie.

W poniższej tabeli przedstawiono atrybuty, header zawiera element.

AtrybutOpis
name Opcjonalny String atrybut.Określa nazwę nagłówka.
value Opcjonalny String atrybut.Określa wartość nagłówka.

header Element nie zawiera żadnych elementów podrzędnych.

identification

Określa informacje dotyczące sposobu określenia tej przeglądarki z przychodzące żądania.

identification Element nie zawiera żadnych atrybutów.

identification Element może zawierać jeden lub więcej następujących elementów podrzędnych:

  • header

  • userAgent

  • capability

sampleHeaders

Określa zestaw nagłówków próbki dla tej przeglądarki. Element ten jest opcjonalny i tylko w celach informacyjnych. Symulator lub narzędzia do debugowania można używać tego zestawu nagłówków do emulowania przeglądarki na żądanie.

sampleHeaders Element nie zawiera żadnych atrybutów.

sampleHeaders Element może zawierać zero lub więcej następujących element podrzędny:

  • header

userAgent

Określa wyrażenie, przeciwko któremu dopasować nagłówek agenta użytkownika żądania. Na przykład, następujące definicje dla IE4 przeglądarki zawartych w IE.browser, korzysta z pliku "MSIE 4" ciąg do identyfikowania przeglądarki w nagłówku agenta użytkownika, który wysyła się do wniosku.

        <identification>
            <userAgent match="MSIE 4" />
        </identification>

W poniższej tabeli przedstawiono atrybuty, userAgent zawiera element. Albo match lub nonMatch atrybut musi być obecny, ale nie obu.

AtrybutOpis
match String atrybut, nie mogą być używane w ten sam element jako nonMatch atrybut.Określa wyrażenie regularne, które agent użytkownika muszą spełniać, aby spełnić ten identyfikator.Aby uzyskać informacje o formatowaniu wyrażeń regularnych, zobacz .NET Framework w wyrażeniach regularnych.
nonMatch String atrybut, nie mogą być używane w ten sam element jako match atrybut.Określa wyrażenie regularne, która agenta użytkownika nie musi pasować do zaspokojenia ten identyfikator.Ten atrybut nie jest używany w capability elementu podrzędnego elementu capture element.

userAgent Element nie zawiera żadnych elementów podrzędnych.

Uwagi

Jeśli okaże się, że żaden z istniejących plików definicji przeglądarki spełnia kryteria, można utworzyć nowe pliki definicji przeglądarki przy użyciu kodu w przykład sekcji poniżej.

Uwaga dotycząca zabezpieczeńUwaga dotycząca zabezpieczeń

Nie pobieraj ani nie zainstalować definicja przeglądarki plików od stron trzecich, chyba że ufasz źródłu ich.Zbadać nowego pliku definicji przeglądarki, aby zobaczyć wszelkie nieznane obszarów nazw, są odwołanie do.Aby uzyskać więcej informacji, zobacz Securing Browser Definition Files.

Pliki definicji przeglądarki wstępnie zdefiniowane są przechowywane w %SystemRoot%\Microsoft.NET\Framework\wersjikatalog \CONFIG\Browsers. Pliki definicji przeglądarki poziomie aplikacji może być umieszczone w katalogu App_Browsers. W obu lokalizacjach plików definicji przeglądarki musi mieć rozszerzenie nazwy pliku .browser. Nie należy zmieniać plików definicji przeglądarki, które pochodzą z ASP.NET, ponieważ dodatki service pack może zaktualizować te pliki, zastępując zmiany wprowadzone przez użytkownika. Zamiast tworzyć nowe pliki .browser i używać parentID atrybutu w nowym browser definicji dziedziczą ustawienia lub użyj refID atrybutu, aby dodać zdolności do istniejących definicji przeglądarki.

W czasie wykonywania, informacje o pliku definicji przeglądarki scalone zbiór znanych przeglądarek w BrowserCapabilitiesFactory obiektu. Gdy wniosek jest złożony, ASP.NET identyfikuje przeglądarki w nagłówku żądania i kompiluje HttpBrowserCapabilities obiekt, który odpowiada typowi żądanej przeglądarki. Można to zrobić, począwszy od pustego słownika i stosując poniższe kroki rekurencyjne przeciwko drzewa definicji przeglądarki:

  1. Rozpocznij od definicji przeglądarki domyślnej jest zawsze uważane za pomyślnego dopasowania.

  2. Scalanie wartości zdolności, określonej w niniejszej definicji przeglądarki do słownika możliwości dla tej przeglądarki. Wartości określone w definicji przeglądarki zastępują wartości ustawione w obiekcie nadrzędnym.

  3. Oceny każdej definicji dziecka do określenia dopasowania. Dla każdego dziecka pasujące Uruchom ponownie w kroku 1. Definicje przeglądarki są oceniane po definicji bramy. Jeśli agenta użytkownika odpowiada definicji przeglądarki więcej niż jeden lub więcej niż jedną definicję bramy, jest wyjątek w czasie wykonywania.

HttpBrowserCapabilities Obiektu jest buforowany i może być ponownie używane dla różnych żądania z tego samego rodzaju przeglądarki.

Aplikacji sieci Web można uzyskać dostęp do bieżącego wystąpienia HttpBrowserCapabilities obiektu za pomocą HttpRequest.Browser właściwości. Ten obiekt jest tylko do odczytu i zawiera właściwości dla każdej funkcji. Alternatywnie, Projektant sieci Web można konstruować niestandardowe klasy, która dziedziczy z HttpBrowserCapabilities klasy i przechowywania instancji w HttpRequest.Browser właściwości.

Zmiany wprowadzone w plikach .browser, znajdującego się w katalogu App_Browsers nieważności buforu i następnym żądaniu spowoduje, że aplikacja ponowną kompilację. Jednakże jeśli zmiany są wprowadzone do plików .browser w %SystemRoot%\Microsoft.NET\Framework\wersjiponownie \CONFIG\Browsers katalogu, użytkownik musi ręcznie skompilować aplikację za pomocą %SystemRoot%\Microsoft.NET\Framework\wersjiponownie narzędzia \aspnet_regbrowsers.exe lub użytkownik musi programowo go skompilować przy użyciu BrowserCapabilitiesCodeGenerator klasy.

Uwaga

Za pomocą browserCaps elementu w pliku Web.config, aby zdefiniować przeglądarki jest przestarzałe w.NET Framework 2.0 jednak wciąż obsługiwane.Dane w tym elemencie jest scalany z informacji z plików definicji przeglądarki.

Kiedy przeglądarka wysyła żądanie do aplikacji, możliwości przeglądarki są przechowywane w Browser właściwości. Tożsamość przeglądarki są przechowywane w UserAgent właściwości. ASP.Formanty serwera sieci Web kwerendy Lista możliwości podejmowania decyzji dotyczących sposobu dostosowania zachowanie formantów odpowiednio dla różnych przeglądarek.

Możliwości

Dla listy jednoznacznie określony browser capabilities, zobacz właściwości HttpCapabilitiesBase klasy. Te właściwości używać Pascala w plikach definicji przeglądarki. Na przykład, jeśli chcesz określić BackgroundSounds zdolności w pliku definicji przeglądarki, wpisz go jako backgroundSounds.

Można także zdefiniować własne możliwości.

Aplikacja sieci Web można pobrać wartości zdolności z HttpBrowserCapabilities obiekt w jednym z następujących dwóch sposobów:

  • Po zalogowaniu się do słownika możliwości. Tej metody można użyć niestandardowego możliwości.

    Na przykład aby uzyskać wartość zdolności ECMAScript (JavaScript) do przeglądarki klienta bieżącej, można użyć następującego kodu:

    String cap_javascript = Request.Browser["javascript"];

  • Wywołując jednoznacznie właściwość który otacza możliwości.

    Na przykład aby uzyskać wartości zdolności ECMAScript do przeglądarki klienta bieżącej, można użyć następującego kodu:

    String cap_javascript = Request.JavaScript;

Domyślna konfiguracja

.NET Framework pochodzi z plików definicji przeglądarki wstępnie zdefiniowanych w %SystemRoot%\Microsoft.NET\Framework\wersjikatalog \CONFIG\Browsers. Pliki definicji przeglądarki na poziomie aplikacji można utworzyć w katalogu App_Browsers aplikacji. Aby uzyskać informacje o specjalnych ASP.NET katalogów, zobacz ASP.NET Web Site Layout.

Następujący przykładowy kod to plik Generic.browser w %SystemRoot%\Microsoft.NET\Framework\wersjikatalog \CONFIG\Browsers.

Uwaga

Nie należy zmieniać istniejące pliki definicji przeglądarki w %SystemRoot%\Microsoft.NET\Framework\wersjikatalog \CONFIG\Browsers.Są one utrzymywane przez.NET Framework.

<browsers>
    <browser id="GenericDownlevel" parentID="Default">
        <identification>
            <userAgent match="^Generic Downlevel$" />
        </identification>
        <capture>
        </capture>
        <capabilities>
            <capability name="cookies"
                        value="false" />
            <capability name="ecmascriptversion" 
                        value="1.0" />
            <capability name="tables"
                        value="true" />
            <capability name="type"
                       value="Downlevel" />
        </capabilities>
        <controlAdapters>
        <adapter controlType="System.Web.UI.WebControls.Menu"
                     adapterType="System.Web.UI.WebControls.Adapters.MenuAdapter" />
        </controlAdapters>
    </browser>
    <browser id="Mozilla" parentID="Default">
        <identification>
            <userAgent match="Mozilla" />
        </identification>
        <capture>
        </capture>
        <capabilities>
            <capability name="browser"
                        value="Mozilla" />
            <capability name="cookies"
                        value="false" />
            <capability name="inputType"
                        value="keyboard" />
            <capability name="isColor"
                        value="true" />
            <capability name="isMobileDevice"
                        value="false" />
            <capability name="maximumRenderedPageSize"
                        value="300000" />
            <capability name="screenBitDepth"
                        value="8" />
            <capability name="supportsBold"
                        value="true" />
            <capability name="supportsCss"
                        value="true" />
            <capability name="supportsDivNoWrap"
                        value="true" />
            <capability name="supportsFontName"
                        value="true" />
            <capability name="supportsFontSize"
                        value="true" />
            <capability name="supportsImageSubmit"
                        value="true" />
            <capability name="supportsItalic"
                        value="true" />
            <capability name="type"
                        value="Mozilla" />
        </capabilities>
    </browser>
</browsers>

Przykład

Poniższy przykład kodu jest plikiem pusty .browser, który można budować na. Należy zachować ostrożność, aby nie tworzyć odwołań cyklicznych w przeglądarce plików.

<?xml version="1.0" encoding="utf-8"?>

<browsers>
    <browser id="NewBrowser" parentID="Mozilla">
        <identification>
            <userAgent match="Unique User Agent Regular Expression" />
        </identification>

        <capture>
            <userAgent match="NewBrowser (?'version'\d+\.\d+)" />
        </capture>

        <capabilities>
            <capability name="browser" value="My New Browser" />
            <capability name="version" value="${version}" />
        </capabilities>
    </browser>

    <browser refID="Mozilla">
        <capabilities>
            <capability name="xml" value="true" />
        </capabilities>
    </browser>
</browsers>

Informacje o elemencie

Program obsługi sekcji konfiguracji

System.Web.Configuration.HttpCapabilitiesSectionHandler

Członkowie konfiguracji

HttpRequest.Browser

HttpCapabilitiesBase.Browsers

HttpCapabilitiesBase.Capabilities

System.Web.HttpBrowserCapabilities

Lokalizacje konfigurowalne

Katalog przeglądarki komputera głównego poziomu

Poziom katalogu App_Browsers aplikacji

Wymagania

Internet Information Services (IIS) 5.0 lub nowszej wersji

.NET Framework w wersji 2.0 lub nowszej wersji

Visual Studio 2005 lub nowszej wersji

Zobacz też

Zadania

How to: Detect Browser Types in ASP.NET Web Pages

Informacje

Browsers

Capabilities

HttpCapabilitiesSectionHandler

HttpBrowserCapabilities

deviceFilters elementu (ASP.Schemat ustawień netto)

mobileControls elementu (ASP.Schemat ustawień netto)

browserCaps elementu (ASP.Schemat ustawień netto)

Koncepcje

ASP.NET Web Server Controls and Browser Capabilities

Securing Browser Definition Files

Configuration Inheritance

ASP.NET Device Filtering Overview

Architectural Overview of Adaptive Rendering

Inne zasoby

ASP.NET dla komórkowe: urzędowym Microsoft ASP.Witryny sieci

Ogólne ustawienia konfiguracji (ASP.(NET)

ASP.NET ustawienia konfiguracji