Share via

WizardStepBase.AllowReturn Properti

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengguna diizinkan untuk kembali ke langkah saat ini dari langkah berikutnya dalam WizardStepCollection koleksi.

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

Nilai Properti

Boolean

true jika pengguna diizinkan untuk kembali ke langkah saat ini; jika tidak, false. Nilai defaultnya adalah true.

Atribut
ThemeableAttribute

Contoh

Contoh berikut menunjukkan penggunaan AllowReturn properti untuk menghentikan pengguna kembali ke langkah dalam Wizard kontrol setelah diakses. Dalam contoh, Step1 langkah mengatur propertinya AllowReturn ke false. Setelah pengguna meninggalkan Step1 langkah, tidak ada tombol Sebelumnya yang muncul pada langkah tersebut 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>

Keterangan

Properti AllowReturn dapat digunakan untuk memberlakukan navigasi linier dalam Wizard kontrol. Jika setiap langkah mengatur propertinya AllowReturn ke false, pengguna tidak akan dapat kembali ke langkah setelah diakses. Salah satu skenario di mana Anda mungkin menggunakan fungsionalitas ini adalah melarang pengguna untuk kembali ke langkah setelah selesai karena Anda menyimpan data ke database saat setiap langkah selesai. Jika Anda menyimpan data setelah setiap langkah dan mengizinkan pengguna untuk kembali ke langkah dan mengubah informasi setelah disimpan, data yang disimpan mungkin menjadi rusak. Dengan mengatur AllowReturn properti ke false, setelah pengguna meninggalkan langkah, mereka tidak akan dapat kembali ke properti tersebut dan mengubah nilai apa pun.

Properti AllowReturn menentukan bagaimana dan kapan tombol Sebelumnya tidak dirender. Tabel berikut ini menjelaskan perilaku penyajian tombol Sebelumnya .

Skenario Aktivitas
Linear: Langkah 1 telah AllowReturn diatur ke false dan tindakan pengguna masuk ke langkah 2. Langkah 2 tidak menampilkan tombol Sebelumnya .
Non-Linear: Langkah1 telah AllowReturn diatur ke false dan tindakan pengguna masuk ke langkah 3. Langkah 3 tidak menampilkan tombol Sebelumnya .
Tombol Bilah Sisi: Langkah 2 telah AllowReturn diatur ke false , DisplaySideBar diatur ke true, dan pengguna mengklik tombol Bilah Samping. Tidak ada tombol yang secara otomatis dinonaktifkan pada bar samping saat AllowReturn diatur ke false. Jika pengguna mengklik tombol , tindakan akan diabaikan.
Linear & Non-Linear dengan Templat Kustom: Langkah ini memiliki templat navigasi kustom. Tidak ada persembunyian atau tampilan otomatis yang terjadi jika AllowReturn diatur ke false saat Anda menggunakan templat untuk navigasi. Tombol Sebelumnya harus opsional pada templat.
Menggunakan Visual Studio Designer dan ActiveStepIndex : Kontrol memiliki 5 langkah, Anda sedang mengerjakan langkah 4, dan Anda menjalankan halaman. Ketika langkah 4 adalah ActiveStepIndex, maka tombol Sebelumnya dirender. Tombol Sebelumnya hanya disembunyikan untuk StepType diatur ke Step ketika langkah sebelumnya dalam riwayat telah AllowReturn diatur ke false. Karena langkah 4 dirender terlebih dahulu dan tidak ada langkah-langkah dalam riwayat, tombol Sebelumnya tidak disembunyikan.
Mulai Langkah dan Navigasi Non-Linear: Pengguna mengunjungi langkah 3 dan langkah 4 lalu langkah 1 yang telah StepType diatur ke Start. Wizard tidak menambahkan tombol Sebelumnya saat StepType diatur ke Start terlepas dari bagaimana pengguna menavigasi ke langkah tersebut.
Riwayat Langkah yang Sama: Pengguna mengunjungi langkah 3 di mana StepType diatur ke Step dan pengguna tidak melakukan tindakan mereka. Mereka kemudian mengklik tombol sebelumnya pada langkah 3. Kontrol wizard memeriksa untuk melihat apakah langkah Sebelumnya dalam riwayat adalah langkah "sama" yang saat ini digunakan pengguna. Jika langkahnya sama, kontrol wizard melihat kembali riwayat untuk menentukan langkah "berbeda" sebelumnya dan mendasarkan tampilan tombol dan tujuan Sebelumnya berdasarkan "langkah yang berbeda" dalam riwayat.

Catatan

AllowReturn Ketika properti diatur ke false, tetapi DisplaySideBar properti kontrol WizardStepBase induk diatur ke true, mengklik tombol di area bar samping tidak berpengaruh. Area bilah samping umumnya ditampilkan untuk menyediakan navigasi nonlinear, jadi jika Anda tidak menggunakan fungsionalitas navigasi nonlinear, Anda mungkin ingin mengatur DisplaySideBar properti ke false.

Properti ini tidak dapat diatur oleh tema atau tema lembar gaya. Untuk informasi selengkapnya, lihat ThemeableAttribute dan ASP.NET Tema dan Kulit.

Berlaku untuk

Lihat juga