XmlObjectSerializer.IsStartObject メソッド

  • リファレンス

定義

名前空間:
System.Runtime.Serialization
アセンブリ:
System.Runtime.Serialization.Xml.dll
アセンブリ:
System.Runtime.Serialization.dll
アセンブリ:
netstandard.dll

シリアライザーがオブジェクトを読み取れるかどうかを指定する値を取得します。

オーバーロード

IsStartObject(XmlDictionaryReader)

読み取り可能な XML 要素に XmlDictionaryReader が配置されているかどうかを指定する値を取得します。
IsStartObject(XmlReader)

読み取り可能な XML 要素に XmlReader が配置されているかどうかを指定する値を取得します。

注釈

このメソッドは、読み取る要素にリーダーが配置されているかどうかをチェックし、その要素が XML ストリームまたはドキュメントで検出されたオブジェクトのトップレベルの要素である場合は true を返します。 true を返すには、検出された要素の名前が、予期された名前と一致している必要があります。 実際の予期された要素名は、シリアライザーの実装によって異なります。

DataContractSerializer によって、開始要素が拡張クラスのコンストラクター内に指定されます。 例については、DataContractSerializer クラスのコンストラクターを参照してください。

IsStartObject(XmlDictionaryReader)

読み取り可能な XML 要素に XmlDictionaryReader が配置されているかどうかを指定する値を取得します。

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

XML ストリームまたはドキュメントを読み取るために使用する XmlDictionaryReader。

戻り値

Boolean

リーダーがデータを読み取ることができる場合は true。それ以外の場合は false。

注釈

このメソッドは、読み取る要素にリーダーが配置されているかどうかをチェックし、その要素が XML ストリームまたはドキュメントで検出されたオブジェクトのトップレベルの要素である場合は true を返します。 XmlObjectSerializer を返すタイミングは、true の実装が決定します。 実装では、実装が要素に配置されていることを確認するか、予期された要素名を検索できます。 XmlObjectSerializer の 1 つの実装である DataContractSerializer では、それが要素に配置されていることを確認すると共に、要素名が現在の逆シリアル化の対象である型のトップレベルの予期される名前であることを確認します。

必要であれば、ReadObject メソッドを使用して XML コンテンツを読み取る前に、トップレベルの要素に配置する一方で、XML ストリーム内の追加属性を読み取ることができます。

適用対象

IsStartObject(XmlReader)

読み取り可能な XML 要素に XmlReader が配置されているかどうかを指定する値を取得します。

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

XML ストリームまたはドキュメントを読み取るために使用する XmlReader。

戻り値

Boolean

リーダーの位置が開始要素である場合は true。それ以外の場合は false。

注釈

このメソッドは、読み取る要素にリーダーが配置されているかどうかをチェックし、その要素が XML ストリームまたはドキュメントで検出されたオブジェクトのトップレベルの要素である場合は true を返します。 true を返すには、検出された要素の名前が、予期された名前と一致している必要があります。 実際の予期された要素名は、シリアライザーの実装によって異なります。

DataContractSerializer によって、開始要素が拡張クラスのコンストラクター内に指定されます。 例については、DataContractSerializer クラスのコンストラクターを参照してください。

適用対象