PageStatePersister.ControlState Proprietà

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Ottiene o imposta un oggetto che rappresenta i dati utilizzati dai controlli contenuti nell'oggetto Page corrente per la persistenza tra le richieste HTTP inviate al server Web.

public:
 property System::Object ^ ControlState { System::Object ^ get(); void set(System::Object ^ value); };

public object ControlState { get; set; }

member this.ControlState : obj with get, set

Public Property ControlState As Object

Valore della proprietà

Object

Un oggetto che contiene i dati relativi allo stato di visualizzazione.

Esempio

Nell'esempio di codice seguente viene illustrato come una classe che deriva dalla PageStatePersister classe inizializza la ControlState proprietà . In questo esempio la ControlState proprietà è stata assegnata al Second campo di un Pair oggetto e serializzata usando la ObjectStateFormatter classe . Quando viene chiamato il Load metodo , la ObjectStateFormatter classe viene utilizzata per deserializzare le informazioni sullo stato di visualizzazione e sullo stato del controllo e la ControlState proprietà viene inizializzata dal campo dell'oggetto Second risultantePair. Questo esempio di codice fa parte di un esempio più ampio fornito per la PageStatePersister classe .

//
// Load ViewState and ControlState.
//
public override void Load()
{
    Stream stateStream = GetSecureStream();

    // Read the state string, using the StateFormatter.
    StreamReader reader = new StreamReader(stateStream);

    IStateFormatter formatter = this.StateFormatter;
    string fileContents = reader.ReadToEnd();

    // Deserilize returns the Pair object that is serialized in
    // the Save method.
    Pair statePair = (Pair)formatter.Deserialize(fileContents);

    ViewState = statePair.First;
    ControlState = statePair.Second;
    reader.Close();
    stateStream.Close();
}

'
' Load ViewState and ControlState.
'
Public Overrides Sub Load()

    Dim stateStream As Stream
    stateStream = GetSecureStream()

    ' Read the state string, using the StateFormatter.
    Dim reader As New StreamReader(stateStream)

    Dim serializedStatePair As String
    serializedStatePair = reader.ReadToEnd
    Dim statePair As Pair

    Dim formatter As IStateFormatter
    formatter = Me.StateFormatter

    ' Deserilize returns the Pair object that is serialized in
    ' the Save method.      
    statePair = CType(formatter.Deserialize(serializedStatePair), Pair)

    ViewState = statePair.First
    ControlState = statePair.Second
    reader.Close()
    stateStream.Close()
End Sub

Commenti

Lo stato del controllo è un oggetto costituito da dati dello stato di visualizzazione critici che i controlli server Web devono funzionare e sono contenuti in un oggetto separato dalle normali informazioni sullo stato di visualizzazione. I dati sullo stato del Page controllo non sono interessati quando lo stato di visualizzazione è disabilitato a livello, ma richiede passaggi di implementazione aggiuntivi da usare. Per altre informazioni sull'uso della ViewState proprietà e dello stato di controllo durante lo sviluppo di controlli, vedere Sviluppo di controlli server personalizzati ASP.NET.