NetDataContractSerializer.ReadObject 方法

定義

命名空間:

System.Runtime.Serialization

組件:

System.Runtime.Serialization.dll

讀取 XML 資料流或文件，然後傳回已還原序列化的物件。

多載

ReadObject(XmlReader)	使用 XmlDictionaryReader 讀取 XML 資料流或文件，然後傳回已還原序列化的物件。
ReadObject(XmlDictionaryReader, Boolean)	使用 XmlDictionaryReader 讀取 XML 資料流或文件，然後傳回已還原序列化的物件；同時檢查該物件資料是否符合用於建立序列化程式的名稱和命名空間。
ReadObject(XmlReader, Boolean)	使用 XmlDictionaryReader 讀取 XML 資料流或文件，然後傳回已還原序列化的物件；同時檢查該物件資料是否符合用於建立序列化程式的名稱和命名空間。

備註

重要

使用不信任的資料呼叫此方法，會造成安全性上的風險。 呼叫此方法時，請一律使用信任的資料。 如需詳細資訊，請參閱 驗證所有輸入。

ReadObject(XmlReader)

使用 XmlDictionaryReader 讀取 XML 資料流或文件，然後傳回已還原序列化的物件。

public:
 override System::Object ^ ReadObject(System::Xml::XmlReader ^ reader);

public override object ReadObject (System.Xml.XmlReader reader);

override this.ReadObject : System.Xml.XmlReader -> obj

Public Overrides Function ReadObject (reader As XmlReader) As Object

參數

reader

XmlReader

XmlReader，用於讀取 XML 資料流或文件。

傳回

Object

已還原序列化的物件。

例外狀況

ArgumentNullException

reader 設定為 null。

備註

重要

使用不信任的資料呼叫此方法，會造成安全性上的風險。 呼叫此方法時，請一律使用信任的資料。 如需詳細資訊，請參閱 驗證所有輸入。

ReadObject(XmlDictionaryReader, Boolean)

使用 XmlDictionaryReader 讀取 XML 資料流或文件，然後傳回已還原序列化的物件；同時檢查該物件資料是否符合用於建立序列化程式的名稱和命名空間。

public:
 override System::Object ^ ReadObject(System::Xml::XmlDictionaryReader ^ reader, bool verifyObjectName);

public override object ReadObject (System.Xml.XmlDictionaryReader reader, bool verifyObjectName);

override this.ReadObject : System.Xml.XmlDictionaryReader * bool -> obj

Public Overrides Function ReadObject (reader As XmlDictionaryReader, verifyObjectName As Boolean) As Object

參數

reader

XmlDictionaryReader

XmlDictionaryReader，用於讀取 XML 資料流或文件。

verifyObjectName

Boolean

如果要檢查內含的 XML 項目名稱和命名空間是否對應至用於建構序列化程式的根名稱和根命名空間，則為 true，如果要略過驗證，則為 false。

傳回

Object

已還原序列化的物件。

例外狀況

ArgumentNullException

reader 設定為 null。

備註

verifyObjectName 參數會檢查讀取器所在之 XML 項目的名稱和命名空間，並比較值與預期的名稱和命名空間，以判斷它是否可以讀取物件。 預期的名稱和命名空間可以使用下列項目進行設定：傳入建構函式之型別的資料合約名稱和命名空間，或是傳入建構函式的 rootName 和 rootNamespace 值 (如果有的話)。

您可以在下列建構函式中設定 rootName 和 rootNamespace：NetDataContractSerializer(String, String)、NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString) 和 NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)。

重要

使用不信任的資料呼叫此方法，會造成安全性上的風險。 呼叫此方法時，請一律使用信任的資料。 如需詳細資訊，請參閱 驗證所有輸入。

ReadObject(XmlReader, Boolean)

使用 XmlDictionaryReader 讀取 XML 資料流或文件，然後傳回已還原序列化的物件；同時檢查該物件資料是否符合用於建立序列化程式的名稱和命名空間。

public:
 override System::Object ^ ReadObject(System::Xml::XmlReader ^ reader, bool verifyObjectName);

public override object ReadObject (System.Xml.XmlReader reader, bool verifyObjectName);

override this.ReadObject : System.Xml.XmlReader * bool -> obj

Public Overrides Function ReadObject (reader As XmlReader, verifyObjectName As Boolean) As Object

參數

reader

XmlReader

XmlReader，用於讀取 XML 資料流或文件。

verifyObjectName

Boolean

如果要檢查內含的 XML 項目名稱和命名空間是否對應至用於建構序列化程式的根名稱和根命名空間，則為 true，如果要略過驗證，則為 false。

傳回

Object

已還原序列化的物件。

例外狀況

ArgumentNullException

reader 設定為 null。

備註

verifyObjectName 參數會檢查讀取器所在之 XML 項目的名稱和命名空間，並比較值與預期的名稱和命名空間，以判斷它是否可以讀取物件。 預期的名稱和命名空間可以使用下列項目進行設定：傳入建構函式之型別的資料合約名稱和命名空間，或是傳入建構函式的 rootName 和 rootNamespace 值 (如果有的話)。

您可以在下列建構函式中設定 rootName 和 rootNamespace：NetDataContractSerializer(String, String)、NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString) 和 NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)。

重要

使用不信任的資料呼叫此方法，會造成安全性上的風險。 呼叫此方法時，請一律使用信任的資料。 如需詳細資訊，請參閱 驗證所有輸入。