Format Property

Command.Format Property

Gets or sets the render style for the Command. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the Web site.

Namespace:  System.Web.UI.MobileControls
Assembly:  System.Web.Mobile (in System.Web.Mobile.dll)

public CommandFormat Format { get; set; }

Property Value

Type: System.Web.UI.MobileControls.CommandFormat
A CommandFormat value indicating the render style for the Command.

Access the two available types through the CommandFormat enumeration.

CommandFormat.Button (default)

The command is rendered as a button.


The command is rendered as a link.


The Format property supports the CommandFormat.Link value only on devices that support JavaScript as indicated by the HttpCapabilitiesBase.JavaScript property.

The following example demonstrates how to the use the Format property to render the command as a link or a button.


The following code example uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code example must be copied into an empty text file that has an .aspx extension. For more information, see ASP.NET Web Forms Page Code Model.

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

<script runat="server">
    void cmd_OnItemCommand(object sender, CommandEventArgs e)
        // Create variables for data
        string txt1 = "Today's quote of {0} is {1}";
        string txt2 = "Yesterday's quote of {0} was {1}";
        int val = (Convert.ToInt32(e.CommandArgument) - 5);

        // Set the text values of the labels
        message1.Text = String.Format(txt1, e.CommandName, 
        message2.Text = String.Format(txt2, e.CommandName, val);

<html xmlns="" >
    <mobile:form id="form1" runat="server">
            <mobile:label id="message1" runat="server">
                Click the button for quotes
            <mobile:label id="message2" runat="server" />
        <mobile:command id="CmdA" Format="Link" 
            onItemCommand ="cmd_OnItemCommand" 
            CommandArgument="70" CommandName="ca" 
            runat="server" Text="Company A" />
        <mobile:command id="CmdB" Format="Link" 
            onItemCommand ="cmd_OnItemCommand" 
            CommandArgument="25" CommandName="cb" 
            runat="server" Text="Company B" />
        <mobile:command id="CmdC" Format="Button" 
            OnItemCommand ="cmd_OnItemCommand" 
            CommandArgument="110" CommandName="cc" 
            runat="server" Text= "Company C" />

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1
© 2015 Microsoft