Partilhar via


PageStatePersister.ControlState Propriedade

Definição

Obtém ou define um objeto que representa os dados que controla, contidos pelo objeto Page atual que usa para persistir em solicitações HTTP ao servidor 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

Valor da propriedade

Um objeto que contém dados de estado da exibição.

Exemplos

O exemplo de código a seguir demonstra como uma classe derivada da PageStatePersister classe inicializa a ControlState propriedade . Neste exemplo, a ControlState propriedade foi atribuída ao Second campo de um Pair objeto e serializada usando a ObjectStateFormatter classe . Quando o Load método é chamado, a ObjectStateFormatter classe é usada para desserializar o estado da exibição e controlar informações de estado e a ControlState propriedade é inicializada do campo do Second objeto resultantePair. Este exemplo de código faz parte de um exemplo maior fornecido para a 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

Comentários

O estado de controle é um objeto composto por dados de estado de exibição críticos que os controles do servidor Web precisam funcionar e está contido em um objeto separado das informações de estado de exibição normal. Os dados de estado de controle não são afetados quando o estado de exibição está desabilitado no Page nível, mas requer etapas de implementação adicionais a serem usadas. Para obter mais informações sobre como usar a propriedade e o ViewState estado de controle ao desenvolver controles, consulte Desenvolvendo controles de servidor de ASP.NET personalizados.

Aplica-se a