System.Web.UI.WebControls.Login.LayoutTemplate Property

Gets or sets the template used to display the System.Web.UI.WebControls.Login control.

Syntax

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.Login))]
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.ITemplate LayoutTemplate { set; get; }

Value

Documentation for this section has not yet been entered.

Remarks

The Login.LayoutTemplate property contains the template that defines how the System.Web.UI.WebControls.Login control is displayed to the user.

The following table lists the required and optional controls used in a System.Web.UI.WebControls.Login control template.

UserName

Any control that implements System.Web.UI.IEditableTextControl, including System.Web.UI.WebControls.TextBox, or a custom or third-party control.

Required

Password

Any control that implements System.Web.UI.IEditableTextControl, including System.Web.UI.WebControls.TextBox, or a custom or third-party control.

Required

RememberMe

System.Web.UI.WebControls.CheckBox

Optional

FailureText

Any control that implements System.Web.UI.ITextControl.

Optional

Login

Any control that causes event bubbling.

Optional

The System.Web.UI.WebControls.Login control throws an System.Web.HttpException exception if the layout template does not contain the required controls. No exception is thrown if you give an optional control ID to a control of the wrong type; however, the control is subsequently ignored by the System.Web.UI.WebControls.Login control.

The login control can be any control that causes event bubbling, such as System.Web.UI.WebControls.Button, System.Web.UI.WebControls.LinkButton, or System.Web.UI.WebControls.ImageButton. The control's command name property must be set to "Login".

When a template is used for the System.Web.UI.WebControls.Login control, only the following properties affect the behavior of the control:

All other properties are inactive when a template is set for the System.Web.UI.WebControls.Login control.

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0