Partager via

Command, classe

  • Article

Crée un élément d'interface utilisateur qui permet aux utilisateurs d'appeler des gestionnaires d'événements ASP.NET et de publier sur le serveur l'entrée d'utilisateur à partir des éléments d'interface.

Espace de noms : System.Web.UI.MobileControls
Assembly : System.Web.Mobile (dans system.web.mobile.dll)

Syntaxe

'Déclaration
Public Class Command
    Inherits TextControl
    Implements IPostBackEventHandler, IPostBackDataHandler
'Utilisation
Dim instance As Command

public class Command : TextControl, IPostBackEventHandler, IPostBackDataHandler

public ref class Command : public TextControl, IPostBackEventHandler, IPostBackDataHandler

public class Command extends TextControl implements IPostBackEventHandler, IPostBackDataHandler

public class Command extends TextControl implements IPostBackEventHandler, IPostBackDataHandler

Notes

Le contrôle Command s'affiche comme un élément d'interface interactif sur le périphérique demandeur. L'étiquette de l'élément d'interface découle de la propriété Text qui est héritée de la classe de base TextControl.

Avertissement

Évitez d'utiliser des caractères spéciaux dans les URLs de page Web mobiles d'ASP.NET. Les balises HREF générées pour la publication des événements Command sur le serveur ne sont pas strictement validées. Par exemple, la présence d'espaces dans une URL entraîne la génération de WML, qui n'est pas prise en charge par certains navigateurs WML.

Rubrique Emplacement
Procédure pas à pas : création de pages Web pour les périphériques mobiles Génération d'applications Web ASP.NET dans Visual Studio

Exemple

L'exemple de code suivant montre comment attacher des événements de commande. Cliquer sur l'un ou l'autre des boutons Command déclenche l'événement OnItemCommand. La fonction définie par l'utilisateur utilise l'argument CommandEventArgs pour identifier ce bouton Command.

Notes

L'exemple de code suivant utilise un modèle de code de fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations, consultez Modèle de code des pages Web ASP.NET.

<%@ 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">
    Public Sub Page_Load(ByVal sender As Object, _
        ByVal e As EventArgs)

        Dim caps As System.Web.Mobile.MobileCapabilities _
            = CType(Request.Browser, MobileCapabilities)

        If caps.MaximumSoftkeyLabelLength = 5 Then
            Command1.SoftkeyLabel = "Click"
        ElseIf caps.MaximumSoftkeyLabelLength > 5 Then
            Command1.SoftkeyLabel = "Submit"
        End If
    End Sub

    Private Sub Command_Click(ByVal sender As Object, _
        ByVal e As CommandEventArgs)

        Dim txt As String = "You clicked Button{0}. ({1} points)"
        If e.CommandName.ToString() = "Command1" Then
            Label1.Text = String.Format(txt, 1, e.CommandArgument)
        ElseIf e.CommandName.ToString() = "Command2" Then
            Label1.Text = String.Format(txt, 2, e.CommandArgument)
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
    <mobile:form id="form1" runat="server">
        <mobile:Label id="Label1" runat="server">
            Click a button
        </mobile:Label>
        <mobile:Label id="Label2" runat="server" /> 
        <mobile:Command id="Command1" Format="Button"
            OnItemCommand="Command_Click" 
            CommandName="Command1" runat="server" 
            Text="Button1" CommandArgument="70" />
        <mobile:Command id="Command2" Format="Link"
            OnItemCommand="Command_Click" 
            CommandName="Command2" runat="server" 
            Text="Button2" CommandArgument="50" />
    </mobile:form>
</body>
</html>

<%@ 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">
    public void Page_Load(Object sender, EventArgs e)
    {
        MobileCapabilities caps
            = (MobileCapabilities)Request.Browser;
        if (caps.MaximumSoftkeyLabelLength == 5)
        {
            Command1.SoftkeyLabel = "Click";
        }
        else if (caps.MaximumSoftkeyLabelLength > 5)
        {
            Command1.SoftkeyLabel = "Submit";
        }
    }

    void Command_Click(object sender, CommandEventArgs e)
    {
        string txt = "You clicked Button{0}. ({1} points)";
        if (e.CommandName.ToString() == "Command1")
        {
            Label1.Text = String.Format(txt, 1, 
                e.CommandArgument);
        }
        else if (e.CommandName.ToString() == "Command2")
        {
            Label1.Text = String.Format(txt, 2, 
                e.CommandArgument);
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
    <mobile:form id="form1" runat="server">
        <mobile:Label id="Label1" runat="server">
            Click a button
        </mobile:Label>
        <mobile:Label id="Label2" runat="server" /> 
        <mobile:Command id="Command1"  Format="Button"
            OnItemCommand="Command_Click" 
            CommandName="Command1" runat="server" 
            Text="Button1" CommandArgument="70" />
        <mobile:Command id="Command2" Format="Link"
            OnItemCommand="Command_Click" 
            CommandName="Command2" runat="server" 
            Text="Button2" CommandArgument="50" />
    </mobile:form>
</body>
</html>

Sécurité .NET Framework

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

Hiérarchie d'héritage

System.Object
   System.Web.UI.Control
     System.Web.UI.MobileControls.MobileControl
       System.Web.UI.MobileControls.TextControl
        System.Web.UI.MobileControls.Command

Sécurité des threads

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Plates-formes

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1

Voir aussi

Référence

Membres Command
System.Web.UI.MobileControls, espace de noms
TextControl

Autres ressources

Introduction au contrôle Command