DeviceSpecificChoice Klasse

Referenz

Definition

Namespace:: System.Web.UI.MobileControls

Assembly:: System.Web.Mobile.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Achtung

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.

Stellt innerhalb eines DeviceSpecific/Choice-Konstrukts eine einzelne Auswahl bereit. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit 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

Vererbung: Object
DeviceSpecificChoice

Attribute: PersistNameAttribute ObsoleteAttribute

Implementiert: IAttributeAccessor IParserAccessor

Beispiele

Das folgende Codebeispiel zeigt ein <Choice> Element in einem Bild. Das Source -Attribut überschreibt die ImageUrl -Eigenschaft des Image -Steuerelements.

Obwohl das Beispiel Funktionen verwendet, um zu bestimmen, ob der Browser WML (isWML11) erfordert oder Farbe unterstützt (supportsColor), können Sie stattdessen eine Web.config-Datei verwenden, um ein <DeviceSpecific> Element zu definieren, das der .NET Framework automatisch verwendet, um die Ermittlung für Sie vorzunehmen.

Hinweis

Das folgende Codebeispiel verwendet das Einzeldateicodemodell und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung ASPX kopiert werden. Weitere Informationen finden Sie unter Übersicht über ASP.NET Web Forms Seitensyntax.

<%@ 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>

Hinweise

Diese Klasse entspricht dem Choice-Element<>. Die Auswahlmöglichkeiten werden in der Reihenfolge getestet, in der sie in einem <DeviceSpecific-Element> angezeigt werden. Wenn Sie die Filter Eigenschaft des <Choice> Elements angeben, muss dessen Wert der Name eines Gerätefilters sein, der im Abschnitt der <deviceFilters> Machine.config-Datei definiert ist. Zur Laufzeit wertet ASP.NET den angegebenen Gerätefilter anhand der Funktionen des aktuellen Geräts aus. Bei erfolgreicher Ausführung wird die Auswahl ausgewählt. Wenn Sie die Filter -Eigenschaft nicht angeben, werden die Standardwerte für das <Choice> -Element ausgewählt.

Konstruktoren

DeviceSpecificChoice()

Veraltet.

Initialisiert eine neue Instanz der DeviceSpecificChoice-Klasse. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.

Eigenschaften

Argument	Veraltet. Ruft das Argument für eine Filter-Eigenschaft ab oder legt dieses fest. Der Standardwert ist `null`. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.
Contents	Veraltet. Ruft die überschriebenen Eigenschaften ab, die in einem DeviceSpecific/Choice-Konstrukt für eine Auswahl definiert sind. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.
Filter	Veraltet. Ruft den Namen eines Gerätefilters ab oder legt diesen fest. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.
HasTemplates	Veraltet. Ruft einen Wert ab, der angibt, ob für die <aktuell ausgewählte Auswahl im DeviceSpecific-Element> Vorlagen definiert sind. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.
Templates	Veraltet. Ruft die Vorlagen ab, die im Choice-Element<> definiert wurden. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.
Xmlns	Veraltet. Ruft den Markuptyp in einem <Choice-Element> ab oder legt diese fest. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.

Methoden

AddParsedSubObject(Object)	Veraltet. Fügt das Object dem DeviceSpecificChoice-Objekt des Templates-Objekts hinzu. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.
Equals(Object)	Veraltet. Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetAttribute(String)	Veraltet. Gibt das angegebene Attribut aus dem DeviceSpecificChoice-Objekt zurück. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.
GetHashCode()	Veraltet. Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Veraltet. Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Veraltet. Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
SetAttribute(String, String)	Veraltet. Weist dem vom Schlüssel angegebenen Attribut den festgelegten Wert zu. Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.
ToString()	Veraltet. Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IAttributeAccessor.GetAttribute(String)

Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht.

Veraltet.

Eine Beschreibung dieses Elements finden Sie unter GetAttribute(String). Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.

IAttributeAccessor.SetAttribute(String, String)

Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht.

Veraltet.

Eine Beschreibung dieses Elements finden Sie unter SetAttribute(String, String). Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.

IParserAccessor.AddParsedSubObject(Object)

Veraltet.

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object). Diese API ist veraltet. Informationen zum Entwickeln ASP.NET mobiler Anwendungen finden Sie unter Mobile Apps & Websites mit ASP.NET.

Gilt für:

DeviceSpecificChoice Klasse

Definition

Beispiele

Hinweise

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

Feedback

Zusätzliche Ressourcen