WebControl.SaveViewState Method

Definition

Enregistre les états qui ont été modifiés après l’appel de la méthode TrackViewState().Saves any state that was modified after the TrackViewState() method was invoked.

protected:
 override System::Object ^ SaveViewState();
protected override object SaveViewState ();
override this.SaveViewState : unit -> obj
Protected Overrides Function SaveViewState () As Object

Returns

Object

Objet qui contient l’état d’affichage actuel du contrôle ; sinon, si aucun état d’affichage n’est associé au contrôle, null.An object that contains the current view state of the control; otherwise, if there is no view state associated with the control, null.

Remarks

La méthode SaveViewState est principalement utilisée par les développeurs de contrôles.The SaveViewState method is used primarily by control developers.

L’état d’affichage est le cumul des valeurs des propriétés d’un contrôle serveur.View state is the cumulative values of the properties for a server control. Ces valeurs sont placées automatiquement dans la propriété ViewState pour le contrôle serveur, qui est une instance de la classe StateBag.These values are placed automatically in the ViewState property for the server control, which is an instance of the StateBag class. La valeur de la propriété ViewState est ensuite rendue persistante dans un objet String après l’étape d’enregistrement de l’état du cycle de vie du contrôle serveur.The ViewState property value is then persisted to a string object after the save state stage of the life cycle for the server control. Pour plus d’informations, consultez vue d’ensemble du cycle de vie d’une Page ASP.net.For more information, see ASP.NET Page Life Cycle Overview.

Lorsque l’état d’affichage est enregistré, cet objet String est retourné au client sous la forme d’une variable stockée dans un élément input HTML masqué.When view state is saved, this string object is returned to the client as a variable that is stored in a hidden HTML input element. Lorsque vous créez des contrôles serveur personnalisés, vous pouvez améliorer l’efficacité en remplaçant la méthode SaveViewState et en modifiant la propriété ViewState pour votre contrôle serveur.When you author custom server controls, you can improve efficiency by overriding the SaveViewState method and modifying the ViewState property for your server control. Pour plus d’informations, consultez vue d’ensemble de la gestion d’état ASP.net.For more information, see ASP.NET State Management Overview.

Applies to

See also