DeviceSpecificChoice Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.MobileControls

Ensamblado:: System.Web.Mobile.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Precaución

The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.

Proporciona una opción única en una construcción de DeviceSpecific/Choice. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.

public ref class DeviceSpecificChoice : System::Web::UI::IAttributeAccessor, System::Web::UI::IParserAccessor

[System.Web.UI.MobileControls.PersistName("Choice")]
public class DeviceSpecificChoice : System.Web.UI.IAttributeAccessor, System.Web.UI.IParserAccessor

[System.Web.UI.MobileControls.PersistName("Choice")]
[System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")]
public class DeviceSpecificChoice : System.Web.UI.IAttributeAccessor, System.Web.UI.IParserAccessor

[<System.Web.UI.MobileControls.PersistName("Choice")>]
type DeviceSpecificChoice = class
    interface IParserAccessor
    interface IAttributeAccessor

[<System.Web.UI.MobileControls.PersistName("Choice")>]
[<System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")>]
type DeviceSpecificChoice = class
    interface IParserAccessor
    interface IAttributeAccessor

Public Class DeviceSpecificChoice
Implements IAttributeAccessor, IParserAccessor

Herencia: Object
DeviceSpecificChoice

Atributos: PersistNameAttribute ObsoleteAttribute

Implementaciones: IAttributeAccessor IParserAccessor

Ejemplos

En el ejemplo de código siguiente se muestra un <Choice> elemento dentro de una imagen. El Source atributo invalida la ImageUrl propiedad del Image control .

Aunque en el ejemplo se usan funciones para determinar si el explorador requiere WML () o admite color (isWML11supportsColor), en su lugar puede usar un archivo Web.config para definir un <DeviceSpecific> elemento que .NET Framework usa automáticamente para tomar la determinación automáticamente.

Nota

En el ejemplo de código siguiente se usa el modelo de código de un solo archivo y es posible que no funcione correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse en un archivo de texto vacío que tenga una extensión .aspx. Para obtener más información, consulte ASP.NET Web Forms Información general sobre la sintaxis de página.

<%@ Page Language="C#" 
    Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile" 
    Namespace="System.Web.UI.MobileControls" 
    Assembly="System.Web.Mobile" %>
<%@ Import Namespace="System.Web.Mobile" %>

<script runat="server">
    private bool supportsColor(MobileCapabilities caps, string optValue)
    {
        // Determine if the browser is not a Web crawler and
        // can display in color
        if (!caps.Crawler && caps.IsColor)
            return true;
        return false;
    }

    private bool isWML11(MobileCapabilities caps, string optValue)
    {
        // Determine if the browser is not a Web crawler and
        // requires WML markup
        if (!caps.Crawler && caps.PreferredRenderingType ==
            MobileCapabilities.PreferredRenderingTypeWml11)
            return true;
        return false;
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
    <mobile:form id="form1" runat="server">
        <mobile:Image ID="Image1" runat="server" 
            AlternateText="Cannot display this image.">
            <DeviceSpecific>
                <choice Filter ="isWML11" ImageURL="wmlImage.wbmp" />
                <choice Filter="supportsColor" ImageURL="colorImage.gif" />
                <choice ImageURL="monoImg.gif" />
            </DeviceSpecific>
        </mobile:Image>
    </mobile:form>
</body>
</html>

<%@ Page Language="VB" 
    Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile" 
    Namespace="System.Web.UI.MobileControls" 
    Assembly="System.Web.Mobile" %>
<%@ Import Namespace="System.Web.Mobile" %>

<script runat="server">
    Private Function supportsColor(ByVal caps As MobileCapabilities, _
        ByVal value As String) As Boolean
        
        ' Determine if the browser is not a Web crawler and
        ' can display in color
        If Not caps.Crawler And caps.IsColor Then
            Return True
        Else
            Return False
        End If
    End Function

    Private Function isWML11(ByVal caps As MobileCapabilities, _
        ByVal value As String) As Boolean

        ' Determine if the browser is not a Web crawler and
        ' requires WML markup
        If (Not caps.Crawler) AndAlso caps.PreferredRenderingType = _
            MobileCapabilities.PreferredRenderingTypeWml11 Then
            Return True
        Else
            Return False
        End If
    End Function
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
    <mobile:form id="form1" runat="server">
        <mobile:Image ID="Image1" runat="server" 
            AlternateText="Cannot display this image.">
            <DeviceSpecific>
                <choice Filter ="isWML11" ImageURL="wmlImage.wbmp" />
                <choice Filter="supportsColor" ImageURL="colorImage.gif" />
                <choice ImageURL="monoImg.gif" />
            </DeviceSpecific>
        </mobile:Image>
    </mobile:form>
</body>
</html>

Comentarios

Esta clase es análoga al <elemento Choice> . Las opciones se prueban en el orden en que aparecen dentro de un <elemento DeviceSpecific> . Si especifica la Filter propiedad del <Choice> elemento, su valor debe ser el nombre de un filtro de dispositivo definido en la <deviceFilters> sección del archivo Machine.config. En tiempo de ejecución, ASP.NET evalúa el filtro de dispositivo especificado con respecto a las funcionalidades del dispositivo actual. Si se ejecuta correctamente, se selecciona la opción. Si no especifica la Filter propiedad , se seleccionan los valores predeterminados del <Choice> elemento.

Constructores

DeviceSpecificChoice()

Obsoletos.

Inicializa una nueva instancia de la clase DeviceSpecificChoice. Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.

Propiedades

Argument	Obsoletos. Obtiene o establece el argumento utilizado para una propiedad Filter. El valor predeterminado es `null`. Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.
Contents	Obsoletos. Obtiene las propiedades reemplazadas definidas para una opción en una construcción de DeviceSpecific/Choice. Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.
Filter	Obsoletos. Obtiene o establece el nombre de un filtro de dispositivo. Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.
HasTemplates	Obsoletos. Obtiene un valor que indica si la opción seleccionada actualmente en el <elemento DeviceSpecific> tiene plantillas definidas en él. Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.
Templates	Obsoletos. Obtiene las plantillas que se han definido en el <elemento Choice> . Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.
Xmlns	Obsoletos. Obtiene o establece el tipo de marcado en un <elemento Choice> . Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.

Métodos

AddParsedSubObject(Object)	Obsoletos. Agrega el Object al objeto DeviceSpecificChoice del objeto Templates. Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.
Equals(Object)	Obsoletos. Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetAttribute(String)	Obsoletos. Devuelve el atributo especificado del objeto DeviceSpecificChoice. Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.
GetHashCode()	Obsoletos. Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obsoletos. Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Obsoletos. Crea una copia superficial del Object actual. (Heredado de Object)
SetAttribute(String, String)	Obsoletos. Asigna el valor dado al atributo especificado por la clave. Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.
ToString()	Obsoletos. Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

IAttributeAccessor.GetAttribute(String)

Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código.

Obsoletos.

Para obtener una descripción de este miembro, vea GetAttribute(String). Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.

IAttributeAccessor.SetAttribute(String, String)

Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código.

Obsoletos.

Para obtener una descripción de este miembro, vea SetAttribute(String, String). Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.

IParserAccessor.AddParsedSubObject(Object)

Obsoletos.

Para obtener una descripción de este miembro, vea AddParsedSubObject(Object). Esta API está obsoleta. Para obtener información sobre cómo desarrollar aplicaciones móviles ASP.NET, consulte Mobile Apps & Sites with ASP.NET.

Se aplica a

DeviceSpecificChoice Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios

Recursos adicionales