browserCaps Ögesi (ASP.NET Ayarlar Şeması)

Makale
08/01/2011

Desteklenen tarayıcıların ayarlarını ve özelliklerini belirtir. browserCaps ögesi, yeni tarayıcıları ve özellikleri belirtmek için gerektiği şekilde güncelleştirilebilir.

Not
Tarayıcı tanımlamak için Web.config dosyasındaki browserCaps ögesini kullanmak .NET Framework sürüm 2.0'da kullanım dışıdır; ancak, hala desteklenmektedir.Bu ögedeki veriler, makine düzeyindeki %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers klasöründe bulunan tarayıcı açıklama dosyalarında (.browser) ve tüm varolan uygulama düzeyi App_Browser klasörlerinde bulunan bilgilerle birleştirilir.Daha fazla bilgi için bkz. Tarayıcı Tanım Dosyası Şeması (browsers Ögesi).

Tarayıcı tanımlamak için Web.config dosyasındaki browserCaps ögesini kullanmak .NET Framework sürüm 2.0'da kullanım dışıdır; ancak, hala desteklenmektedir.Bu ögedeki veriler, makine düzeyindeki %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers klasöründe bulunan tarayıcı açıklama dosyalarında (.browser) ve tüm varolan uygulama düzeyi App_Browser klasörlerinde bulunan bilgilerle birleştirilir.Daha fazla bilgi için bkz. Tarayıcı Tanım Dosyası Şeması (browsers Ögesi).

<browserCaps>
   <result />
   <use />
   [browser capability property assignments]
   <filter>...</filter>
</browserCaps>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik	Açıklama
userAgentCacheKeyLength	İsteğe bağlı String özniteliği. İç önbellekte tarayıcı yetenekleri nesnelerini önbelleğe almak üzere anahtar olarak kullanmak için tarayıcı tanımlama dizesi uzunluğunu belirtir. Tarayıcı yetenekleri nesneleri hakkında daha fazla bilgi için bkz. Tarayıcı Tanım Dosyası Şeması (browsers Ögesi). Bu öznitelik .NET Framework sürüm 2.0'da yenidir. Varsayılan, "64" değeridir.

userAgentCacheKeyLength

İsteğe bağlı String özniteliği.

İç önbellekte tarayıcı yetenekleri nesnelerini önbelleğe almak üzere anahtar olarak kullanmak için tarayıcı tanımlama dizesi uzunluğunu belirtir. Tarayıcı yetenekleri nesneleri hakkında daha fazla bilgi için bkz. Tarayıcı Tanım Dosyası Şeması (browsers Ögesi).

Bu öznitelik .NET Framework sürüm 2.0'da yenidir.

Varsayılan, "64" değeridir.

Alt Öğeler

Öge	Açıklama
filter	İsteğe bağlı öğe. Belirli tarayıcı tanımları için bağımsız ayarları uygulamanıza olanak sağlayan arama dizeleri listesini belirtir.
result	browserCaps bölümünün ayrıştırılmasından gelen sonuçları tutmak için kullanılan HttpCapabilitiesBase türetilmiş sınıfını belirtir. Özellikler anahtar/değer çiftleri olarak her tarayıcıda depolanır. Bu öge, .NET Framework sürüm 2.0'da hala uygulanır.
use	filter ve case ögelerinde depolanan tarayıcı yeteneği bilgileri ayrıştırmak için kullanılacak HTTP isteği dizesi belirtir.

filter

İsteğe bağlı öğe.

Belirli tarayıcı tanımları için bağımsız ayarları uygulamanıza olanak sağlayan arama dizeleri listesini belirtir.

result

browserCaps bölümünün ayrıştırılmasından gelen sonuçları tutmak için kullanılan HttpCapabilitiesBase türetilmiş sınıfını belirtir. Özellikler anahtar/değer çiftleri olarak her tarayıcıda depolanır.

Bu öge, .NET Framework sürüm 2.0'da hala uygulanır.

use

filter ve case ögelerinde depolanan tarayıcı yeteneği bilgileri ayrıştırmak için kullanılacak HTTP isteği dizesi belirtir.

Üst Öğeler

Öge	Açıklama
configuration	Ortak dil çalıştırma modülü ile .NET Framework uygulamaları tarafından kullanılan bütün yapılandırma dosyalarında yer alması gereken kök ögeyi belirtir.
system.web	Yapılandırma dosyasında ASP.NET yapılandırma ayarları için kök öge belirtir ve ASP.NET Web uygulamalarını yapılandıran ve uygulamaların davranışını denetleyen yapılandırma ögelerini içerir.

Açıklamalar

browserCaps ögesi, desteklenen tarayıcıların ayarlarını ve desteklenen tarayıcılar için özellikleri belirtir. browserCaps ögesi, yeni tarayıcıları ve özellikleri belirtmek için gerektiği şekilde güncelleştirilebilir.

Geçerli tarayıcı özelliklerinin listesi için bkz. HttpBrowserCapabilities.

capsVariableName=normal ifade formunun satırları atamalardır. match özniteliklerinde ve atamaların sağ tarafında %{capsVariableName} veya ${captureGroupName} sözdizimini kullanın.

Normal ifadelerin nasıl kullanılacağı hakkında daha fazla bilgi için bkz. .NET Framework Regular Expressions. browserCaps bölümünü tümüyle incelemek ve bu sözdiziminin karmaşık bir örneğini görmek için, .NET Framework ile birlikte yüklenen Machine.config dosyasına bakın.

capsVariableName ile yakalanan ad/değer çiftlerine, HttpCapabilitiesBase sınıfından devralınan HttpBrowserCapabilities nesnesinin Item özelliği aracılığıyla erişilebilir. Item özelliği, C#'taki varsayılan dizin oluşturma özelliğidir.

Varsayılan Yapılandırma

.NET Framework sürüm 2.0'da, aşağıdaki sınırlı varsayılan browserCaps ögesi kök Web.config dosyasında yapılandırılmıştır çünkü öge, desteklenen tarayıcıları ve tarayıcıların yeteneklerini belirtmek için tarayıcı tanım dosyalarının kullanımı tercih edilerek kullanım dışı bırakılmıştır. Daha fazla bilgi için bkz. Tarayıcı Tanım Dosyası Şeması (browsers Ögesi).

<browserCaps userAgentCacheKeyLength="64">
   <result 
      type="System.Web.Mobile.MobileCapabilities, System.Web.Mobile, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
   />
</browserCaps>

.NET Framework sürüm 1.0 ve 1.1'de, machine.config dosyasında yapılandırılan varsayılan browserCaps ögesinin sayısı burada listelemek için fazladır. Tarayıcı veri güncelleştirmeleri gitmek için http://www.cyscape.com/browsercaps. Dönemsel aygıt güncelleştirmeleri bu tarayıcı yetenekleri bölümü ile yer değiştirmektedir.

Örnek

Aşağıdaki kod örneği, User-Agent dizesinin biçimi yaklaşık olarak aynı kaldığı sürece, herhangi bir Microsoft Internet Explorer sürümü için User-Agent HTTP üstbilgisini ayrıştırmayı göstermektedir.

Örnekte, .NET Framework Normal İfadeleri ve normal ifadelerin yetenekleri sürüm numaralarını User-Agent dizesinden HttpBrowserCapabilities nesnesine taşımada alt ifadelerin yakalanması için kullanılmaktadır.

Dosya, ad/değer çiftlerini Microsoft Internet Information Services (IIS) browscap.ini dosyalarına benzer atama deyimleri biçiminde belirtir. Örneğin, "browser=IE" satırı tarayıcı alanının değerini "IE" dizesi olarak ayarlar.

<configuration>
 <system.web>
   <browserCaps>
      <result type="System.Web.HttpBrowserCapabilities, System.Web"/>
      <use var="HTTP_USER_AGENT"/>
      browser=Unknown
      version=0.0
      majorversion=0
      minorversion=0
      frames=false
      tables=false
      cookies=false
      backgroundsounds=false
      <filter>
    <case match="^Mozilla[^(]*\(compatible; MSIE 
       (?'ver'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))
       (?'extra'.*)">
       browser=IE
       version=${ver}
       majorver=${major}
       minorver=${minor}
       <case match="^2\." with="%{version}">
          tables=true
          cookies=true
          backgroundsounds=true
          <case match="2\.5b" with="%{version}">
        beta=true
          </case>
       </case>
    </case>
      </filter>
   </browsercaps>
 </system.web>
</configuration>

Öğe Bilgileri

Yapılandırma bölümü işleyicisi	HttpCapabilitiesSectionHandler
Yapılandırma üyesi	Browsers
Yapılandırılabilir konumlar	Machine.config Kök düzeyinde Web.config Uygulama düzeyinde Web.config Sanal veya fiziksel dizin düzeyinde Web.config
Gereksinimler	Microsoft Internet Information Services (IIS) sürüm 5.0, 5.1 veya 6.0 .NET Framework sürüm 2.0 (kullanım terkedilmiş), 1.1 veya 1.0 Microsoft Visual Studio 2003 veya Visual Studio 2005

Ayrıca bkz.

Aracılığıyla paylaş

browserCaps Ögesi (ASP.NET Ayarlar Şeması)

Öznitelikler ve Öğeler

Öznitelikler

Alt Öğeler

Üst Öğeler

Açıklamalar

Varsayılan Yapılandırma

Örnek

Öğe Bilgileri

Ayrıca bkz.

Görevler

Başvuru

Kavramlar

Diğer Kaynaklar

Ek kaynaklar