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 XQuery 1.0 e XPath 2.0 Data Model.

Um XPathNavigator objeto é criado a partir de uma classe que implementa a IXPathNavigable interface, como as XPathDocument classes e XmlDocument . 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 o tópico Processar dados XML usando o modelo de dados XPath .

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

XPathNavigator()

Inicializa uma nova instância da classe XPathNavigator.

Propriedades

BaseURI

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

CanEdit

Obtém um valor que indica se o XPathNavigator pode editar os dados XML subjacentes.

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 do 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 de namespace do nó atual.

NameTable

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

NavigatorComparer

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

NodeType

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

OuterXml

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

Prefix

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

SchemaInfo

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

TypedValue

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

UnderlyingObject

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

Value

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

Value

Quando substituído em uma classe derivada, obtém o valor string 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 Type do .NET do nó atual.

XmlLang

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

XmlType

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

XmlType

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

(Herdado de XPathItem)

Métodos

AppendChild()

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

AppendChild(String)

Cria um novo nó filho ao 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 ao final da lista de nós filho do nó atual usando o conteúdo XML do objeto XmlReader especificado.

AppendChild(XPathNavigator)

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

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 especificado, com o valor especificado.

CheckValidity(XmlSchemaSet, ValidationEventHandler)

Verifica se os dados XML no XPathNavigator estão em conformidade com o 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 do XPathNavigator atual com a posição do XPathNavigator especificado.

Compile(String)

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

CreateAttribute(String, String, String, String)

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

CreateAttributes()

Retorna um objeto XmlWriter 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)

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

Evaluate(String, IXmlNamespaceResolver)

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

Evaluate(XPathExpression)

Avalia XPathExpression e retorna o resultado de tipo.

Evaluate(XPathExpression, XPathNodeIterator)

Usa o contexto fornecido para avaliar o XPathExpression e retorna o resultado com tipo.

GetAttribute(String, String)

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

GetHashCode()

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

(Herdado de Object)
GetNamespace(String)

Retorna o valor do nó de namespace que corresponde 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 objeto XmlWriter usado para criar um novo nó irmão após o nó atualmente selecionado.

InsertAfter(String)

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

InsertAfter(XmlReader)

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

InsertAfter(XPathNavigator)

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

InsertBefore()

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

InsertBefore(String)

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

InsertBefore(XmlReader)

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

InsertBefore(XPathNavigator)

Cria um novo nó irmão antes do nó atualmente selecionado, usando os nós no XPathNavigator especificado.

InsertElementAfter(String, String, String, String)

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

InsertElementBefore(String, String, String, String)

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

IsDescendant(XPathNavigator)

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

IsSamePosition(XPathNavigator)

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

LookupNamespace(String)

Obtém o URI do namespace do prefixo especificado.

LookupPrefix(String)

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

Matches(String)

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

Matches(XPathExpression)

Determina se o nó atual corresponde ao XPathExpression especificado.

MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MoveTo(XPathNavigator)

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

MoveToAttribute(String, String)

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

MoveToChild(String, String)

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

MoveToChild(XPathNodeType)

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

MoveToFirst()

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

MoveToFirstAttribute()

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

MoveToFirstChild()

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

MoveToFirstNamespace()

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

MoveToFirstNamespace(XPathNamespaceScope)

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

MoveToFollowing(String, String)

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

MoveToFollowing(String, String, XPathNavigator)

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

MoveToFollowing(XPathNodeType)

Move o XPathNavigator para o próximo elemento do XPathNodeType especificado na ordem do documento.

MoveToFollowing(XPathNodeType, XPathNavigator)

Move o XPathNavigator para o próximo elemento do XPathNodeType especificado, até o limite especificado, na ordem do documento.

MoveToId(String)

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

MoveToNamespace(String)

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

MoveToNext()

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

MoveToNext(String, String)

Move o XPathNavigator para o próximo nó irmão com o nome local e o URI do namespace especificado.

MoveToNext(XPathNodeType)

Move o XPathNavigator para o próximo nó irmão do nó atual que corresponde ao XPathNodeType especificado.

MoveToNextAttribute()

Quando substituído em uma classe derivada, move o XPathNavigator para o atributo seguinte.

MoveToNextNamespace()

Move o XPathNavigator para o próximo nó de namespace.

MoveToNextNamespace(XPathNamespaceScope)

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

MoveToParent()

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

MoveToPrevious()

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

MoveToRoot()

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

PrependChild()

Retorna um objeto XmlWriter 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 objeto XmlReader 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 objeto XPathNavigator 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 especificado, com o valor especificado.

ReadSubtree()

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

ReplaceRange(XPathNavigator)

Substitui um intervalo de nós irmão, do nó atual ao nó especificado.

ReplaceSelf(String)

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

ReplaceSelf(XmlReader)

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

ReplaceSelf(XPathNavigator)

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

Select(String)

Seleciona um nó definido usando a expressão XPath especificada.

Select(String, IXmlNamespaceResolver)

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

Select(XPathExpression)

Seleciona um nó definido usando o XPathExpression especificado.

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 um XPathNodeType correspondente.

SelectChildren(String, String)

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

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 especificado.

SelectDescendants(XPathNodeType, Boolean)

Seleciona todos os nós descendentes do nó atual que têm um XPathNodeType correspondente.

SelectSingleNode(String)

Seleciona um único nó no XPathNavigator usando a consulta XPath especificada.

SelectSingleNode(String, IXmlNamespaceResolver)

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

SelectSingleNode(XPathExpression)

Seleciona um único nó no XPathNavigator usando o objeto XPathExpression especificado.

SetTypedValue(Object)

Define o valor tipado do nó atual.

SetValue(String)

Define o valor do nó atual.

ToString()

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

ValueAs(Type)

Retorna o valor do item como o tipo especificado.

(Herdado de XPathItem)
ValueAs(Type, IXmlNamespaceResolver)

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

WriteSubtree(XmlWriter)

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

Implantações explícitas de interface

ICloneable.Clone()

Cria uma nova cópia do objeto XPathNavigator.

Aplica-se a

Confira também