Wizard.FinishNavigationTemplate Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает шаблон, используемый для отображения области навигации на шаге 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, set
Public Overridable Property FinishNavigationTemplate As ITemplate
Значение свойства
Определяет ITemplate содержимое области навигации для области навигации для этого контроллераWizardFinish. Значение по умолчанию — null.
- Атрибуты
Примеры
В следующем примере кода показано, как использовать FinishNavigationTemplate свойство для создания пользовательского Finish шаблона для области навигации шага элемента Wizard управления.
Это важно
В этом примере есть текстовое поле, которое принимает входные данные пользователя, которое является потенциальной угрозой безопасности. По умолчанию ASP.NET веб-страницы проверяют, что входные данные пользователя не включают скрипт или ЭЛЕМЕНТЫ HTML. Дополнительные сведения см. в разделе "Обзор эксплойтов скриптов".
<%@ 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>
Комментарии
FinishNavigationTemplate Используйте свойство, чтобы указать пользовательское содержимое, отображаемое для области навигации на Finish шаге Wizard элемента управления. Определите содержимое, создав шаблон, указывающий способ отображения области навигации на шаге Finish .
Пользовательское содержимое шаблона содержится в объекте FinishNavigationTemplate . Пользовательское содержимое можно добавить в FinishNavigationTemplate объект с помощью режима редактирования шаблонов в режиме конструктора или путем определения встроенного FinishNavigationTemplate объекта с помощью FinishNavigationTemplate тегов. Содержимое может быть таким же простым, как обычный текст или более сложным (например, внедрение других элементов управления в шаблон).
Замечание
Объект FinishNavigationTemplate , содержащийся в свойстве FinishNavigationTemplate , должен содержать два IButtonControl элемента управления, один из них CommandName имеет значение MoveComplete, а другой — CommandName "MovePrevious", чтобы включить функцию навигации.
Чтобы получить доступ к элементу управления, определенному в шаблоне программным способом, используйте Controls коллекцию Wizard объекта. Можно также использовать FindControl метод Wizard объекта для поиска элемента управления, если элемент управления имеет указанное ID свойство.