Wizard.AllowNavigationToStep(Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Verwendet einen booleschen Wert, um zu bestimmen, ob die ActiveStep-Eigenschaft auf das WizardStepBase-Objekt festgelegt werden kann, das dem übergebenen Index entspricht.
protected:
virtual bool AllowNavigationToStep(int index);protected virtual bool AllowNavigationToStep (int index);abstract member AllowNavigationToStep : int -> bool
override this.AllowNavigationToStep : int -> boolProtected Overridable Function AllowNavigationToStep (index As Integer) As BooleanParameter
- index
- Int32
Der Index des zu überprüfenden WizardStepBase-Objekts.
Gibt zurück
false, wenn der übergebene Index auf eine WizardStepBase verweist, auf die bereits zugegriffen und deren AllowReturn-Eigenschaft auf false festgelegt wurde, andernfalls true.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie zum Erstellen einer abgeleiteten Klasse, die mit dem Namen CustomWizard und überschreiben die OnSideBarButtonClick Methode. Wenn auf eine Schaltfläche im Randleistenbereich des der CustomWizard Steuerelement geklickt wird, die AllowNavigationToStep aufgerufen, um zu bestimmen, ob es sich bei der ausgewählte Schritt zugegriffen werden kann. Eine Nachricht wird dann in die Webseite, die darüber informiert den Benutzer ist geschrieben.
<%@ 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">
// This custom wizard control defines the OnSideBarButtonClick method
// that uses the AllowNavigationToStep method to determine whether the
// value passed in can be used to set the ActiveStepIndex property.
class CustomWizard : Wizard
{
override protected void OnSideBarButtonClick(WizardNavigationEventArgs e)
{
base.OnSideBarButtonClick(e);
if (AllowNavigationToStep(e.NextStepIndex))
{
this.Page.Response.Write("AllowNavigationToStep() returned true, moving to Step"
+ (e.NextStepIndex + 1).ToString() + ".");
this.ActiveStepIndex = e.NextStepIndex;
}
else
{
this.Page.Response.Write("AllowNavigationToStep() returned false for Step"
+ (e.NextStepIndex + 1).ToString() + ", moving to Step2.");
this.ActiveStepIndex = 1;
}
}
}
// Add the custom wizard control to the page.
void Page_Load(object sender, EventArgs e)
{
CustomWizard WizardControl = new CustomWizard();
WizardControl.ID = "WizardControl";
// Create some steps for the custom wizard.
for (int i = 0; i <= 5; i++)
{
WizardStep newStep = new WizardStep();
newStep.ID = "Step" + (i + 1).ToString();
// Set AllowReturn to false for some of the steps.
if ((i % 2) == 0)
{
newStep.AllowReturn = false;
}
// Add each step to the custom wizard.
WizardControl.WizardSteps.Add(newStep);
}
// Display the wizard on the page.
PlaceHolder1.Controls.Add(WizardControl);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>AllowNavigationToStep Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>AllowNavigationToStep Example</h3>
<asp:PlaceHolder id="PlaceHolder1"
runat="server" />
</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">
' This custom wizard control defines the OnSideBarButtonClick method
' that uses the AllowNavigationToStep method to determine whether the
' value passed in can be used to set the ActiveStepIndex property.
Class CustomWizard
Inherits Wizard
Protected Overloads Sub OnSideBarButtonClick(ByVal sender As Object, _
ByVal e As WizardNavigationEventArgs) Handles Me.SideBarButtonClick
If AllowNavigationToStep(e.NextStepIndex) Then
Me.Page.Response.Write("AllowNavigationToStep() returned true, moving to Step" & _
(e.NextStepIndex + 1).ToString() & ".")
Me.ActiveStepIndex = e.NextStepIndex
Else
Me.Page.Response.Write("AllowNavigationToStep() returned false for Step" & _
(e.NextStepIndex + 1).ToString() & ", moving to Step2.")
Me.ActiveStepIndex = 1
End If
End Sub
End Class
' Add the custom wizard control to the page.
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
Dim WizardControl As New CustomWizard()
WizardControl.ID = "WizardControl"
' Create some steps for the custom wizard.
For i As Integer = 0 To 5
Dim newStep As New WizardStep()
newStep.ID = "Step" & (i + 1).ToString()
' Set AllowReturn to false for some of the steps.
If ((i Mod 2) = 0) Then
newStep.AllowReturn = False
End If
' Add each step to the custom wizard.
WizardControl.WizardSteps.Add(newStep)
Next
' Display the wizard on the page.
PlaceHolder1.Controls.Add(WizardControl)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>AllowNavigationToStep Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>AllowNavigationToStep Example</h3>
<asp:PlaceHolder id="PlaceHolder1"
runat="server" />
</form>
</body>
</html>
Hinweise
Die AllowNavigationToStep Methode zugegriffen werden kann, durch eine abgeleitete Klasse nur aufgrund der seine protected Modifizierer. In einer abgeleiteten Klasse können Sie mithilfe der AllowNavigationToStep Methode, um zu bestimmen, ob der Index, der übergeben wird, legen Sie verwendet werden kann die ActiveStepIndex Eigenschaft. Die AllowNavigationToStep Methode zurück false , wenn der Index, der übergeben wird, bezieht sich ein WizardStepBase -Objekt, das bereits zugegriffen und verfügt über seine AllowReturn -Eigenschaft auf festgelegt falseist, andernfalls wird zurückgegeben, die true.
