WizardStepBase.AllowReturn Свойство

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает или задает значение, указывающее, разрешено ли пользователю вернуться к текущему шагу из последующего 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

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

Boolean

Значение в противном случае . Значение по умолчанию — true.

Атрибуты: ThemeableAttribute

Примеры

В следующем примере показано использование AllowReturn свойства, чтобы остановить возвращение пользователя к шагу элемента Wizard управления после доступа к нему. В этом примере для Step1 шага задано falseсвойствоAllowReturn. После того как пользователь покидает 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 управления. Если для каждого шага задано falseсвойствоAllowReturn, пользователь не сможет вернуться к шагу после получения доступа. Один из сценариев, в котором можно использовать эту функцию, заключается в том, чтобы запретить пользователю вернуться к шагу после его завершения, так как данные сохраняются в базе данных по мере завершения каждого шага. Если вы сохраните данные после каждого шага и позволите пользователю вернуться к шагу и изменить сведения после его сохранения, сохраненные данные могут быть повреждены. Присвоив свойству AllowReturnfalseзначение , когда пользователь оставил шаг, он не сможет вернуться к нему и изменить значения.

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

Сценарий	Поведение
Линейный: шаг 1 AllowReturn имеет значение `false` и действие пользователя переходит к шагу 2.	Шаг 2 не отображает кнопку "Назад ".
Нелинейная: шаг 1 AllowReturn установлен и `false` действие пользователя переходит к шагу 3.	Шаг 3 не отображает кнопку "Назад ".
Кнопки боковой панели: для шага 2 AllowReturn задано `false` значение , DisplaySideBar и `true`пользователь нажимает кнопку "Боковая панель".	При установке `false`кнопки не отключаются автоматически на боковой панелиAllowReturn. Если пользователь нажимает кнопку, действие игнорируется.
Линейная и нелинейная с пользовательским шаблоном: на шаге есть пользовательский шаблон навигации.	При использовании шаблона для навигации не возникает 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значение, нажатие кнопки в боковой области не влияет. Область боковой панели обычно отображается для обеспечения нелинейной навигации, поэтому если вы не используете функцию нелинейной навигации, может потребоваться задать DisplaySideBar для свойства значение false.

Это свойство не может быть задано темами или темами таблицы стилей. Дополнительные сведения см. в статье ThemeableAttribute и ASP.NET темы и скины.

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

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

Обратная связь

Были ли сведения на этой странице полезными?

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