WizardStepBase.AllowReturn Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Kullanıcının 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
true kullanıcının geçerli adıma dönmesine izin veriliyorsa; aksi takdirde , false. Varsayılan değer true değeridir.
- Öznitelikler
Ö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ünmez 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, bir kullanıcının tamamlandıktan sonra bir adıma geri dönmesine izin vermemektir çünkü verileri her adım tamamlandıktan sonra veritabanında kalıcı hale getirebilirsiniz. Verileri her adımdan sonra 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ımı bıraktıktan sonra özelliğini falseolarak ayarlayarakAllowReturn, 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.
| Scenario | Davranış |
|---|---|
Doğrusal: 1 AllowReturn . adım 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: 1 AllowReturn . adım olarak ayarlandı false ve kullanıcı eylemi 3. adıma geçiyor. |
3. adım , Önceki düğmesini görüntülemez. |
Kenar Çubuğu Düğmeleri: 2 AllowReturn . Adım olarak ayarlanır false , DisplaySideBar olarak ayarlanır 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. |
| Özel Şablon ile Doğrusal ve Doğrusal Olmayan: Adım özel bir gezinti şablonuna sahiptir. | 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 Designer ve ActiveStepIndex kullanarak: Denetimin 5 adımı vardır, 4. adım üzerinde çalışıyorsunuz ve sayfayı çalıştıracaksı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 Step ayarlandığında olarak ayarlanmış olarak gizlenir StepTypefalse. 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ı, 3. ve 4. adım ile 1. adımı ziyaret etti ve StepType bu adım olarak Startayarlandı. | Kullanıcı bu adıma nasıl gittiğine bakılmaksızın, sihirbaz olarak ayarlandığında StartÖnceki düğmesini StepType eklemez. |
| Geçmişe Yönelik Aynı 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ımdaki önceki düğmeye tıklarlar. | Sihirbaz denetimi, geçmişteki Önceki adımın kullanıcının şu anda açık 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 geri bakar ve geçmişteki "farklı adıma" göre Önceki düğmesinin ve hedefin görüntülenmesini temel alır. |
Uyarı
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 satır içi olmayan gezinti sağlamak için görüntülenir, bu nedenle doğrusal olmayan gezinti işlevini 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'i ASP.NET.