Wizard.FinishNavigationTemplate Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o modelo que é usado para mostrar a área de navegação no Finish passo.
public:
virtual property System::Web::UI::ITemplate ^ FinishNavigationTemplate { System::Web::UI::ITemplate ^ get(); void set(System::Web::UI::ITemplate ^ value); };[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.Wizard))]
public virtual System.Web.UI.ITemplate FinishNavigationTemplate { get; set; }[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.Web.UI.TemplateContainer(typeof(System.Web.UI.WebControls.Wizard))>]
member this.FinishNavigationTemplate : System.Web.UI.ITemplate with get, setPublic Overridable Property FinishNavigationTemplate As ITemplateValor de Propriedade
O ITemplate que define o conteúdo para a área de navegação para o Finish no Wizard. A predefinição é null.
- Atributos
Exemplos
O exemplo de código seguinte demonstra como usar a FinishNavigationTemplate propriedade para criar um modelo personalizado para a área de navegação do Finish passo do Wizard controlo.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void OnFinishButtonClick(object sender, EventArgs e)
{
// Insert code here that determines if an email address was
// entered in emailTextBox. Then send an confirmation email if it was.
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1"
title="FinishNavigationTemplate Example"
runat="server">
<asp:Wizard ID="Wizard1"
Runat="server"
ActiveStepIndex="0"
OnFinishButtonClick="OnFinishButtonClick">
<WizardSteps>
<asp:WizardStep Runat="server"
Title="Step 1">
<!-- Put UI elements for Step 1 here. -->
This is step one.
</asp:WizardStep>
<asp:WizardStep Runat="server"
Title="Step 2">
<!-- Put UI elements for Step 2 here. -->
This is step two.
</asp:WizardStep>
<asp:WizardStep Runat="server"
StepType="Complete"
Title="Complete">
The Wizard has been completed.
</asp:WizardStep>
</WizardSteps>
<FinishNavigationTemplate>
Please enter your email address if you would like a confirmation email:
<asp:TextBox ID="emailTextBox"
Runat="server">
</asp:TextBox>
<br />
<asp:Button CommandName="MovePrevious"
Runat="server"
Text="Previous" />
<asp:Button CommandName="MoveComplete"
Runat="server"
Text="Finish" />
</FinishNavigationTemplate>
<HeaderTemplate>
<b>FinishNavigationTemplate Example</b>
</HeaderTemplate>
</asp:Wizard>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub OnFinishButtonClick(ByVal sender As Object, ByVal e As WizardNavigationEventArgs)
' Insert code here that determines if an email address was
' entered in emailTextBox. Then send an confirmation email if it was.
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1"
title="FinishNavigationTemplate Example"
runat="server">
<asp:Wizard ID="Wizard1"
Runat="server"
ActiveStepIndex="0"
OnFinishButtonClick="OnFinishButtonClick">
<WizardSteps>
<asp:WizardStep Runat="server"
Title="Step 1">
<!-- Put UI elements for Step 1 here. -->
This is step one.
</asp:WizardStep>
<asp:WizardStep Runat="server"
Title="Step 2">
<!-- Put UI elements for Step 2 here. -->
This is step two.
</asp:WizardStep>
<asp:WizardStep Runat="server"
StepType="Complete"
Title="Complete">
The Wizard has been completed.
</asp:WizardStep>
</WizardSteps>
<FinishNavigationTemplate>
Please enter your email address if you would like a confirmation email:
<asp:TextBox ID="emailTextBox"
Runat="server">
</asp:TextBox>
<br />
<asp:Button CommandName="MovePrevious"
Runat="server"
Text="Previous" />
<asp:Button CommandName="MoveComplete"
Runat="server"
Text="Finish" />
</FinishNavigationTemplate>
<HeaderTemplate>
<b>FinishNavigationTemplate Example</b>
</HeaderTemplate>
</asp:Wizard>
</form>
</body>
</html>
Observações
Use a FinishNavigationTemplate propriedade para especificar o conteúdo personalizado que é exibido para a área de navegação no Finish passo do Wizard controlo. Defina o conteúdo criando um modelo que especifique como a área de navegação é renderizada no Finish passo.
O conteúdo personalizado do modelo está contido no FinishNavigationTemplate objeto. Pode adicionar conteúdo personalizado ao FinishNavigationTemplate objeto usando o modo de edição de modelos na vista de design ou definindo o FinishNavigationTemplate objeto inline usando FinishNavigationTemplate tags. O conteúdo pode ser tão simples como texto simples ou mais complexo (incorporar outros controlos no modelo, por exemplo).
Note
O FinishNavigationTemplate objeto contido na FinishNavigationTemplate propriedade deve conter dois IButtonControl controlos, um com CommandName a propriedade definida para "MoveComplete" e outro com CommandName a propriedade definida para "MovePrevious", para ativar a funcionalidade de navegação.
Para aceder a um controlo definido programaticamente num modelo, use a Controls coleção do Wizard objeto. Também pode usar o FindControl método do Wizard objeto para encontrar o controlo, se o controlo tiver uma ID propriedade especificada.