Esta documentación está archivada y no tiene mantenimiento.

Command (Clase)

Actualización: noviembre 2007

Crea un elemento de interfaz de usuario que permite a los usuarios invocar los controladores de eventos de ASP.NET y proporciona un medio para enviar al servidor los datos proporcionados por el usuario en los elementos de la interfaz de usuario.

Espacio de nombres:  System.Web.UI.MobileControls
Ensamblado:  System.Web.Mobile (en System.Web.Mobile.dll)

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class Command : TextControl, IPostBackEventHandler, 
	IPostBackDataHandler
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class Command extends TextControl implements IPostBackEventHandler, 
	IPostBackDataHandler
public class Command extends TextControl implements IPostBackEventHandler, IPostBackDataHandler
<mobile:Command />

El control Command se muestra como un elemento de interfaz de usuario interactivo en el dispositivo que realiza la solicitud. La etiqueta del elemento de interfaz de usuario procede de la propiedad Text, heredada de la clase base TextControl.

ebdx1thd.alert_caution(es-es,VS.90).gifPrecaución:

Evite utilizar caracteres especiales en las direcciones URL de las páginas Web de ASP.NET Mobile. Las etiquetas HREF generadas para devolver los eventos Command al servidor no se validan de manera estricta. Por ejemplo, una dirección URL que incluya espacios generará, como resultado, WML que no podrá ser controlado por algunos exploradores WML.

TopicLocation
Tutorial: Crear páginas Web para dispositivos móvilesGenerar aplicaciones Web ASP .NET en Visual Studio

En el ejemplo de código siguiente se muestra cómo asociar eventos de comando. Al hacer clic en cualquiera de los botones Command, se provoca el evento OnItemCommand. La función definida por el usuario utiliza el argumento CommandEventArgs para saber en qué botón Command se hizo clic.

ebdx1thd.alert_note(es-es,VS.90).gifNota:

El siguiente ejemplo de código utiliza el modelo de código de un solo archivo y puede que no funcione correctamente si se copia directamente en un archivo de código subyacente. Se debe copiar este código de ejemplo en un archivo de texto vacío con una extensión .aspx. Para obtener más información, vea Modelo de código de las páginas web ASP.NET.

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


Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1
Mostrar: