ILSParser Интерфейс

Ссылка

Определение

Пространство имен:: Org.W3c.Dom.LS

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Интерфейс объекта, который может создавать или расширять дерево DOM из различных источников входных данных.

[Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")]
public interface ILSParser : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")>]
type ILSParser = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Атрибуты: RegisterAttribute

Реализации: IJavaObject IJavaPeerable IDisposable

LSParser предоставляет API для синтаксического анализа XML и создания соответствующей структуры документа DOM. Экземпляр LSParser можно получить путем DOMImplementationLS.createLSParser() вызова метода.

Как указано в [уровне DOM 3 Core], когда документ впервые доступен через LSParser: <ul><li> никогда не будет двух смежных узлов типа NODE_TEXT, и никогда не будет пустых текстовых узлов. <>><Ожидается, что value и nodeValue атрибуты Attr узла изначально возвращают нормализованное значение XML 1.0. Однако если параметры "validate-if-schema" и "datatype-normalization" заданы trueв зависимости от используемой нормализации атрибутов, значения атрибутов могут отличаться от значений, полученных нормализацией атрибутов XML 1.0. Если для параметров задано значение "нормализация типов данных", нормализация атрибутов XML 1.0 гарантируется, и если список атрибутов не содержит объявлений пространства имен, атрибут на Element узле представляет свойство [атрибуты], attributes определенное в [XML Information Set].false </li></ul>

Ожидается, что асинхронные объекты также реализуют events::EventTarget интерфейс, чтобы прослушиватели событий могли быть зарегистрированы в асинхронных LSParser объектахLSParser.

События, поддерживаемые асинхронными LSParser объектами: <dl><dt>load</dt dt><dd> Готово LSParser для загрузки документа. См. также определение LSLoadEvent интерфейса. </dd><dt progress</dt>dt><dd>— LSParser сигнализирует о ходе синтаксического анализа данных. Эта спецификация не пытается определить точное время отправки событий хода выполнения. Это намеренно осталось в качестве зависимого от реализации. Ниже приведен один из примеров того, как приложение может отправлять события хода выполнения: когда средство синтаксического анализа начнет получать данные, событие хода выполнения отправляется, чтобы указать, что начинается синтаксический анализ. Оттуда событие хода выполнения отправляется каждые 4096 байт данных, полученных и обработанных. Это только один пример, хотя и реализации могут в любое время отправлять события хода выполнения при синтаксическом анализе или не отправлять их вообще. См. также определение LSProgressEvent интерфейса. </dd></dl>Примечание: Все события, определенные в этой спецификации, используют URI "http://www.w3.org/2002/DOMLS"пространства имен.

При синтаксическом анализе источника входных данных в приложение передаются ошибки с помощью обработчика ошибок (LSParser.domConfigпараметр " обработчик ошибок"). Эта спецификация не пытается определить все возможные ошибки, которые могут возникать при анализе XML или любой другой разметки, но некоторые распространенные случаи ошибок определены. ТипыDOMError.type () ошибок и предупреждений, определенных данной спецификацией: <dl><dt/dt<>"check-character-normalization-failure" [error] dd><Raised>, если параметр "check-character-normalization" имеет значение true, а строка обнаружена, которая завершается ошибкой проверки нормализации. </dd><dt/dt><"doctype-not-allowed" [fatal]<> dd>, если параметр конфигурации "disallow-doctype" имеет true значение и возникает тип документа. </dd dt/dt><"no-input-specified" [fatal]<> dd>>< при загрузке документа, и входные данные не указаны в объекте.LSInput </dd dt/dt>><"pi-base-uri-not-preserved" [warning]< dd>><, если инструкция обработки обнаружена в расположении, где базовый URI инструкции обработки не может быть сохранен. Один из примеров ситуации, когда это предупреждение будет вызвано, если параметр конфигурации " сущности" имеет false значение, а следующий XML-файл анализируется:

&lt;!DOCTYPE root [ &lt;!ENTITY e SYSTEM 'subdir/myentity.ent' ]&gt;
            &lt;root&gt; &amp;e; &lt;/root&gt;

И subdir/myentity.ent содержит:

&lt;one&gt; &lt;two/&gt; &lt;/one&gt; &lt;?pi 3.14159?&gt;
            &lt;more/&gt;

</dd dt/dt><"unbound-prefix-in-entity" [warning]<> dd><> зависимое предупреждение о реализации, которое может быть поднято, если параметр конфигурации "пространства имен" задан true и префикс пространства имен несвязанного пространства имен обнаружен в тексте замены сущности. Повышение этого предупреждения не применяется, так как некоторые существующие средства синтаксического анализа могут не распознавать префиксы пространства имен в замещаемом тексте сущностей. </dd><dt/dt><"unknown-character-denormalization" [fatal]<> dd>, если параметр конфигурации "ignore-unknown-character-denormalizations" имеет false значение, и возникает символ, для которого обработчик не может определить свойства нормализации. </dd dt/dt>><"unsupported-encoding" [fatal]< dd>><, возникает, если обнаружена неподдерживаемая кодировка. </dd><dt/dt><"unsupported-media-type" [fatal]<> dd>, если параметр true конфигурации "поддерживается только для типов мультимедиа", и обнаружен неподдерживаемый тип носителя. </dd></dl>

В дополнение к возникновению определенных ошибок и предупреждений реализация, как ожидается, вызовет конкретные ошибки и предупреждения для любых других случаев ошибок и предупреждений, таких как ошибки ввода-вывода (файл не найден, отклонено разрешение,...), ошибки хорошо сформированности XML и т. д.

См. также спецификацию загрузки и сохранения модели объектов документа (DOM) уровня 3.

Документация по Java для org.w3c.dom.ls.LSParser.

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Поля

ActionAppendAsChildren	Добавьте результат операции синтаксического анализа в качестве дочерних элементов контекстного узла.
ActionInsertAfter	Вставьте результат операции синтаксического анализа сразу же после того, как одноуровневый элемент узла контекста.
ActionInsertBefore	Вставьте результат операции синтаксического анализа в качестве непосредственно предыдущего брата узла контекста.
ActionReplace	Замените узел контекста результатом операции синтаксического анализа.
ActionReplaceChildren	Замените все дочерние элементы узла контекста результатом операции синтаксического анализа.

Свойства

Async	`true` Значение , `LSParserfalse` если оно синхронно.
Busy	`true` Значение , если в `LSParser` данный момент загружен документ, в противном случае `false`.
DomConfig	Объект `DOMConfiguration` , используемый при анализе входного источника.
Filter	При предоставлении фильтра реализация вызовет фильтр, так как он создает структуру дерева DOM.
Handle	Возвращает значение JNI базового объекта Android. (Унаследовано от IJavaObject)
JniIdentityHashCode	Возвращает значение `java.lang.System.identityHashCode()` для упаковаемого экземпляра. (Унаследовано от IJavaPeerable)
JniManagedPeerState	Состояние управляемого однорангового узла. (Унаследовано от IJavaPeerable)
JniPeerMembers	Поддержка доступа к членам и вызовов. (Унаследовано от IJavaPeerable)
PeerReference	JniObjectReference Возвращает экземпляр объекта Java в оболочке. (Унаследовано от IJavaPeerable)

Методы

Abort()	Прервать загрузку документа, загружаемого `LSParser`в данный момент.
Disposed()	Вызывается при удалении экземпляра. (Унаследовано от IJavaPeerable)
DisposeUnlessReferenced()	Если нет невыполненных ссылок на этот экземпляр, то вызывается `Dispose()`; в противном случае ничего не делает. (Унаследовано от IJavaPeerable)
Finalized()	Вызывается при завершении экземпляра. (Унаследовано от IJavaPeerable)
Parse(ILSInput)	Анализ XML-документа из ресурса, определяемого по объекту `LSInput`.
ParseURI(String)	Анализ XML-документа из расположения, определяемого ссылкой URI [IETF RFC 2396].
ParseWithContext(ILSInput, INode, Int16)	Анализ фрагмента XML из ресурса, определяемого ими`LSInput`, и вставка содержимого в существующий документ в позиции, указанной с `context` аргументами.`action`
SetJniIdentityHashCode(Int32)	Задайте значение, возвращаемое `JniIdentityHashCode`. (Унаследовано от IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Интерфейс объекта, который может создавать или расширять дерево DOM из различных источников входных данных. (Унаследовано от IJavaPeerable)
SetPeerReference(JniObjectReference)	Задайте значение, возвращаемое `PeerReference`. (Унаследовано от IJavaPeerable)
UnregisterFromRuntime()	Отмените регистрацию этого экземпляра, чтобы среда выполнения не возвращала ее из будущих Java.Interop.JniRuntime+JniValueManager.PeekValue вызовов. (Унаследовано от IJavaPeerable)

Методы расширения

JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Интерфейс объекта, который может создавать или расширять дерево DOM из различных источников входных данных.
GetJniTypeName(IJavaPeerable)	Интерфейс объекта, который может создавать или расширять дерево DOM из различных источников входных данных.
ParseAsync(ILSParser, ILSInput)	Интерфейс объекта, который может создавать или расширять дерево DOM из различных источников входных данных.
ParseURIAsync(ILSParser, String)	Интерфейс объекта, который может создавать или расширять дерево DOM из различных источников входных данных.
ParseWithContextAsync(ILSParser, ILSInput, INode, Int16)	Интерфейс объекта, который может создавать или расширять дерево DOM из различных источников входных данных.

Применяется к

Поделиться через