Wizard.FinishNavigationTemplate Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o modelo usado para exibir a área de navegação na etapa Finish.
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 da propriedade
O ITemplate que define o conteúdo para a área de navegação do Finish no Wizard. O padrão é null.
- Atributos
Exemplos
O exemplo de código a Finish seguir demonstra como usar a FinishNavigationTemplate propriedade para criar um modelo personalizado para a área de navegação da etapa para o Wizard controle.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.
<%@ 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>
Comentários
Use a FinishNavigationTemplate propriedade para especificar o conteúdo personalizado exibido para a área de navegação na Finish etapa do Wizard controle. Defina o conteúdo criando um modelo que especifica como a área de navegação é renderizada na Finish etapa.
O conteúdo personalizado do modelo está contido no FinishNavigationTemplate objeto . Você pode adicionar conteúdo personalizado ao objeto usando o FinishNavigationTemplate modo de edição de modelo no modo de design ou definindo o FinishNavigationTemplate objeto embutido usando FinishNavigationTemplate marcas. O conteúdo pode ser tão simples quanto texto sem formatação ou mais complexo (inserindo outros controles no modelo, por exemplo).
Observação
O FinishNavigationTemplate objeto contido na FinishNavigationTemplate propriedade deve conter dois IButtonControl controles, um com sua CommandName propriedade definida como "MoveComplete" e o outro com sua CommandName propriedade definida como "MovePrevious", para habilitar o recurso de navegação.
Para acessar um controle definido em um modelo programaticamente, use a Controls coleção do Wizard objeto . Você também pode usar o FindControl método do Wizard objeto para localizar o controle, se o controle tiver uma ID propriedade especificada.
