ILSParser.ParseWithContext(ILSInput, INode, Int16) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Анализ фрагмента XML из ресурса, определяемого имиLSInput
, и вставка содержимого в существующий документ в позиции, указанной с context
аргументами.action
[Android.Runtime.Register("parseWithContext", "(Lorg/w3c/dom/ls/LSInput;Lorg/w3c/dom/Node;S)Lorg/w3c/dom/Node;", "GetParseWithContext_Lorg_w3c_dom_ls_LSInput_Lorg_w3c_dom_Node_SHandler:Org.W3c.Dom.LS.ILSParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.W3c.Dom.INode? ParseWithContext (Org.W3c.Dom.LS.ILSInput? input, Org.W3c.Dom.INode? contextArg, short action);
[<Android.Runtime.Register("parseWithContext", "(Lorg/w3c/dom/ls/LSInput;Lorg/w3c/dom/Node;S)Lorg/w3c/dom/Node;", "GetParseWithContext_Lorg_w3c_dom_ls_LSInput_Lorg_w3c_dom_Node_SHandler:Org.W3c.Dom.LS.ILSParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ParseWithContext : Org.W3c.Dom.LS.ILSInput * Org.W3c.Dom.INode * int16 -> Org.W3c.Dom.INode
Параметры
- input
- ILSInput
Источник LSInput
документа, из которого должен быть прочитан. Исходный документ должен быть фрагментом XML, т. е. что-либо, кроме полного XML-документа (за исключением случаев, когда контекстный узел типа DOCUMENT_NODE
, и действие ), ACTION_REPLACE_CHILDREN
DOCTYPE (внутреннее подмножество), объявления сущностей, объявления сущностей, объявления нотации или XML или текстовые объявления.
- contextArg
- INode
Узел, используемый в качестве контекста для анализируемых данных. Этот узел должен быть Document
узлом, DocumentFragment
узлом или узлом типа, который разрешен как дочерний Element
узел узла, например, не может быть Attribute
узлом.
- action
- Int16
Этот параметр описывает, какое действие следует предпринять между новым набором вставляемых узлов и существующими дочерними элементами узла контекста. Набор возможных действий определен выше ACTION_TYPES
.
Возвращаемое значение
Возвращает узел, который является результатом операции синтаксического анализа. Если результат равен нескольким узлам верхнего уровня, возвращается первый.
- Атрибуты
Исключения
HIERARCHY_REQUEST_ERR: вызывается, если содержимое не может замениться, вставляться до, после или в качестве дочернего узла контекста (см. также Node.insertBefore
или Node.replaceChild
[] ).
NOT_SUPPORTED_ERR. Вызывается, если LSParser
этот метод не поддерживается, или если узел контекста имеет типDocument
, а реализация DOM не поддерживает замену дочернего или Element
дочернегоDocumentType
.
NO_MODIFICATION_ALLOWED_ERR. Вызывается, если узел контекста является только узлом чтения, а содержимое добавляется в его дочерний список или если родительский узел узла контекста считывается только узел, а содержимое вставляется в его дочерний список.
INVALID_STATE_ERR. Вызывается при наличии true
атрибутаLSParser.busy
.
PARSE_ERR. Вызывается, если LSParser
не удалось загрузить фрагмент XML. Приложения DOM должны присоединить параметр DOMErrorHandler
с помощью параметра "", если они хотят получить сведения об ошибке.
Комментарии
Анализ фрагмента XML из ресурса, определяемого имиLSInput
, и вставка содержимого в существующий документ в позиции, указанной с context
аргументами.action
При синтаксическом анализе входного потока узел контекста (или родительский узел в зависимости от того, где будет вставлен результат) используется для разрешения префиксов пространства имен без подключения. Узел контекста ownerDocument
(или сам узел, если узел типа DOCUMENT_NODE
) используется для разрешения атрибутов и ссылок на сущности по умолчанию. <br> По мере вставки новых данных в документ по крайней мере одно событие мутации запускается на новый непосредственный дочерний или одноуровневый элемент узла контекста. <Br> Если узел контекста является Document
узлом и действием ACTION_REPLACE_CHILDREN
является, то документ, передаваемый в качестве узла контекста, будет изменен таким образом, чтобы его xmlEncoding
, , documentURI
, xmlVersion
inputEncoding
и xmlStandalone
все другие такие атрибуты были заданы в том, что они будут заданы, если источник входных данных был проанализирован с помощьюLSParser.parse()
. <br> Этот метод всегда синхронен, даже если LSParser
используется асинхронный (LSParser.async
имеет значение true
). <Br> Если при синтаксическом анализе возникает ошибка, вызывающий объект уведомляется через ErrorHandler
экземпляр, связанный с параметром " error-handler" объекта DOMConfiguration
. <Br> При вызове parseWithContext
значения следующих параметров конфигурации будут игнорироваться, а значения по умолчанию всегда будут использоваться вместо этого: "validate", "validate-if-schema" и "element-content-whitespace". Другие параметры будут обрабатываться обычно, и синтаксический анализ, как ожидается, вызывается LSParserFilter
так же, как если бы весь документ был проанализирован.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.