Erweiterte Browserfunktionen
Aktualisiert: November 2007
Die MobileCapabilities-Klasse basiert auf dem Standard-Browserfunktionsfeature von ASP.NET. Wenn ein Client eine Verbindung zu einer ASP.NET Mobile-Webseite herstellt, bestimmt ASP.NET das anfordernde Gerät anhand der Informationen in der Anforderung und fügt dann der Anforderung ein MobileCapabilities-Objekt hinzu. Die Anwendung kann auf dieses Objekt durch die Browser-Eigenschaft des HttpRequest-Objekts zugreifen, das der Request-Eigenschaft des Page-Objekts zugeordnet ist.
Der Anwendungscode kann auf zwei Arten auf einzelne Funktionen in einem MobileCapabilities-Objekt zugreifen. Die erste Möglichkeit besteht im Zugriff auf eine der erweiterten Funktionseigenschaften. Jede dieser schreibgeschützten Eigenschaften gibt den typsicheren Wert der entsprechenden Funktion oder einen geeigneten Standardwert zurück. Das folgende Beispiel veranschaulicht die Verwendung einer erweiterten Eigenschaft.
if (((MobileCapabilities)Request.Browser).ScreenCharactersWidth > 20)
{
// Coding for big screen capabilities is placed here.
}
else
{
// Coding for small screen capabilities is placed here.
}
Als zweite Möglichkeit kann der Anwendungscode mithilfe des Standardindexers auf die Funktionen als Wörterbuch zugreifen. Die Wörterbuchwerte entsprechen denen im <browserCaps>-Abschnitt der Datei Machine.config oder der Datei Web.config. Wenn der Wert nicht festgelegt wird, ist der zurückgegebene Wert immer ein string-Verweis oder ein null-Verweis. Die Anwendung muss diese Zeichenfolge nach Bedarf analysieren. Im folgenden Beispiel werden dieselben Funktionen wie im vorhergehenden Beispiel beschrieben, aber es wird eine Wörterbucheigenschaft verwendet.
String screenWidthText = Request.Browser["screenCharactersWidth"];
int screenWidth = 40;
if (screenWidthText != null)
screenWidth = Int32.Parse(screenWidthText);
if (screenWidth > 20)
{
// This block contains code supporting a larger screen size.
}
else
{
// This block contains code supporting a smaller screen size.
}
.gif "Hinweis") Hinweis: |
|---|
MobileCapabilities-Eigenschaften, die von Wörterbucheinträgen abgeleitet und nicht direkt in der Datei Web.config definiert wurden, können bei einigen Geräten Übereinstimmungsfehler hervorrufen. |