PageStatePersister.ControlState Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define um objeto que representa os dados que controlam contidos pelo objeto atual Page para persistir através dos pedidos HTTP para o 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 de Propriedade
Um objeto que contém dados de estado de visualização.
Exemplos
O exemplo de código seguinte demonstra como uma classe que deriva 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 informações do estado da vista e do estado de controlo, e a ControlState propriedade é inicializada a partir do campo do Pair objeto resultanteSecond. 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
Observações
O estado de controlo é um objeto composto por dados críticos do estado da vista que os controlos do servidor Web precisam para funcionar, e está contido num objeto separado da informação normal do estado da vista. Os dados do estado de controlo não são afetados quando o estado de visualização está desativado ao Page nível, mas requerem passos adicionais de implementação para serem utilizados. Para mais informações sobre a utilização do estado de propriedade e controlo ViewState ao desenvolver controlos, consulte Developing Custom ASP.NET Server Controls.