语言

ObjectStateFormatter.Deserialize 方法

定义

从序列化形式反序列化对象状态图。

重载

名称 说明
Deserialize(Stream)

从包含在指定 Stream 对象中的二进制序列化形式反序列化对象状态图。

Deserialize(String)

从其序列化的 base64 编码字符串形式反序列化对象状态图。

注解

Important

使用不受信任的数据调用此方法是一种安全风险。 仅使用受信任的数据调用此方法。 有关详细信息,请参阅验证所有输入。

Deserialize(Stream)

从包含在指定 Stream 对象中的二进制序列化形式反序列化对象状态图。

public:
 System::Object ^ Deserialize(System::IO::Stream ^ inputStream);
public object Deserialize(System.IO.Stream inputStream);
member this.Deserialize : System.IO.Stream -> obj
Public Function Deserialize (inputStream As Stream) As Object

参数

inputStream
Stream

Stream反序列化为已ObjectStateFormatter初始化的 。object

返回

一个表示反序列化的对象状态图的对象。

例外

指定的 inputStream 是 null。

反序列化 Stream期间发生异常。 异常消息将追加到该消息的消息中 ArgumentException。

示例

下面的代码示例演示如何从 PageStatePersister 类派生的类初始化 ViewState 集合。 在此示例中,集合 ViewState 已分配给 First 对象的字段 Pair ,并使用类序列化为文件 ObjectStateFormatter 。 Load调用该方法时,Deserialize(Stream)该方法用于反序列化文件中的视图状态,并ViewState初始化该属性。 该代码示例是 PageStatePersister 类中的一个较大示例的一部分。

//
// 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

注解

可以使用该方法反序列化Serialize的任何对象状态图Deserialize。 该方法 Deserialize(Stream) 用于还原存储在对象 Stream状态图中的对象状态图,例如 FileStream。

Important

使用不受信任的数据调用此方法是一种安全风险。 仅使用受信任的数据调用此方法。 有关详细信息,请参阅验证所有输入。

适用于

Deserialize(String)

从其序列化的 base64 编码字符串形式反序列化对象状态图。

public:
 System::Object ^ Deserialize(System::String ^ inputString);
public object Deserialize(string inputString);
member this.Deserialize : string -> obj
Public Function Deserialize (inputString As String) As Object

参数

inputString
String

反序列化为初始化对象的字符串 ObjectStateFormatter 。

返回

一个表示反序列化的对象状态图的对象。

例外

指定的 inputString 值为 null 或具有 Length 0。

序列化的数据无效。

反序列化视图状态失败时执行的计算机身份验证代码 (MAC) 验证检查。

示例

下面的代码示例演示如何实现一个方法,该方法反序列化 base64 编码的字符串并返回 ICollection 属性设置的集合。 此代码示例依赖于已使用 ObjectStateFormatter 类序列化的属性设置,如方法所示 Serialize(Object) 。

private ICollection LoadControlProperties (string serializedProperties) {

    ICollection controlProperties = null;

    // Create an ObjectStateFormatter to deserialize the properties.
    ObjectStateFormatter formatter = new ObjectStateFormatter();

    // Call the Deserialize method.
    controlProperties = (ArrayList) formatter.Deserialize(serializedProperties);

    return controlProperties;
}
Private Function LoadControlProperties(serializedProperties As String) As ICollection
   
   Dim controlProperties As ICollection = Nothing
   
   ' Create an ObjectStateFormatter to deserialize the properties.
   Dim formatter As New ObjectStateFormatter()
   
   ' Call the Deserialize method.
   controlProperties = CType(formatter.Deserialize(serializedProperties), ArrayList)
   
   Return controlProperties
End Function 'LoadControlProperties

注解

可以使用该方法反序列化Serialize的任何对象状态图Deserialize。 该方法 Deserialize(String) 用于还原以 base64 编码的字符串形式存储的对象状态图。

Important

使用不受信任的数据调用此方法是一种安全风险。 仅使用受信任的数据调用此方法。 有关详细信息,请参阅验证所有输入。

适用于