XmlObjectSerializer.IsStartObject Méthode

Définition

Espace de noms:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.Xml.dll

Obtient une valeur qui spécifie si le sérialiseur peut lire l'objet.

Surcharges

IsStartObject(XmlDictionaryReader)	Obtient une valeur qui spécifie si le XmlDictionaryReader est positionné sur un élément XML qui peut être lu.
IsStartObject(XmlReader)	Obtient une valeur qui spécifie si le XmlReader est positionné sur un élément XML qui peut être lu.

Remarques

Cette méthode vérifie si le lecteur est positionné sur un élément à lire, et retourne la valeur true si l'élément est celui de niveau supérieur pour l'objet trouvé dans le document ou le flux XML. Pour retourner la valeur true, l'élément trouvé doit posséder un nom attendu. Le nom d'élément attendu réel dépend de l'implémentation du sérialiseur.

Avec le DataContractSerializer, l'élément de début est spécifié dans le constructeur de la classe d'extensions. Pour obtenir un exemple, consultez les constructeurs pour la classe DataContractSerializer.

IsStartObject(XmlDictionaryReader)

Source:

XmlObjectSerializer.cs

Obtient une valeur qui spécifie si le XmlDictionaryReader est positionné sur un élément XML qui peut être lu.

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

Paramètres

reader

XmlDictionaryReader

XmlDictionaryReader utilisé pour lire le document ou le flux XML.

Retours

Boolean

true si le lecteur peut lire les données ; sinon, false.

Remarques

Cette méthode vérifie si le lecteur est positionné sur un élément à lire et retourne la valeur true si l'élément est l'élément de niveau supérieur pour l'objet trouvé dans le document ou le flux XML. L'implémentation de XmlObjectSerializer détermine quand retourner la valeur true. Les implémentations peuvent vérifier qu'ils sont positionnés sur un élément ou rechercher un nom d'élément attendu. Une implémentation de XmlObjectSerializer, le DataContractSerializer, vérifie qu'il est positionné sur un élément et que le nom d'élément est le nom de niveau supérieur attendu pour le type en cours de désérialisation.

Si nécessaire, les attributs supplémentaires du flux XML peuvent être lus pendant qu'il est positionné sur l'élément de niveau supérieur, avant de lire le contenu XML à l'aide de la méthode ReadObject.

IsStartObject(XmlReader)

Source:

XmlObjectSerializer.cs

Obtient une valeur qui spécifie si le XmlReader est positionné sur un élément XML qui peut être lu.

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

Paramètres

reader

XmlReader

XmlReader utilisé pour lire le document ou le flux XML.

Retours

Boolean

true si le lecteur est placé sur l'élément de début ; sinon, false.

Remarques

Cette méthode vérifie si le lecteur est positionné sur un élément à lire, et retourne la valeur true si l'élément est celui de niveau supérieur pour l'objet trouvé dans le document ou le flux XML. Pour retourner la valeur true, l'élément trouvé doit posséder un nom attendu. Le nom d'élément attendu réel dépend de l'implémentation du sérialiseur.

Avec le DataContractSerializer, l'élément de début est spécifié dans le constructeur de la classe d'extensions. Pour obtenir un exemple, consultez les constructeurs pour la classe DataContractSerializer.