Поделиться через


WizardStepBase.AllowReturn Свойство

Определение

Получает или задает значение, показывающее, может ли пользователь вернуться к текущему шагу из последующего шага в коллекции WizardStepCollection.

public:
 virtual property bool AllowReturn { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool AllowReturn { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.AllowReturn : bool with get, set
Public Overridable Property AllowReturn As Boolean

Значение свойства

Значение true, если пользователь может вернуться к текущему шагу; в противном случае — false. Значение по умолчанию — true.

Атрибуты

Примеры

В следующем примере показано использование AllowReturn свойства , чтобы запретить пользователю вернуться к шагу в элементе Wizard управления после доступа к нему. В этом примере Step1 для свойства шага задано AllowReturn значение false. После того как пользователь покинет Step1 шаг, на шаге не отображается Step2 кнопка Назад.

<%@ 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">

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:Wizard id="Wizard1" 
        runat="server"
    displaysidebar="false" >
        <WizardSteps>
          <asp:WizardStep id="WizardStep1" 
            title="Step 1" 
            allowreturn="false"
            runat="server">
            You are currently on Step 1.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep2" 
            title="Step 2" 
            runat="server">
            You are currently on Step 2.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep3" 
            title="Step 3" 
            runat="server">
            You are currently on Step 3.
          </asp:WizardStep>
        </WizardSteps>
        <HeaderTemplate>
          <b>WizardStepBase AllowReturn 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">

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:Wizard id="Wizard1" 
        runat="server"
    displaysidebar="false" >
        <WizardSteps>
          <asp:WizardStep id="WizardStep1" 
            title="Step 1" 
            allowreturn="false"
            runat="server">
            You are currently on Step 1.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep2" 
            title="Step 2" 
            runat="server">
            You are currently on Step 2.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep3" 
            title="Step 3" 
            runat="server">
            You are currently on Step 3.
          </asp:WizardStep>
        </WizardSteps>
        <HeaderTemplate>
          <b>WizardStepBase AllowReturn Example</b>
        </HeaderTemplate>
      </asp:Wizard>
    </form>
  </body>
</html>

Комментарии

Свойство AllowReturn можно использовать для обеспечения линейной навигации в элементе Wizard управления . Если для каждого шага AllowReturn задано falseсвойство , пользователь не сможет вернуться к шагу после доступа к нему. Один из сценариев, в котором вы можете использовать эту функцию, заключается в запрете пользователю возвращаться к шагу после его завершения, так как данные сохраняются в базе данных по мере завершения каждого шага. Если сохранить данные после каждого шага и разрешить пользователю вернуться к шагу и изменить сведения после сохранения, сохраненные данные могут быть повреждены. Присвоив свойству AllowReturn значение false, после того как пользователь покинул шаг, он не сможет вернуться к нему и изменить значения.

Свойство AllowReturn определяет, как и когда кнопка Назад не отображается. В следующей таблице описано поведение отрисовки предыдущей кнопки.

Сценарий Поведение
Линейный: для шага 1 задано AllowReturn значение , false а действие пользователя переходит к шагу 2. На шаге 2 кнопка Назад не отображается.
Нелинейная. Для шага 1 задано AllowReturn значение , false а действие пользователя переходит к шагу 3. На шаге 3 кнопка Назад не отображается.
Кнопки боковой панели. Для шага 2 задано AllowReturn значение false , DisplaySideBar для задано значение true, а пользователь нажимает кнопку SideBar. Кнопки не отключаются автоматически на боковой панели, если AllowReturn для задано значение false. Если пользователь нажимает кнопку, действие игнорируется.
Линейный & нелинейный с пользовательским шаблоном. На этом шаге есть настраиваемый шаблон навигации. Автоматическое скрытие или отображение не происходит, если AllowReturn для параметра задано значение false при использовании шаблона для навигации. Кнопка Назад должна быть необязательной в шаблоне.
С помощью конструктора Visual Studio и ActiveStepIndex : элемент управления состоит из 5 шагов, вы работаете над шагом 4 и запускаете страницу. Если шаг 4 — , ActiveStepIndexотображается кнопка Назад . Кнопка Назад скрыта только для StepType параметра , Step если для предыдущего шага в журнале задано AllowReturn значение false. Так как шаг 4 отображается первым и в журнале нет шагов, кнопка Назад не скрыта.
Запуск шага и нелинейной навигации. Пользователь посещает шаги 3 и 4, а затем шаг 1, для которого задано StepType значение Start. Мастер не добавляет кнопку Назад , если StepType задано значение Start , независимо от того, как пользователь переходит к этому шагу.
Тот же шаг в журнале. Пользователь посещает шаг 3, где StepType задано значение Step , и пользователь не фиксирует свои действия. Затем они нажимают предыдущую кнопку на шаге 3. Элемент управления мастера проверяет, является ли предыдущий шаг в журнале "тем же", что и пользователь в данный момент. Если шаг совпадает, элемент управления мастера просматривает журнал, чтобы определить предыдущий "другой" шаг и основывает отображение кнопки Назад и назначения на основе "другого шага" в журнале.

Примечание

Если свойству AllowReturn присвоено значение false, а свойству DisplaySideBar родительского элемента управления присвоено WizardStepBase значение true, нажатие кнопки в области боковой панели не оказывает никакого влияния. Область боковой панели обычно отображается для обеспечения нелинейной навигации, поэтому, если вы не используете функции нелинейной навигации, может потребоваться задать для свойства значение DisplaySideBarfalse.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделе ThemeableAttribute и ASP.NET темы и обложки.

Применяется к

См. также раздел