Control.SaveControlState Metoda

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server.

protected public:
 virtual System::Object ^ SaveControlState();
protected internal virtual object SaveControlState();
abstract member SaveControlState : unit -> obj
override this.SaveControlState : unit -> obj
Protected Friend Overridable Function SaveControlState () As Object

Návraty

Object

Vrátí aktuální stav ovládacího prvku serveru. Pokud neexistuje žádný stav přidružený k ovládacímu prvku, tato metoda vrátí null.

Příklady

Následující příklad kódu přepíše metodu SaveControlState ve vlastním ovládacím prvku ASP.NET. Při vyvolání této metody určuje, zda je interní vlastnost currentIndex nastavena na ne-výchozí hodnotu, a pokud ano, uloží hodnotu do stavu řízení.

Metoda OnInit je přepsána, aby volala metodu RegisterRequiresControlStatePage na značce, že vlastní ovládací prvek používá stav ovládacího prvku.

public class Sample : Control {
    private int currentIndex = 0;
   
    protected override void OnInit(EventArgs e) {
        Page.RegisterRequiresControlState(this);
        base.OnInit(e);
    }

    protected override object SaveControlState() {
        return currentIndex != 0 ? (object)currentIndex : null;
    }

    protected override void LoadControlState(object state) {
        if (state != null) {
            currentIndex = (int)state;
        }
    }
}

Class Sample
  Inherits Control
  
  Dim currentIndex As Integer
  
      Protected Overrides Sub OnInit(ByVal e As EventArgs)
          Page.RegisterRequiresControlState(Me)
          currentIndex = 0
          MyBase.OnInit(e)
      End Sub
  
      Protected Overrides Function SaveControlState() As Object
          If currentIndex <> 0 Then
              Return CType(currentIndex, Object)
          Else
              Return Nothing
          End If
      End Function
  
      Protected Overrides Sub LoadControlState(ByVal state As Object)
          If (state <> Nothing) Then
              currentIndex = CType(state, Integer)
          End If
      End Sub
  
End Class

Poznámky

Použijte metodu SaveControlState k uložení informací o stavu požadovaných pro provoz určitého ovládacího prvku. Tato data stavu řízení se ukládají odděleně od dat ovládacího prvku o stavu zobrazení.

Vlastní ovládací prvky používající stav ovládacího prvku musí před uložením stavu ovládacího prvku volat RegisterRequiresControlState metodu Page .

Poznámky pro dědice

Při uložení stavu ovládacího prvku se řetězcový objekt vrátí klientovi jako proměnná uložená v elementu HTML HIDDEN . Tuto metodu přepište tak, aby extrahovali informace o stavu, které se mají použít ve vašem ovládacím prvku.

Stav ovládacího prvku je určený pro malé objemy důležitých dat, jako je index stránky nebo klíčové slovo. Použití stavu řízení u velkých objemů dat může nepříznivě ovlivnit výkon stránky. Další informace najdete v tématu ASP.NET Přehled správy stavu.

Platí pro

Viz také