Freigeben über


ValidatorHandler.SetDocumentLocator(ILocator) Methode

Definition

Empfangen eines Objekts zum Ermitteln des Ursprungs von SAX-Dokumentereignissen.

[Android.Runtime.Register("setDocumentLocator", "(Lorg/xml/sax/Locator;)V", "GetSetDocumentLocator_Lorg_xml_sax_Locator_Handler")]
public abstract void SetDocumentLocator (Org.Xml.Sax.ILocator? locator);
[<Android.Runtime.Register("setDocumentLocator", "(Lorg/xml/sax/Locator;)V", "GetSetDocumentLocator_Lorg_xml_sax_Locator_Handler")>]
abstract member SetDocumentLocator : Org.Xml.Sax.ILocator -> unit

Parameter

locator
ILocator

ein Objekt, das den Speicherort eines SAX-Dokumentereignisses zurückgeben kann

Implementiert

Attribute

Hinweise

Empfangen eines Objekts zum Ermitteln des Ursprungs von SAX-Dokumentereignissen.

SAX-Parser werden dringend empfohlen (aber nicht unbedingt erforderlich), um einen Locator anzugeben: Wenn dies der Fall ist, muss er den Locator an die Anwendung übermitteln, indem er diese Methode aufruft, bevor eine der anderen Methoden in der ContentHandler-Schnittstelle aufgerufen wird.

Der Locator ermöglicht der Anwendung, die Endposition eines dokumentbezogenen Ereignisses zu bestimmen, auch wenn der Parser keinen Fehler meldet. In der Regel verwendet die Anwendung diese Informationen, um eigene Fehler zu melden (z. B. Zeicheninhalte, die nicht den Geschäftsregeln einer Anwendung entsprechen). Die vom Locator zurückgegebenen Informationen reichen wahrscheinlich nicht für die Verwendung mit einer Suchmaschine aus.

Beachten Sie, dass der Locator korrekte Informationen nur während des Aufrufs von SAX-Ereignisrückrufen nach #startDocument startDocument rückgabe und vor #endDocument endDocument dem Aufruf zurückgibt. Die Anwendung sollte nicht versuchen, sie zu einem anderen Zeitpunkt zu verwenden.

Java-Dokumentation für org.xml.sax.ContentHandler.setDocumentLocator(org.xml.sax.Locator).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: