DeviceSpecificChoice Klasa

Definicja

Ostrzeżenie

Ten interfejs API jest teraz przestarzały.

Oferuje pojedynczy wybór w konstrukcji DeviceSpecific/Choice.Provides a single choice within a DeviceSpecific/Choice construct. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see 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
type DeviceSpecificChoice = class
    interface IParserAccessor
    interface IAttributeAccessor
Public Class DeviceSpecificChoice
Implements IAttributeAccessor, IParserAccessor
Dziedziczenie
DeviceSpecificChoice
Atrybuty
Implementuje

Przykłady

Poniższy przykład kodu przedstawia element <Choice> w obrazie.The following code example shows a <Choice> element within an image. Atrybut Source przesłania Właściwość ImageUrl kontrolki Image.The Source attribute overrides the ImageUrl property of the Image control.

Chociaż w przykładzie użyto funkcji do określenia, czy przeglądarka wymaga WML (isWML11), czy obsługuje kolor (supportsColor), zamiast tego można użyć pliku Web. config do zdefiniowania elementu <DeviceSpecific>, którego .NET Framework automatycznie używa do wyznaczenia.Although the example uses functions to determine whether the browser requires WML (isWML11) or supports color (supportsColor), you can instead use a Web.config file to define a <DeviceSpecific> element that the .NET Framework automatically uses to make the determination for you.

Uwaga

Poniższy przykład kodu używa modelu kodu jednoplikowego i może nie działa poprawnie, jeśli jest kopiowany bezpośrednio do pliku związanego z kodem.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Ten przykład kodu musi być skopiowany do pustego pliku tekstowego, który ma rozszerzenie. aspx.This code sample must be copied into an empty text file that has an .aspx extension. Aby uzyskać więcej informacji, zobacz Omówienie składni strony formularzy sieci Web ASP.NET.For more information, see ASP.NET Web Forms Page Syntax Overview.

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

Uwagi

Ta klasa jest analogiczna do <wyboru > elementu.This class is analogous to the <Choice> element. Opcje są testowane w kolejności, w jakiej występują w <elementu > DeviceSpecific .Choices are tested in the order that they appear within a <DeviceSpecific> element. Jeśli określisz właściwość Filter elementu <Choice>, jego wartość musi być nazwą filtru urządzeń zdefiniowanego w sekcji <deviceFilters> pliku Machine. config.If you specify the Filter property of the <Choice> element, its value must be the name of a device filter defined in the <deviceFilters> section of the Machine.config file. W czasie wykonywania ASP.NET oblicza określony filtr urządzenia pod kątem możliwości bieżącego urządzenia.At run time, ASP.NET evaluates the specified device filter against the capabilities of the current device. Jeśli to się powiedzie, wybrano opcję wybór.If successful, the choice is selected. Jeśli nie określisz właściwości Filter, wybrane są wartości domyślne dla elementu <Choice>.If you do not specify the Filter property, the defaults for the <Choice> element are selected.

Konstruktory

DeviceSpecificChoice()

Inicjuje nowe wystąpienie klasy DeviceSpecificChoice.Initializes a new instance of the DeviceSpecificChoice class. {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Właściwości

Argument

Pobiera lub ustawia argument używany dla właściwości Filter.Gets or sets the argument used for a Filter property. Wartością domyślną jest null.The default value is null. {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Contents

Pobiera zastąpione właściwości zdefiniowane dla wyboru w konstrukcji DeviceSpecific/Choice.Gets the overridden properties defined for a choice in a DeviceSpecific/Choice construct. {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Filter

Pobiera lub ustawia nazwę filtru urządzeń.Gets or sets the name of a device filter. {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

HasTemplates

Pobiera wartość wskazującą, czy aktualnie wybrany wybór w elemencie <DeviceSpecific> ma zdefiniowane w nim szablony.Gets a value indicating whether the currently selected choice in the <DeviceSpecific> element has templates defined within it. {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Templates

Pobiera szablony, które zostały zdefiniowane w <wyborze> elementu.Gets the templates that have been defined in the <Choice> element. {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Xmlns

Pobiera lub ustawia typ znacznika w <Choice> elementu.Gets or sets the type of markup in a <Choice> element. {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Metody

AddParsedSubObject(Object)

Dodaje Object do obiektu Templates obiektu DeviceSpecificChoice.Adds the Object to the DeviceSpecificChoice object's Templates object. {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetAttribute(String)

Zwraca określony atrybut z obiektu DeviceSpecificChoice.Returns the specified attribute from the DeviceSpecificChoice object. {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
SetAttribute(String, String)

Przypisuje daną wartość do atrybutu określonego przez klucz.Assigns the given value to the attribute specified by the key. {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IAttributeAccessor.GetAttribute(String)

Aby uzyskać opis tego elementu członkowskiego, zobacz GetAttribute(String).For a description of this member, see GetAttribute(String). {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

IAttributeAccessor.SetAttribute(String, String)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetAttribute(String, String).For a description of this member, see SetAttribute(String, String). {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object). {1&gt;Ten interfejs API jest przestarzały.&lt;1}This API is obsolete. Informacje o sposobach tworzenia aplikacji mobilnych ASP.NET można znaleźć w temacie Mobile Apps & witryny z ASP.NET.For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

Dotyczy

Zobacz też