XmlObjectSerializer.IsStartObject Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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)
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 -> boolPublic MustOverride Function IsStartObject (reader As XmlDictionaryReader) As BooleanParameter
- 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)
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 -> boolPublic Overridable Function IsStartObject (reader As XmlReader) As BooleanParameter
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.