Control.EnableViewState Properti

Referensi

Definisi

Ruang nama:: System.Web.UI

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server mempertahankan status tampilannya, dan status tampilan setiap kontrol anak yang dikandungnya, ke klien yang meminta.

public:
 virtual property bool EnableViewState { bool get(); void set(bool value); };

public virtual bool EnableViewState { get; set; }

[System.Web.UI.Themeable(false)]
public virtual bool EnableViewState { get; set; }

member this.EnableViewState : bool with get, set

[<System.Web.UI.Themeable(false)>]
member this.EnableViewState : bool with get, set

Public Overridable Property EnableViewState As Boolean

Nilai Properti

Boolean

true jika kontrol server mempertahankan status tampilannya; jika tidak false. Default adalah true.

Atribut: ThemeableAttribute

Contoh

Contoh berikut mengatur properti ke EnableViewStatefalse.

void Page_Load(object sender, System.EventArgs e)
{
      DataBind();
      // Set EnableViewState to false to disable saving of view state 
      // information.
      myControl.EnableViewState = false;
      if (!IsPostBack)
         display.Enabled = false;
      
}

Sub Page_Load(sender As Object, e As System.EventArgs)
   DataBind()
   ' Set EnableViewState to false to disable saving of view state 
   ' information.
   myControl.EnableViewState = False
   If Not IsPostBack Then
      display.Enabled = False
   End If 
End Sub

Keterangan

Status tampilan memungkinkan kontrol server untuk mempertahankan statusnya di seluruh permintaan HTTP. Status tampilan untuk kontrol diaktifkan jika semua kondisi berikut terpenuhi:

Properti EnableViewState untuk halaman diatur ke true.
Properti EnableViewState untuk kontrol diatur ke true.
Properti ViewStateMode untuk kontrol diatur ke Enabled atau mewarisi Enabled pengaturan.

Untuk informasi selengkapnya, lihat ViewStateMode properti.

Status tampilan kontrol server adalah akumulasi dari semua nilai propertinya. Untuk mempertahankan nilai-nilai ini di seluruh permintaan HTTP, ASP.NET menggunakan instans StateBag kelas untuk menyimpan nilai properti. Nilai kemudian diteruskan sebagai variabel ke bidang tersembunyi saat permintaan berikutnya diproses. Untuk informasi selengkapnya tentang status tampilan, lihat ASP.NET Lihat Gambaran Umum Status.

Ada kalanya tepat untuk menonaktifkan status tampilan, terutama untuk meningkatkan performa aplikasi. Misalnya, jika Anda memuat permintaan database ke kontrol server, atur properti ini ke false. Jika tidak, waktu prosesor akan sia-sia memuat status tampilan ke kontrol server yang hanya akan ditimpa oleh kueri database. Jika EnableViewState adalah false, Anda dapat menggunakan status kontrol untuk mempertahankan informasi properti yang khusus untuk kontrol dan tidak dapat dinonaktifkan seperti properti status tampilan. Untuk informasi selengkapnya tentang perbedaan antara status kontrol dan status tampilan, lihat Status Kontrol vs. Lihat Contoh Status.

Untuk informasi tentang cara mengaktifkan atau menonaktifkan status tampilan secara deklaratif untuk halaman ASP.NET, lihat @ Halaman.

Berlaku untuk

Bagikan melalui