Partilhar via


XPathNavigator Classe

Definição

Fornece um modelo de cursor para navegar e editar dados XML.

public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, ICloneable, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable
public ref class XPathNavigator abstract : System::Xml::XPath::XPathItem, System::Xml::IXmlNamespaceResolver, System::Xml::XPath::IXPathNavigable
public ref class XPathNavigator abstract : ICloneable
public abstract class XPathNavigator : System.Xml.XPath.XPathItem, ICloneable, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable
public abstract class XPathNavigator : System.Xml.XPath.XPathItem, System.Xml.IXmlNamespaceResolver, System.Xml.XPath.IXPathNavigable
public abstract class XPathNavigator : ICloneable
type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXmlNamespaceResolver
    interface IXPathNavigable
type XPathNavigator = class
    inherit XPathItem
    interface IXmlNamespaceResolver
    interface IXPathNavigable
type XPathNavigator = class
    interface ICloneable
type XPathNavigator = class
    inherit XPathItem
    interface ICloneable
    interface IXPathNavigable
    interface IXmlNamespaceResolver
Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements ICloneable, IXmlNamespaceResolver, IXPathNavigable
Public MustInherit Class XPathNavigator
Inherits XPathItem
Implements IXmlNamespaceResolver, IXPathNavigable
Public MustInherit Class XPathNavigator
Implements ICloneable
Herança
XPathNavigator
Herança
XPathNavigator
Derivado
Implementações

Comentários

A XPathNavigator classe no System.Xml.XPath namespace é uma classe abstrata que define um modelo de cursor para navegar e editar itens de informações XML como instâncias do modelo de dados XQuery 1.0 e XPath 2.0.

Um XPathNavigator objeto é criado a partir de uma classe que implementa a IXPathNavigable interface, como as classes e XmlDocument as XPathDocument classes. XPathNavigator os objetos criados por XPathDocument objetos são somente leitura, enquanto XPathNavigator os objetos criados por XmlDocument objetos podem ser editados. O status somente leitura ou editável de um XPathNavigator objeto é determinado usando a CanEdit propriedade da XPathNavigator classe.

Para obter mais informações sobre como processar dados XML usando o modelo de dados XPath, consulte os dados XML do processo usando o tópico XPath Data Model .

Importante

Exceções geradas como resultado do uso da XPathNavigator classe, como a XPathException classe, podem conter informações confidenciais que não devem ser expostas em cenários não confiáveis. As exceções devem ser tratadas corretamente para que essas informações confidenciais não sejam expostas em cenários não confiáveis.

Notas aos Implementadores

Ao herdar da XPathNavigator classe, você deve substituir os seguintes membros:

Construtores

Nome Description
XPathNavigator()

Inicializa uma nova instância da classe XPathNavigator.

Propriedades

Nome Description
BaseURI

Quando substituído em uma classe derivada, obtém o URI base do nó atual.

CanEdit

Obtém um valor que indica se os XPathNavigator dados XML subjacentes podem ser editados.

HasAttributes

Obtém um valor que indica se o nó atual tem atributos.

HasChildren

Obtém um valor que indica se o nó atual tem nós filho.

InnerXml

Obtém ou define a marcação que representa os nós filho do nó atual.

IsEmptyElement

Quando substituído em uma classe derivada, obtém um valor que indica se o nó atual é um elemento vazio sem uma marca de elemento final.

IsNode

Obtém um valor que indica se o nó atual representa um nó XPath.

LocalName

Quando substituído em uma classe derivada, obtém o Name nó atual sem nenhum prefixo de namespace.

Name

Quando substituído em uma classe derivada, obtém o nome qualificado do nó atual.

NamespaceURI

Quando substituído em uma classe derivada, obtém o URI do namespace do nó atual.

NameTable

Quando substituído em uma classe derivada, obtém o XmlNameTableXPathNavigator.

NavigatorComparer

Obtém um IEqualityComparer usado para comparação de igualdade de XPathNavigator objetos.

NodeType

Quando substituído em uma classe derivada, obtém o XPathNodeType nó atual.

OuterXml

Obtém ou define a marcação que representa as marcas de abertura e fechamento do nó atual e seus nós filho.

Prefix

Quando substituído em uma classe derivada, obtém o prefixo de namespace associado ao nó atual.

SchemaInfo

Obtém as informações de esquema atribuídas ao nó atual como resultado da validação do esquema.

TypedValue

Obtém o nó atual como um objeto em caixa do tipo .NET mais apropriado.

UnderlyingObject

Usado por XPathNavigator implementações que fornecem uma exibição XML "virtualizada" em um repositório, para fornecer acesso a objetos subjacentes.

Value

Quando substituído em uma classe derivada, obtém o valor da cadeia de caracteres do item.

Value

Quando substituído em uma classe derivada, obtém o string valor do item.

(Herdado de XPathItem)
ValueAsBoolean

Obtém o valor do nó atual como um Boolean.

ValueAsDateTime

Obtém o valor do nó atual como um DateTime.

ValueAsDouble

Obtém o valor do nó atual como um Double.

ValueAsInt

Obtém o valor do nó atual como um Int32.

ValueAsLong

Obtém o valor do nó atual como um Int64.

ValueType

Obtém o .NET Type do nó atual.

XmlLang

Obtém o xml:lang escopo do nó atual.

XmlType

Obtém as XmlSchemaType informações do nó atual.

Métodos

Nome Description
AppendChild()

Retorna um XmlWriter objeto usado para criar um ou mais novos nós filho no final da lista de nós filho do nó atual.

AppendChild(String)

Cria um novo nó filho no final da lista de nós filho do nó atual usando a cadeia de caracteres de dados XML especificada.

AppendChild(XmlReader)

Cria um novo nó filho no final da lista de nós filho do nó atual usando o conteúdo XML do XmlReader objeto especificado.

AppendChild(XPathNavigator)

Cria um novo nó filho no final da lista de nós filho do nó atual usando os nós XPathNavigator especificados.

AppendChildElement(String, String, String, String)

Cria um novo nó de elemento filho no final da lista de nós filho do nó atual usando o prefixo do namespace, o nome local e o URI do namespace especificados com o valor especificado.

CheckValidity(XmlSchemaSet, ValidationEventHandler)

Verifica se os dados XML estão em XPathNavigator conformidade com o esquema XSD (linguagem de definição de esquema XML) fornecido.

Clone()

Quando substituído em uma classe derivada, cria um novo XPathNavigator posicionado no mesmo nó que este XPathNavigator.

ComparePosition(XPathNavigator)

Compara a posição da corrente XPathNavigator com a posição do XPathNavigator especificado.

Compile(String)

Compila uma cadeia de caracteres que representa uma expressão XPath e retorna um XPathExpression objeto.

CreateAttribute(String, String, String, String)

Cria um nó de atributo no nó do elemento atual usando o prefixo do namespace, o nome local e o URI do namespace especificados com o valor especificado.

CreateAttributes()

Retorna um XmlWriter objeto usado para criar novos atributos no elemento atual.

CreateNavigator()

Retorna uma cópia do XPathNavigator.

DeleteRange(XPathNavigator)

Exclui um intervalo de nós irmãos do nó atual para o nó especificado.

DeleteSelf()

Exclui o nó atual e seus nós filho.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Evaluate(String, IXmlNamespaceResolver)

Avalia a expressão XPath especificada e retorna o resultado digitado, usando o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace na expressão XPath.

Evaluate(String)

Avalia a expressão XPath especificada e retorna o resultado digitado.

Evaluate(XPathExpression, XPathNodeIterator)

Usa o contexto fornecido para avaliar e XPathExpressionretorna o resultado digitado.

Evaluate(XPathExpression)

Avalia e XPathExpression retorna o resultado digitado.

GetAttribute(String, String)

Obtém o valor do atributo com o nome local especificado e o URI do namespace.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetNamespace(String)

Retorna o valor do nó de namespace correspondente ao nome local especificado.

GetNamespacesInScope(XmlNamespaceScope)

Retorna os namespaces no escopo do nó atual.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InsertAfter()

Retorna um XmlWriter objeto usado para criar um novo nó irmão após o nó selecionado no momento.

InsertAfter(String)

Cria um novo nó irmão após o nó selecionado no momento usando a cadeia de caracteres XML especificada.

InsertAfter(XmlReader)

Cria um novo nó irmão após o nó selecionado no momento usando o conteúdo XML do XmlReader objeto especificado.

InsertAfter(XPathNavigator)

Cria um novo nó irmão após o nó selecionado no momento usando os nós no XPathNavigator objeto especificado.

InsertBefore()

Retorna um XmlWriter objeto usado para criar um novo nó irmão antes do nó selecionado no momento.

InsertBefore(String)

Cria um novo nó irmão antes do nó selecionado no momento usando a cadeia de caracteres XML especificada.

InsertBefore(XmlReader)

Cria um novo nó irmão antes do nó selecionado no momento usando o conteúdo XML do XmlReader objeto especificado.

InsertBefore(XPathNavigator)

Cria um novo nó irmão antes do nó selecionado no momento usando os nós especificados XPathNavigator .

InsertElementAfter(String, String, String, String)

Cria um novo elemento irmão após o nó atual usando o prefixo do namespace, o nome local e o URI do namespace especificados, com o valor especificado.

InsertElementBefore(String, String, String, String)

Cria um novo elemento irmão antes do nó atual usando o prefixo do namespace, o nome local e o URI do namespace especificados, com o valor especificado.

IsDescendant(XPathNavigator)

Determina se o especificado XPathNavigator é um descendente do atual XPathNavigator.

IsSamePosition(XPathNavigator)

Quando substituído em uma classe derivada, determina se a corrente XPathNavigator está na mesma posição que a especificada XPathNavigator.

LookupNamespace(String)

Obtém o URI do namespace para o prefixo especificado.

LookupPrefix(String)

Obtém o prefixo declarado para o URI do namespace especificado.

Matches(String)

Determina se o nó atual corresponde à expressão XPath especificada.

Matches(XPathExpression)

Determina se o nó atual corresponde ao especificado XPathExpression.

MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
MoveTo(XPathNavigator)

Quando substituído em uma classe derivada, move a XPathNavigator mesma posição que a especificada XPathNavigator.

MoveToAttribute(String, String)

Move o XPathNavigator atributo para o nome local correspondente e o URI do namespace.

MoveToChild(String, String)

Move o XPathNavigator nó filho para o nome local e o URI do namespace especificados.

MoveToChild(XPathNodeType)

Move o XPathNavigator nó filho do XPathNodeType especificado para o nó filho.

MoveToFirst()

Move XPathNavigator ao primeiro nó irmãos do nó atual.

MoveToFirstAttribute()

Quando substituído em uma classe derivada, move o XPathNavigator primeiro atributo do nó atual.

MoveToFirstChild()

Quando substituído em uma classe derivada, move o XPathNavigator nó filho para o primeiro nó filho do nó atual.

MoveToFirstNamespace()

Move o nó para o XPathNavigator primeiro namespace do nó atual.

MoveToFirstNamespace(XPathNamespaceScope)

Quando substituído em uma classe derivada, move o XPathNavigator nó para o primeiro namespace que corresponde ao XPathNamespaceScope especificado.

MoveToFollowing(String, String, XPathNavigator)

Move o XPathNavigator elemento para o elemento com o nome local e o URI do namespace especificados, para o limite especificado, na ordem do documento.

MoveToFollowing(String, String)

Move o XPathNavigator elemento para o elemento com o nome local e o URI do namespace especificados na ordem do documento.

MoveToFollowing(XPathNodeType, XPathNavigator)

Move o XPathNavigator elemento a seguir do XPathNodeType especificado, para o limite especificado, na ordem do documento.

MoveToFollowing(XPathNodeType)

Move o XPathNavigator elemento a seguir do XPathNodeType especificado na ordem do documento.

MoveToId(String)

Quando substituído em uma classe derivada, move-se para o nó que tem um atributo de tipo ID cujo valor corresponde ao especificado String.

MoveToNamespace(String)

Move o XPathNavigator nó do namespace para o namespace com o prefixo de namespace especificado.

MoveToNext()

Quando substituído em uma classe derivada, move o XPathNavigator nó irmão seguinte do nó atual.

MoveToNext(String, String)

Move o XPathNavigator nó irmão seguinte com o nome local e o URI do namespace especificados.

MoveToNext(XPathNodeType)

Move o XPathNavigator nó irmão seguinte do nó atual que corresponde ao XPathNodeType especificado.

MoveToNextAttribute()

Quando substituído em uma classe derivada, move o XPathNavigator atributo para o próximo.

MoveToNextNamespace()

Move o XPathNavigator nó do namespace seguinte para o próximo.

MoveToNextNamespace(XPathNamespaceScope)

Quando substituído em uma classe derivada, move o XPathNavigator nó do namespace seguinte correspondente ao XPathNamespaceScope especificado.

MoveToParent()

Quando substituído em uma classe derivada, move o XPathNavigator nó pai do nó atual.

MoveToPrevious()

Quando substituído em uma classe derivada, move o XPathNavigator nó irmão anterior do nó atual.

MoveToRoot()

Move o XPathNavigator nó raiz ao qual o nó atual pertence.

PrependChild()

Retorna um XmlWriter objeto usado para criar um novo nó filho no início da lista de nós filho do nó atual.

PrependChild(String)

Cria um novo nó filho no início da lista de nós filho do nó atual usando a cadeia de caracteres XML especificada.

PrependChild(XmlReader)

Cria um novo nó filho no início da lista de nós filho do nó atual usando o conteúdo XML do XmlReader objeto especificado.

PrependChild(XPathNavigator)

Cria um novo nó filho no início da lista de nós filho do nó atual usando os nós no XPathNavigator objeto especificado.

PrependChildElement(String, String, String, String)

Cria um novo elemento filho no início da lista de nós filho do nó atual usando o prefixo do namespace, o nome local e o URI do namespace especificados com o valor especificado.

ReadSubtree()

Retorna um XmlReader objeto que contém o nó atual e seus nós filho.

ReplaceRange(XPathNavigator)

Substitui um intervalo de nós irmãos do nó atual para o nó especificado.

ReplaceSelf(String)

Substitui o nó atual pelo conteúdo da cadeia de caracteres especificada.

ReplaceSelf(XmlReader)

Substitui o nó atual pelo conteúdo do XmlReader objeto especificado.

ReplaceSelf(XPathNavigator)

Substitui o nó atual pelo conteúdo do XPathNavigator objeto especificado.

Select(String, IXmlNamespaceResolver)

Seleciona um conjunto de nós usando a expressão XPath especificada com o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace.

Select(String)

Seleciona um conjunto de nós usando a expressão XPath especificada.

Select(XPathExpression)

Seleciona um conjunto de nós usando o especificado XPathExpression.

SelectAncestors(String, String, Boolean)

Seleciona todos os nós ancestrais do nó atual que têm o nome local e o URI do namespace especificados.

SelectAncestors(XPathNodeType, Boolean)

Seleciona todos os nós ancestrais do nó atual que têm uma correspondência XPathNodeType.

SelectChildren(String, String)

Seleciona todos os nós filho do nó atual que têm o nome local e o URI do namespace especificados.

SelectChildren(XPathNodeType)

Seleciona todos os nós filho do nó atual que têm a correspondência XPathNodeType.

SelectDescendants(String, String, Boolean)

Seleciona todos os nós descendentes do nó atual com o nome local e o URI do namespace especificados.

SelectDescendants(XPathNodeType, Boolean)

Seleciona todos os nós descendentes do nó atual que têm uma correspondência XPathNodeType.

SelectSingleNode(String, IXmlNamespaceResolver)

Seleciona um único nó no XPathNavigator objeto usando a consulta XPath especificada com o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace.

SelectSingleNode(String)

Seleciona um único nó na XPathNavigator consulta XPath especificada.

SelectSingleNode(XPathExpression)

Seleciona um único nó no XPathNavigator uso do objeto especificado XPathExpression .

SetTypedValue(Object)

Define o valor digitado do nó atual.

SetValue(String)

Define o valor do nó atual.

ToString()

Obtém o valor de texto do nó atual.

ValueAs(Type, IXmlNamespaceResolver)

Obtém o valor do nó atual como especificado Type , usando o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace.

ValueAs(Type)

Retorna o valor do item como o tipo especificado.

(Herdado de XPathItem)
WriteSubtree(XmlWriter)

Transmite o nó atual e seus nós filho para o XmlWriter objeto especificado.

Implantações explícitas de interface

Nome Description
ICloneable.Clone()

Cria uma nova cópia do XPathNavigator objeto.

Aplica-se a

Confira também