XPathNavigator Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- Herança
-
XPathNavigator
- Derivado
- Implementações
Observações
A XPathNavigator classe no System.Xml.XPath namespace é uma classe abstrata que define um modelo de cursor para navegar e editar itens de informação 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 XPathDocument classes e.XmlDocument XPathNavigator Os objetos criados por XPathDocument objetos são apenas de leitura, enquanto XPathNavigator os objetos criados por XmlDocument objetos podem ser editados. O estado de apenas leitura ou editável de um XPathNavigator objeto é determinado usando a CanEdit propriedade da XPathNavigator classe.
Para mais informações sobre o processamento de dados XML usando o modelo de dados XPath, consulte o tópico Processar Dados XML Usando o Modelo de Dados XPath .
Importante
Exceções levantadas como resultado do uso da XPathNavigator classe, como a XPathException classe, podem conter informações sensíveis que não devem ser expostas em cenários não confiáveis. As exceções devem ser tratadas adequadamente para que essas informações confidenciais não sejam expostas em cenários não confiáveis.
Notas para Implementadores
Quando herdas da XPathNavigator classe, deves sobrepor os seguintes membros:
Construtores
| Name | Description |
|---|---|
| XPathNavigator() |
Inicializa uma nova instância da XPathNavigator classe. |
Propriedades
| Name | Description |
|---|---|
| BaseURI |
Quando é sobreposto numa classe derivada, obtém o URI base do nó atual. |
| CanEdit |
Recebe um valor que indica se pode XPathNavigator editar os dados XML subjacentes. |
| HasAttributes |
Recebe um valor que indica se o nó atual tem algum atributo. |
| HasChildren |
Recebe um valor que indica se o nó atual tem algum nó filho. |
| InnerXml |
Obtém ou define a marcação que representa os nós filhos do nó atual. |
| IsEmptyElement |
Quando sobrescrito numa classe derivada, obtém um valor que indica se o nó atual é um elemento vazio sem etiqueta de elemento final. |
| IsNode |
Recebe um valor que indica se o nó atual representa um nó XPath. |
| LocalName |
Quando sobrescrito numa classe derivada, obtém o Name do nó atual sem qualquer prefixo de namespace. |
| Name |
Quando sobrescrito numa classe derivada, obtém o nome qualificado do nó atual. |
| NamespaceURI |
Quando é sobreposto numa classe derivada, obtém o URI do namespace do nó atual. |
| NameTable |
Quando sobrescrito numa classe derivada, obtém o XmlNameTable de .XPathNavigator |
| NavigatorComparer |
Obtém um IEqualityComparer uso para comparação de igualdade de XPathNavigator objetos. |
| NodeType |
Quando sobrescrito numa classe derivada, obtém o XPathNodeType do nó atual. |
| OuterXml |
Obtém ou define a marcação que representa as etiquetas de abertura e fecho do nó atual e dos seus nós filhos. |
| Prefix |
Quando é sobreposto numa classe derivada, obtém o prefixo de namespace associado ao nó atual. |
| SchemaInfo |
Obtém a informação do esquema que foi atribuída 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 vista XML "virtualizada" sobre um armazenamento, para dar acesso a objetos subjacentes. |
| Value |
Quando sobrescrito numa classe derivada, obtém o valor da cadeia do item. |
| Value |
Quando é sobreposto numa classe derivada, obtém o |
| 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 |
| XmlType |
Obtém a XmlSchemaType informação do nó atual. |
Métodos
| Name | Description |
|---|---|
| AppendChild() |
Devolve um XmlWriter objeto 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 no final da lista de nós filhos do nó atual usando a cadeia de dados XML especificada. |
| AppendChild(XmlReader) |
Cria um novo nó filho no final da lista de nós filhos 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 filhos do nó atual usando os nós especificados XPathNavigator . |
| AppendChildElement(String, String, String, String) |
Cria um novo nó de elemento filho no final da lista de nós filhos do nó atual usando o prefixo do espaço de nomes, nome local e URI do espaço de nomes especificados com o valor especificado. |
| CheckValidity(XmlSchemaSet, ValidationEventHandler) |
Verifica se os dados XML no XPathNavigator estão em conformidade com o esquema da linguagem de definição de esquemas XML (XSD) fornecido. |
| Clone() |
Quando sobrescrito numa 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 string que representa uma expressão XPath e devolve um XPathExpression objeto. |
| CreateAttribute(String, String, String, String) |
Cria um nó de atributo no nó de elemento atual usando o prefixo do namespace, nome local e URI do namespace especificados com o valor especificado. |
| CreateAttributes() |
Devolve um XmlWriter objeto usado para criar novos atributos no elemento atual. |
| CreateNavigator() |
Devolve uma cópia do XPathNavigatorarquivo . |
| DeleteRange(XPathNavigator) |
Elimina um intervalo de nós irmãos desde o nó atual até ao nó especificado. |
| DeleteSelf() |
Elimina o nó atual e os seus nós filhos. |
| 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 tipado, usando o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace na expressão XPath. |
| Evaluate(String) |
Avalia a expressão XPath especificada e devolve o resultado tipado. |
| Evaluate(XPathExpression, XPathNodeIterator) |
Utiliza o contexto fornecido para avaliar o XPathExpression, e devolve o resultado tipado. |
| Evaluate(XPathExpression) |
Avalia o XPathExpression e devolve o resultado digitado. |
| GetAttribute(String, String) |
Obtém o valor do atributo com o nome local especificado e o URI do espaço de nomes. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetNamespace(String) |
Devolve o valor do nó do namespace correspondente ao nome local especificado. |
| GetNamespacesInScope(XmlNamespaceScope) |
Devolve os namespaces dentro do âmbito do nó atual. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InsertAfter() |
Devolve um XmlWriter objeto 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 string XML especificada. |
| InsertAfter(XmlReader) |
Cria um novo nó irmão após o nó atualmente selecionado usando o conteúdo XML do XmlReader objeto especificado. |
| InsertAfter(XPathNavigator) |
Cria um novo nó irmão após o nó atualmente selecionado usando os nós no XPathNavigator objeto especificado. |
| InsertBefore() |
Devolve um XmlWriter objeto 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 string XML especificada. |
| InsertBefore(XmlReader) |
Cria um novo nó irmão antes do nó atualmente selecionado usando o conteúdo XML do XmlReader objeto especificado. |
| InsertBefore(XPathNavigator) |
Cria um novo nó irmão antes do nó atualmente selecionado 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, nome local e 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, nome local e URI do namespace especificados, com o valor especificado. |
| IsDescendant(XPathNavigator) |
Determina se o especificado XPathNavigator é descendente do atual XPathNavigator. |
| IsSamePosition(XPathNavigator) |
Quando sobrescrito numa classe derivada, determina se a corrente XPathNavigator está na mesma posição que a especificada XPathNavigator. |
| LookupNamespace(String) |
Recebe o URI de 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 atual Object. (Herdado de Object) |
| MoveTo(XPathNavigator) |
Quando sobrescrito numa classe derivada, move o XPathNavigator para a mesma posição que a especificada XPathNavigator. |
| MoveToAttribute(String, String) |
Move o XPathNavigator para o atributo com o nome local correspondente e o URI do espaço de nomes. |
| MoveToChild(String, String) |
Move o XPathNavigator para o nó filho com o nome local e o URI do espaço de nomes especificados. |
| MoveToChild(XPathNodeType) |
Move o XPathNavigator para o nó filho do XPathNodeType especificado. |
| MoveToFirst() |
Move o XPathNavigator para o primeiro nó irmão do nó atual. |
| MoveToFirstAttribute() |
Quando sobrescrito numa classe derivada, move o XPathNavigator para o primeiro atributo do nó atual. |
| MoveToFirstChild() |
Quando sobreposto numa classe derivada, move o XPathNavigator para o primeiro nó filho do nó atual. |
| MoveToFirstNamespace() |
Move o XPathNavigator nó para o primeiro namespace do nó atual. |
| MoveToFirstNamespace(XPathNamespaceScope) |
Quando é sobreposto numa classe derivada, move o XPathNavigator para o primeiro nó de namespace que corresponde ao XPathNamespaceScope especificado. |
| MoveToFollowing(String, String, XPathNavigator) |
Move o XPathNavigator para o elemento com o nome local e o URI do espaço de nomes especificados, para a fronteira especificada, por ordem do documento. |
| MoveToFollowing(String, String) |
Move o XPathNavigator para o elemento com o nome local e o URI do espaço de nomes especificados na ordem do documento. |
| MoveToFollowing(XPathNodeType, XPathNavigator) |
Move o XPathNavigator para o seguinte elemento do XPathNodeType especificado, para o limite especificado, por ordem do documento. |
| MoveToFollowing(XPathNodeType) |
Move o XPathNavigator para o elemento seguinte do XPathNodeType especificado na ordem do documento. |
| MoveToId(String) |
Quando sobrescrito numa classe derivada, move-se para o nó que tem um atributo de tipo |
| MoveToNamespace(String) |
Move o XPathNavigator para o nó de espaço de nomes com o prefixo especificado. |
| MoveToNext() |
Quando sobreposto numa classe derivada, move o XPathNavigator para o nó irmão seguinte do nó atual. |
| MoveToNext(String, String) |
Move o XPathNavigator para o próximo nó irmão com o nome local e o URI do espaço de nomes especificados. |
| MoveToNext(XPathNodeType) |
Move o XPathNavigator para o próximo nó irmão do nó atual que corresponde ao XPathNodeType especificado. |
| MoveToNextAttribute() |
Quando é sobreposto numa classe derivada, move o XPathNavigator para o atributo seguinte. |
| MoveToNextNamespace() |
Move o XPathNavigator para o próximo nó de namespace. |
| MoveToNextNamespace(XPathNamespaceScope) |
Quando é sobreposto numa classe derivada, move o XPathNavigator para o próximo nó de namespace que corresponde ao XPathNamespaceScope especificado. |
| MoveToParent() |
Quando sobrescrito numa classe derivada, move o XPathNavigator para o nó pai do nó atual. |
| MoveToPrevious() |
Quando sobreposto numa classe derivada, move o XPathNavigator para o nó irmão anterior do nó atual. |
| MoveToRoot() |
Move o XPathNavigator para o nó raiz ao qual pertence o nó atual. |
| PrependChild() |
Devolve um XmlWriter objeto usado para criar um novo nó filho no início da lista de nós filhos do nó atual. |
| PrependChild(String) |
Cria um novo nó filho no início da lista de nós filhos do nó atual usando a string XML especificada. |
| PrependChild(XmlReader) |
Cria um novo nó filho no início da lista de nós filhos 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 filhos 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 filhos do nó atual usando o prefixo do espaço de nomes, o nome local e o URI do espaço de nomes especificados com o valor especificado. |
| ReadSubtree() |
Devolve um XmlReader objeto que contém o nó atual e os seus nós filhos. |
| ReplaceRange(XPathNavigator) |
Substitui um conjunto de nós irmãos do nó atual para o nó especificado. |
| ReplaceSelf(String) |
Substitui o nó atual pelo conteúdo da cadeia 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 espaço de nomes. |
| 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 tenham o nome local e o espaço de nomes URI especificados. |
| SelectAncestors(XPathNodeType, Boolean) |
Seleciona todos os nós ancestrais do nó atual que tenham uma correspondência XPathNodeType. |
| SelectChildren(String, String) |
Seleciona todos os nós filhos do nó atual que têm o nome local e o URI do espaço de nomes especificados. |
| SelectChildren(XPathNodeType) |
Seleciona todos os nós filhos 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 espaço de nomes especificados. |
| SelectDescendants(XPathNodeType, Boolean) |
Seleciona todos os nós descendentes do nó atual que tenham um correspondente 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ó em usando XPathNavigator a consulta XPath especificada. |
| SelectSingleNode(XPathExpression) |
Seleciona um único nó em usando XPathNavigator o objeto especificado XPathExpression . |
| SetTypedValue(Object) |
Define o valor tiposado 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 Type especificado, usando o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace. |
| ValueAs(Type) |
Devolve o valor do artigo como o tipo especificado. (Herdado de XPathItem) |
| WriteSubtree(XmlWriter) |
Transmite o nó atual e os seus nós filhos para o XmlWriter objeto especificado. |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ICloneable.Clone() |
Cria uma nova cópia do XPathNavigator objeto. |