Control.SaveViewState Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.dll

Menyimpan perubahan status tampilan kontrol server yang telah terjadi sejak halaman diposting kembali ke server.

protected:
 virtual System::Object ^ SaveViewState();

protected virtual object SaveViewState ();

abstract member SaveViewState : unit -> obj
override this.SaveViewState : unit -> obj

Protected Overridable Function SaveViewState () As Object

Mengembalikan

Object

Mengembalikan status tampilan kontrol server saat ini. Jika tidak ada status tampilan yang terkait dengan kontrol, metode ini mengembalikan null.

Contoh

Contoh berikut mengambil SaveViewState alih metode dalam kontrol server ASP.NET kustom. Ketika metode ini dipanggil, metode ini menentukan apakah kontrol memiliki kontrol turunan dan apakah objek yang berisi Page adalah hasil dari postback. Jika keduanya benar, itu mengubah Text properti Label kontrol server Web untuk membaca Custom Control Has Saved State. Kemudian menyimpan status tampilan kontrol sebagai array objek, bernama allStates.

protected override object SaveViewState()
{  // Change Text Property of Label when this function is invoked.
   if(HasControls() && (Page.IsPostBack))
   {
      ((Label)(Controls[0])).Text = "Custom Control Has Saved State";
   }
   // Save State as a cumulative array of objects.
   object baseState = base.SaveViewState();
   string userText = UserText;
   string passwordText = PasswordText;
   object[] allStates = new object[3];
   allStates[0] = baseState;
   allStates[1] = userText;
   allStates[2] = PasswordText;
   return allStates;
}

Protected Overrides Function SaveViewState() As Object
   ' Change Text Property of Label when this function is invoked.
   If HasControls() And Page.IsPostBack Then
      CType(Controls(0), Label).Text = "Custom Control Has Saved State"
   End If
   ' Save State as a cumulative array of objects.
   Dim baseState As Object = MyBase.SaveViewState()
   Dim _userText As String = UserText
   Dim _passwordText As String = PasswordText
   Dim allStates(3) As Object
   allStates(0) = baseState
   allStates(1) = _userText
   allStates(2) = PasswordText
   Return allStates
End Function

Keterangan

Status tampilan adalah akumulasi nilai properti kontrol server. Nilai-nilai ini secara otomatis ditempatkan di properti kontrol ViewState server, yang merupakan instans StateBag kelas . Nilai properti ini kemudian dipertahankan ke objek string setelah tahap status penyimpanan siklus hidup kontrol server. Untuk informasi selengkapnya, lihat Gambaran Umum Siklus Hidup Halaman ASP.NET.

Saat status tampilan disimpan, objek string ini dikembalikan ke klien sebagai variabel yang disimpan dalam elemen HTML HIDDEN . Saat Anda menulis kontrol server kustom dengan status tampilan kustom, status tampilan dapat dikelola secara eksplisit dengan SaveViewState metode dan LoadViewState . Untuk informasi selengkapnya, lihat Gambaran Umum Manajemen Status ASP.NET. Untuk informasi tentang menerapkan penyedia keadaan sesi kustom, lihat Menerapkan Penyedia Penyimpanan Session-State.

Lihat juga

• LoadViewState(Object)
• ViewState
• StateBag
• Ringkasan Manajemen Status ASP.NET
• Menerapkan Penyedia Penyimpanan Session-State