XmlObjectSerializer.IsStartObject 方法

定義

命名空間:

System.Runtime.Serialization

組件:

System.Runtime.Serialization.Xml.dll

取得值，這個值會指定序列化程式是否能夠讀取該物件。

多載

IsStartObject(XmlDictionaryReader)	取得值，這個值會指定 XmlDictionaryReader 是否位於能夠讀取的 XML 項目上。
IsStartObject(XmlReader)	取得值，這個值會指定 XmlReader 是否位於能夠讀取的 XML 項目上。

備註

這個方法會檢查讀取器是否位於要讀取的項目上，並在此項目為 XML 資料流或文件中所找到物件的最上層項目時，傳回 true。 為了傳回 true，此時找到的項目必須具有預期的名稱。 實際的預期項目名稱需視序列化程式實作而定。

透過 DataContractSerializer，此起始項目就可指定於延伸類別的建構函式中。 如需範例，請參閱 DataContractSerializer 類別的建構函式。

IsStartObject(XmlDictionaryReader)

來源:

XmlObjectSerializer.cs

取得值，這個值會指定 XmlDictionaryReader 是否位於能夠讀取的 XML 項目上。

public:
 abstract bool IsStartObject(System::Xml::XmlDictionaryReader ^ reader);

public abstract bool IsStartObject (System.Xml.XmlDictionaryReader reader);

abstract member IsStartObject : System.Xml.XmlDictionaryReader -> bool

Public MustOverride Function IsStartObject (reader As XmlDictionaryReader) As Boolean

參數

reader

XmlDictionaryReader

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

傳回

Boolean

如果讀取器可以讀取資料，則為 true，否則為 false。

備註

這個方法會檢查讀取器是否位於要讀取的項目上，並在此項目為 XML 資料流或文件中所找到物件的最上層項目時，傳回 true。 XmlObjectSerializer 實作會判定何時傳回 true。 實作會檢查自己是否位於項目上，或是尋找預期的項目名稱。 其中一個 XmlObjectSerializer 的實作，即 DataContractSerializer，它會檢查自己是否位於項目上，也會檢查項目名稱是否為目前正在還原序列化之型別的最上層預期名稱。

如果有需要，在使用 ReadObject 方法讀取 XML 內容之前，可以讀取 XML 資料流中的其他屬性，並同時將其放置到最上層項目上。

IsStartObject(XmlReader)

來源:

XmlObjectSerializer.cs

取得值，這個值會指定 XmlReader 是否位於能夠讀取的 XML 項目上。

public:
 virtual bool IsStartObject(System::Xml::XmlReader ^ reader);

public virtual bool IsStartObject (System.Xml.XmlReader reader);

abstract member IsStartObject : System.Xml.XmlReader -> bool
override this.IsStartObject : System.Xml.XmlReader -> bool

Public Overridable Function IsStartObject (reader As XmlReader) As Boolean

參數

reader

XmlReader

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

傳回

Boolean

如果讀取器位於起始項目上，則為 true，否則為 false。

備註

這個方法會檢查讀取器是否位於要讀取的項目上，並在此項目為 XML 資料流或文件中所找到物件的最上層項目時，傳回 true。 為了傳回 true，此時找到的項目必須具有預期的名稱。 實際的預期項目名稱需視序列化程式實作而定。

透過 DataContractSerializer，此起始項目就可指定於延伸類別的建構函式中。 如需範例，請參閱 DataContractSerializer 類別的建構函式。