Freigeben über


XmlObjectSerializer.IsStartObject Methode

Definition

Ruft einen Wert ab, der angibt, ob das Serialisierungsprogramm das Objekt lesen kann.

Überlädt

IsStartObject(XmlDictionaryReader)

Ruft einen Wert ab, der angibt, ob der XmlDictionaryReader auf ein XML-Element positioniert ist, das gelesen werden kann.

IsStartObject(XmlReader)

Ruft einen Wert ab, der angibt, ob der XmlReader auf ein XML-Element positioniert ist, das gelesen werden kann.

Hinweise

Diese Methode prüft, ob der Leser auf ein zu lesendes Element ausgerichtet ist, und gibt true zurück, wenn das Element für das im XML-Stream oder im XML-Dokument gefundene Objekt das Element der höchsten Ebene ist. Um truezurückgeben zu können, muss das gefundene Element über einen erwarteten Namen verfügen. Der tatsächlich erwartete Elementname hängt von der Implementierung des Serialisierungsprogramms ab.

Mit dem DataContractSerializer wird das Startelement im Konstruktor der Erweiterungsklasse angegeben. Ein Beispiel finden Sie unter den Konstruktoren für die DataContractSerializer-Klasse.

IsStartObject(XmlDictionaryReader)

Quelle:
XmlObjectSerializer.cs
Quelle:
XmlObjectSerializer.cs
Quelle:
XmlObjectSerializer.cs

Ruft einen Wert ab, der angibt, ob der XmlDictionaryReader auf ein XML-Element positioniert ist, das gelesen werden kann.

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

Parameter

reader
XmlDictionaryReader

Ein XmlDictionaryReader zum Lesen des XML-Streams oder XML-Dokuments.

Gibt zurück

true, wenn der Reader die Daten lesen kann, andernfalls false.

Hinweise

Diese Methode prüft, ob der Leser auf ein zu lesendes Element positioniert ist, und gibt true zurück, wenn das Element für das im XML-Stream oder im XML-Dokument gefundene Objekt das Element der höchsten Ebene ist. Die XmlObjectSerializer-Implementierung bestimmt, wann true zurückgegeben wird. Die Implementierungen überprüfen möglicherweise, ob sie auf einem Element positioniert sind oder nach einem erwarteten Elementnamen suchen. Eine Implementierung des XmlObjectSerializer, der DataContractSerializer, überprüft, ob er auf einem Element positioniert ist und ob der Elementname der erwartete Name der höchsten Ebene eines Typs ist, der gerade deserialisiert wird.

Bei Bedarf können während der Positionierung auf das Element der höchsten Ebene vor dem Lesen von XML-Inhalten unter Verwendung der ReadObject-Methode weitere Attribute im XML-Stream gelesen werden.

Gilt für:

IsStartObject(XmlReader)

Quelle:
XmlObjectSerializer.cs
Quelle:
XmlObjectSerializer.cs
Quelle:
XmlObjectSerializer.cs

Ruft einen Wert ab, der angibt, ob der XmlReader auf ein XML-Element positioniert ist, das gelesen werden kann.

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

Parameter

reader
XmlReader

Ein XmlReader zum Lesen des XML-Streams oder XML-Dokuments.

Gibt zurück

true, wenn der Reader auf dem Ende des Startelements positioniert ist, andernfalls false.

Hinweise

Diese Methode prüft, ob der Leser auf ein zu lesendes Element ausgerichtet ist, und gibt true zurück, wenn das Element für das im XML-Stream oder im XML-Dokument gefundene Objekt das Element der höchsten Ebene ist. Um truezurückgeben zu können, muss das gefundene Element über einen erwarteten Namen verfügen. Der tatsächlich erwartete Elementname hängt von der Implementierung des Serialisierungsprogramms ab.

Mit dem DataContractSerializer wird das Startelement im Konstruktor der Erweiterungsklasse angegeben. Ein Beispiel finden Sie unter den Konstruktoren für die DataContractSerializer-Klasse.

Gilt für: