Wizard.FinishNavigationTemplate Property

Definition

Ottiene o imposta il modello utilizzato per visualizzare l'area di navigazione nel passaggio Finish.Gets or sets the template that is used to display the navigation area on the Finish step.

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; }
member this.FinishNavigationTemplate : System.Web.UI.ITemplate with get, set
Public Overridable Property FinishNavigationTemplate As ITemplate

Property Value

ITemplate

Interfaccia ITemplate che definisce il contenuto dell'area di navigazione per l'oggetto Finish nella classe Wizard.The ITemplate that defines the content for the navigation area for the Finish on the Wizard. Il valore predefinito è null.The default is null.

Attributes

Examples

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà FinishNavigationTemplate per creare un modello personalizzato per l'area di navigazione del passaggio Finish per il controllo Wizard.The following code example demonstrates how to use the FinishNavigationTemplate property to create a custom template for the navigation area of the Finish step for the Wizard control.

Important

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza.This example has a text box that accepts user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.For more information, see Script Exploits Overview.

<%@ 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>
          &nbsp;<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>
          &nbsp;<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>

Remarks

Utilizzare la proprietà FinishNavigationTemplate per specificare il contenuto personalizzato visualizzato per l'area di navigazione nel passaggio Finish del controllo Wizard.Use the FinishNavigationTemplate property to specify the custom content that is displayed for the navigation area on the Finish step of the Wizard control. Definire il contenuto creando un modello che specifica come viene eseguito il rendering dell'area di navigazione nel passaggio Finish.Define the content by creating a template that specifies how the navigation area is rendered on the Finish step.

Il contenuto personalizzato per il modello è contenuto all'interno dell'oggetto FinishNavigationTemplate.The custom content for the template is contained within the FinishNavigationTemplate object. È possibile aggiungere contenuto personalizzato all'oggetto FinishNavigationTemplate usando la modalità di modifica dei modelli nella visualizzazione progettazione o definendo l'oggetto FinishNavigationTemplate inline usando i tag FinishNavigationTemplate.You can add custom content to the FinishNavigationTemplate object either by using template-editing mode in design view or by defining the FinishNavigationTemplate object inline using FinishNavigationTemplate tags. Il contenuto può essere semplice come testo normale o più complesso, ad esempio incorporando altri controlli nel modello.The content can be as simple as plain text or more complex (embedding other controls in the template, for example).

Note

L'oggetto FinishNavigationTemplate contenuto nella proprietà FinishNavigationTemplate deve contenere due controlli IButtonControl, uno con la proprietà CommandName impostata su "MoveComplete" e l'altro con la relativa proprietà CommandName impostata su "MovePrevious" per abilitare la funzionalità di navigazione.The FinishNavigationTemplate object that is contained in the FinishNavigationTemplate property must contain two IButtonControl controls, one with its CommandName property set to "MoveComplete" and the other with its CommandName property set to "MovePrevious", to enable the navigation feature.

Per accedere a un controllo definito in un modello a livello di codice, utilizzare la raccolta Controls dell'oggetto Wizard.To access a control that is defined in a template programmatically, use the Controls collection of the Wizard object. È anche possibile usare il metodo FindControl dell'oggetto Wizard per trovare il controllo, se il controllo ha una proprietà ID specificata.You can also use the FindControl method of the Wizard object to find the control, if the control has an ID property specified.

Applies to

See also