Login.LoginButtonType Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the type of button to use when rendering the Login button.
public:
virtual property System::Web::UI::WebControls::ButtonType LoginButtonType { System::Web::UI::WebControls::ButtonType get(); void set(System::Web::UI::WebControls::ButtonType value); };
public virtual System.Web.UI.WebControls.ButtonType LoginButtonType { get; set; }
member this.LoginButtonType : System.Web.UI.WebControls.ButtonType with get, set
Public Overridable Property LoginButtonType As ButtonType
Property Value
One of the ButtonType enumeration values. The default is Button.
Exceptions
The LoginButtonType property is not set to a valid ButtonType enumeration value.
Examples
The following code example shows the different types of login buttons available for the Login control.
Important
This example contains a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.
<%@ Page Language="C#" AutoEventWireup="false" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void changeButton_Click(Object sender, EventArgs e)
{
if (ChooseButtonType.SelectedValue == "Button")
{
Login1.LoginButtonType = ButtonType.Button;
}
if (ChooseButtonType.SelectedValue == "Image")
{
Login1.LoginButtonType = ButtonType.Image;
}
if (ChooseButtonType.SelectedValue == "Link")
{
Login1.LoginButtonType = ButtonType.Link;
}
Login1.LoginButtonText = Server.HtmlEncode(buttonText.Text);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<table>
<tr>
<td>Login Button Text:
</td>
<td>
<asp:TextBox id="buttonText"
runat="server"
Text="Login"></asp:TextBox>
</td>
<td>Button Type:
</td>
<td>
<asp:DropDownList id="ChooseButtonType"
runat="server">
<asp:ListItem value="Button"
selected="true"></asp:ListItem>
<asp:ListItem value="Image"></asp:ListItem>
<asp:ListItem value="Link"></asp:ListItem>
</asp:DropDownList>
</td>
<td>
<asp:Button id="changeButton" runat="server" Text="Change" OnClick="changeButton_Click"></asp:Button>
</td>
</tr>
<tr>
<td colspan="4"
align="center">
<asp:Login id="Login1"
runat="server"
LoginButtonType="Image"
LoginButtonText="Log in to Web Site."
LoginButtonImageUrl="images\login.png">
</asp:Login>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="false"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub changeButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
If (ChooseButtonType.SelectedValue = "Button") Then
Login1.LoginButtonType = System.Web.UI.WebControls.ButtonType.Button
End If
If (ChooseButtonType.SelectedValue = "Image") Then
Login1.LoginButtonType = System.Web.UI.WebControls.ButtonType.Image
End If
If (ChooseButtonType.SelectedValue = "Link") Then
Login1.LoginButtonType = System.Web.UI.WebControls.ButtonType.Link
End If
Login1.LoginButtonText = Server.HtmlEncode(buttonText.Text)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<table>
<tr>
<td>Login Button Text:
</td>
<td>
<asp:TextBox id="buttonText"
runat="server"
Text="Login"></asp:TextBox>
</td>
<td>Button Type:
</td>
<td>
<asp:DropDownList id="ChooseButtonType"
runat="server">
<asp:ListItem value="Button"
selected="true"></asp:ListItem>
<asp:ListItem value="Image"></asp:ListItem>
<asp:ListItem value="Link"></asp:ListItem>
</asp:DropDownList>
</td>
<td>
<asp:Button id="changeButton" runat="server" Text="Change" OnClick="changeButton_Click"></asp:Button>
</td>
</tr>
<tr>
<td colspan="4"
align="center">
<asp:Login id="Login1"
runat="server"
LoginButtonType="Image"
LoginButtonText="Log in to Web Site."
LoginButtonImageUrl="images\login.png">
</asp:Login>
</td>
</tr>
</table>
</form>
</body>
</html>
Remarks
The LoginButtonType property determines the type of button to use for the Login control's login button. The following table describes the different button types.
LoginButtonType setting | Type of button rendered |
---|---|
Button | An HTML button with the text specified in the LoginButtonText property. |
Image | An image. The URL of the image is specified in the LoginButtonImageUrl property. The string specified in the LoginButtonText property is used as alternate text for the image. |
Link | An HTML link with the text specified in the LoginButtonText property. |
When the LoginButtonType property is set to Button or Link, the content of the LoginButtonImageUrl property is ignored.