WizardStepBase.AllowReturn Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Kullanıcının bir koleksiyondaki sonraki bir adımdan geçerli adıma dönmesine izin verilip verilmeyeceğini belirten bir WizardStepCollection değer alır veya ayarlar.

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

Özellik Değeri

Boolean

true kullanıcının geçerli adıma dönmesine izin verilirse; aksi takdirde , false. true varsayılan değerdir.

Öznitelikler
ThemeableAttribute

Örnekler

Aşağıdaki örnekte, kullanıcının erişimden sonra denetimdeki Wizard bir adıma geri dönmesini durdurmak için özelliğinin kullanılması AllowReturn gösterilmektedir. Örnekte, adımın Step1 özelliği olarak falseayarlanmıştırAllowReturn. Kullanıcı adımdan Step1 ayrıldıktan sonra, adımda Önceki düğmesi görüntülenmez 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>

Açıklamalar

özelliği, AllowReturn bir Wizard denetimde doğrusal gezintiyi zorlamak için kullanılabilir. Her adımın AllowReturn özelliği olarak ayarlandıysa false, kullanıcı erişildikten sonra bir adıma geri dönemez. Bu işlevi kullanabileceğiniz bir senaryo, her adım tamamlandıktan sonra verileri veritabanında kalıcı hale getirdiğinizden, kullanıcının tamamlandıktan sonraki bir adıma geri dönmesine izin vermemektir. Her adımdan sonra verileri kaydeder ve kullanıcının bir adıma dönmesine ve kaydedildikten sonra bilgileri değiştirmesine izin verirseniz, kaydedilen veriler bozulabilir. kullanıcı bir adımdan ayrıldıktan sonra özelliğini olarak falseayarlayarakAllowReturn, bu özelliğe geri dönemez ve herhangi bir değeri değiştiremez.

özelliği, AllowReturnÖnceki düğmesinin nasıl ve ne zaman işlenmediğini belirler. Aşağıdaki tabloda , Önceki düğme işleme davranışı açıklanmaktadır.

Senaryo Davranış
Doğrusal: Adım1 AllowReturn olarak ayarlandı false ve kullanıcı eylemi 2. adıma geçiyor. 2. Adım , Önceki düğmesini görüntülemez.
Doğrusal Olmayan: Adım1 AllowReturn olarak ayarlanmıştır false ve kullanıcı eylemi 3. adıma gider. 3. Adım , Önceki düğmesini görüntülemez.
Kenar Çubuğu Düğmeleri: 2 AllowReturn . adım olarak ayarlandı false , DisplaySideBar olarak ayarlandı trueve kullanıcı Kenar Çubuğu düğmesine tıklar. olarak ayarlandığında falsekenar çubuğunda AllowReturn hiçbir düğme otomatik olarak devre dışı bırakılmaz. Kullanıcı düğmeye tıklarsa, eylem yoksayılır.
Doğrusal & Özel Şablon ile Doğrusal Olmayan: Adımın özel bir gezinti şablonu vardır. Gezinti için şablon kullandığınızda olarak ayarlanırsa AllowReturnfalse otomatik gizleme veya görüntüleme gerçekleşmez. Şablonda Önceki düğmesi isteğe bağlı olmalıdır.
Visual Studio Tasarım Aracı ve ActiveStepIndex kullanarak: Denetimin 5 adımı vardır, 4. adım üzerinde çalışıyorsunuz ve sayfayı çalıştırırsınız. 4. adım olduğundaActiveStepIndex, Önceki düğmesi işlenir. Önceki düğmesi yalnızca geçmişteki AllowReturn bir önceki adım olarak ayarlandığında için gizlenir StepTypeStepfalse. 4. adım önce işlendiğinden ve geçmişte hiçbir adım olmadığından , Önceki düğmesi gizli değildir.
Başlangıç Adımı ve Doğrusal Olmayan Gezinti: Kullanıcı, olarak ayarlanmış Start3. ve 4. adım ile 1StepType. adımı ziyaret etti. sihirbaz, kullanıcının bu adıma nasıl gittiğine Start bakılmaksızın olarak ayarlandığında Önceki düğmesini StepType eklemez.
Aynı Geçmiş Adımı: Kullanıcı, 3 StepType . adımı ziyaret eder ve burada olarak ayarlanır Step ve kullanıcı eylemlerini işlemez. Ardından 3. adımda önceki düğmeye tıklarlar. Sihirbaz denetimi, geçmişteki Önceki adımın kullanıcının şu anda üzerinde olduğu "aynı" adım olup olmadığını denetler. Adım aynıysa, sihirbaz denetimi önceki "farklı" adımı belirlemek için geçmişe bakar ve geçmişteki "farklı adım" temelinde Önceki düğmesinin ve hedefin görüntülenmesini temel alır.

Not

AllowReturn özelliği olarak falseayarlandığında, ancak DisplaySideBar üst denetiminin WizardStepBase özelliği olarak ayarlandığında, kenar çubuğu alanındaki bir düğmeye truetıklandığında hiçbir etkisi olmaz. Kenar çubuğu alanı genellikle doğrusal olmayan gezinti sağlamak için görüntülenir, bu nedenle doğrusal olmayan gezinti işlevselliğini kullanmıyorsanız özelliğini olarak falseayarlamak DisplaySideBar isteyebilirsiniz.

Bu özellik temalar veya stil sayfası temaları tarafından ayarlanamaz. Daha fazla bilgi için bkz ThemeableAttribute . temalar ve dış görünümler ASP.NET.

Şunlara uygulanır

Ayrıca bkz.