Funcionalidad extendida del explorador
Actualización: noviembre 2007
La clase MobileCapabilities se basa en las funciones de explorador estándar de ASP.NET. Cuando un cliente se conecta a una página Web de ASP.NET Mobile, ASP.NET determina el dispositivo solicitante a partir de la información de la solicitud y, a continuación, adjunta un objeto MobileCapabilities a dicha solicitud. La aplicación puede tener acceso a este objeto a través de la propiedad Browser del objeto HttpRequest, que se asigna a la propiedad Request del objeto Page.
El código de aplicación puede obtener acceso a funciones individuales de un objeto MobileCapabilities de dos modos. En primer lugar, puede conseguir acceso a cualquiera de las propiedades de funcionalidad de alto nivel. Cada una de estas propiedades de sólo lectura devuelve el valor con seguridad de tipos de la función correspondiente o un valor predeterminado adecuado. En el ejemplo siguiente se muestra cómo se utiliza una propiedad de alto nivel.
if (((MobileCapabilities)Request.Browser).ScreenCharactersWidth > 20)
{
// Coding for big screen capabilities is placed here.
}
else
{
// Coding for small screen capabilities is placed here.
}
En segundo lugar, el código de la aplicación puede tener acceso a la funcionalidad como un diccionario, usando el indizador predeterminado. Los valores del diccionario son iguales que los de la sección <browserCaps> del archivo Machine.config o Web.config. El valor devuelto siempre es string o una referencia null si no se establece el valor. La aplicación debe analizar esta cadena si es necesaria. En el ejemplo siguiente se muestra la misma funcionalidad que en el ejemplo anterior, pero se utiliza una propiedad de diccionario.
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 "Nota") Nota: |
|---|
Las propiedades de MobileCapabilities que se deriven de las entradas de diccionario, en lugar de definirse directamente en el archivo Web.config, pueden hacer que no coincidan en algunos dispositivos. |