ASPxButton.RenderMode Property

Specifies whether the button is rendered as a button or as a link.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue(ButtonRenderMode.Button)]
public ButtonRenderMode RenderMode { get; set; }

VB.NET

<DefaultValue(ButtonRenderMode.Button)>
Public Property RenderMode As ButtonRenderMode

Property Value

Type	Default	Description
ButtonRenderMode	Button	One of the ButtonRenderMode enumeration values.

Available values:

Name	Description
Button	The button is rendered as an input HTML element.
Link	The button is rendered as a hyperlink HTML element.
Secondary	Identifies a button of secondary importance.
Outline	Represents the button with a colored border and without a background color.
Danger	The button indicates a dangerous or potentially negative action.

Remarks

Use the RenderMode property to specify which element is used to render a button: a hyperlink (the Link value) or an input (the others values).

Use the Link mode to create a hyperlink-style button on the Web page. In this mode, the control looks like an ASPxHyperLink control and behaves like an ASPxButton control. If you want to link to another Web page when the control is clicked, use the ASPxHyperLink control.

The code samples below demonstrate a button’s ASP markup and the corresponding HTML code rendered for this button.

• Button Render Mode

  

  ASPX

  <dx:ASPxButton ID="ASPxButton1" runat="server" Text="OK" >
       <Image IconID="actions_apply_16x16">
       </Image>
  </dx:ASPxButton>
  

  HTML

  <div id="ASPxButton1" class="dxbButton_MetropolisBlue dxbButtonSys" style="-moz-user-select: none; width: 52px; height: 24px;">
       <div id="ASPxButton1_CD" class="dxb" style="padding-top: 2px; padding-bottom: 3px;">
            <input class="dxb-hb" type="submit" name="ASPxButton1" value="OK">
            <img id="ASPxButton1Img" class="dxIcon_actions_apply_16x16 dx-vam" style="margin-right:4px;" alt="" src="/DXR.axd?r=1_11-10NW7">
            <span class="dx-vam" style="">OK</span>
       </div>
  </div>
  

• Link Render Mode

  Note

  In the Link render mode, the ASPxButton.UseSubmitBehavior and ASPxButton.Checked properties are not in effect.

  

  ASPX

  <dx:ASPxButton ID="ASPxButton3" runat="server" RenderMode="Link" Text="OK">
       <Image IconID="actions_apply_16x16">
       </Image>
  </dx:ASPxButton>
  

  HTML

  <a id="ASPxButton3" class="dxbButton_MetropolisBlue dxbButtonSys" href="javascript:;">
       <img id="ASPxButton3Img" class="dxIcon_actions_apply_16x16 dx-vam" style="margin-right:4px;" alt="" src="/DXR.axd?r=1_11-10NW7">
       <span class="dx-vam">OK</span>
  </a>