PageStatePersister.ControlState Propriedade

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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

Object

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.