Control.SaveViewState Metode
Definisi
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.
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
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.