XmlDataDocument Classe

Definição

Cuidado

XmlDataDocument class will be removed in a future release.

Permite que os dados estruturados sejam armazenados, recuperados e manipulados por meio de um DataSet relacional.Allows structured data to be stored, retrieved, and manipulated through a relational DataSet.

public ref class XmlDataDocument : System::Xml::XmlDocument
[System.Obsolete("XmlDataDocument class will be removed in a future release.")]
public class XmlDataDocument : System.Xml.XmlDocument
public class XmlDataDocument : System.Xml.XmlDocument
[<System.Obsolete("XmlDataDocument class will be removed in a future release.")>]
type XmlDataDocument = class
    inherit XmlDocument
type XmlDataDocument = class
    inherit XmlDocument
Public Class XmlDataDocument
Inherits XmlDocument
Herança
XmlDataDocument
Atributos

Comentários

Essa classe se estende XmlDocument .This class extends XmlDocument. Ele permite que você carregue dados relacionais ou dados XML e manipule esses dados usando o World Wide Web Consortium (W3C) Modelo de Objeto do Documento (DOM).It enables you to load either relational data or XML data and manipulate that data using the World Wide Web Consortium (W3C) Document Object Model (DOM). O DOM apresenta dados como uma hierarquia de objetos de nó.The DOM presents data as a hierarchy of node objects. Como o XmlDataDocument implementa a IXPathNavigable interface, ela também pode ser usada como o documento de origem para a XslTransform classe.Because XmlDataDocument implements the IXPathNavigable interface, it can also be used as the source document for the XslTransform class.

XmlDataDocument tem uma afiliação próxima à DataSet classe, que fornece uma exibição relacional dos dados XML carregados.XmlDataDocument has a close affiliation with the DataSet class, which provides a relational view of the loaded XML data. As alterações feitas no XmlDataDocument são refletidas no DataSet e vice-versa.Any changes made to the XmlDataDocument are reflected in the DataSet and vice versa.

Para carregar um DataSet com dados XML, use ReadXmlSchema para criar um mapeamento relacional.To load a DataSet with XML data, use ReadXmlSchema to build a relational mapping. Os dados XML podem então ser carregados usando Load ou LoadXml .The XML data can then be loaded using Load or LoadXml.

Para carregar dados relacionais, especifique o DataSet que contém os dados relacionais como o parâmetro no XmlDataDocument Construtor.To load relational data, specify the DataSet containing the relational data as the parameter in the XmlDataDocument constructor.

Construtores

XmlDataDocument()

Inicializa uma nova instância da classe XmlDataDocument.Initializes a new instance of the XmlDataDocument class.

XmlDataDocument(DataSet)

Inicializa uma nova instância da classe XmlDataDocument com o DataSet especificado.Initializes a new instance of the XmlDataDocument class with the specified DataSet.

Propriedades

Attributes

Obtém um XmlAttributeCollection que contém os atributos desse nó.Gets an XmlAttributeCollection containing the attributes of this node.

(Herdado de XmlNode)
BaseURI

Obtém o URI base do nó atual.Gets the base URI of the current node.

(Herdado de XmlDocument)
ChildNodes

Obtém todos os nós filho do nó.Gets all the child nodes of the node.

(Herdado de XmlNode)
DataSet

Obtém um DataSet que fornece uma representação relacional dos dados no XmlDataDocument.Gets a DataSet that provides a relational representation of the data in the XmlDataDocument.

DocumentElement

Obtém a raiz XmlElement para o documento.Gets the root XmlElement for the document.

(Herdado de XmlDocument)
DocumentType

Obtém o nó que contém a declaração DOCTYPE.Gets the node containing the DOCTYPE declaration.

(Herdado de XmlDocument)
FirstChild

Obtém o primeiro filho do nó.Gets the first child of the node.

(Herdado de XmlNode)
HasChildNodes

Obtém um valor que indica se este nó tem nós filho.Gets a value indicating whether this node has any child nodes.

(Herdado de XmlNode)
Implementation

Obtém o objeto XmlImplementation para o documento atual.Gets the XmlImplementation object for the current document.

(Herdado de XmlDocument)
InnerText

Aciona um InvalidOperationException em todos os casos.Throws an InvalidOperationException in all cases.

(Herdado de XmlDocument)
InnerXml

Obtém ou define a marcação que representa os filhos do nó atual.Gets or sets the markup representing the children of the current node.

(Herdado de XmlDocument)
IsReadOnly

Obtém um valor que indica se o nó atual é somente leitura.Gets a value indicating whether the current node is read-only.

(Herdado de XmlDocument)
Item[String, String]

Obtém o primeiro elemento filho com o LocalName e o NamespaceURI especificados.Gets the first child element with the specified LocalName and NamespaceURI.

(Herdado de XmlNode)
Item[String]

Obtém o primeiro elemento filho com o Name especificado.Gets the first child element with the specified Name.

(Herdado de XmlNode)
LastChild

Obtém o último filho do nó.Gets the last child of the node.

(Herdado de XmlNode)
LocalName

Obtém o nome local do nó.Gets the local name of the node.

(Herdado de XmlDocument)
Name

Obtém o nome qualificado do nó.Gets the qualified name of the node.

(Herdado de XmlDocument)
NamespaceURI

Obtém o URI do namespace deste nó.Gets the namespace URI of this node.

(Herdado de XmlNode)
NameTable

Obtém o XmlNameTable associado à essa implementação.Gets the XmlNameTable associated with this implementation.

(Herdado de XmlDocument)
NextSibling

Obtém o nó imediatamente posterior a este nó.Gets the node immediately following this node.

(Herdado de XmlNode)
NodeType

Obtém o tipo do nó atual.Gets the type of the current node.

(Herdado de XmlDocument)
OuterXml

Obtém a marcação que contém esse nó e todos os nós filho.Gets the markup containing this node and all its child nodes.

(Herdado de XmlNode)
OwnerDocument

Obtém o XmlDocument ao qual pertence o nó atual.Gets the XmlDocument to which the current node belongs.

(Herdado de XmlDocument)
ParentNode

Obtém o nó pai desse nó (para os nós que podem ter pais).Gets the parent node of this node (for nodes that can have parents).

(Herdado de XmlDocument)
Prefix

Obtém ou define o prefixo de namespace desse nó.Gets or sets the namespace prefix of this node.

(Herdado de XmlNode)
PreserveWhitespace

Obtém ou define um valor que indica se os espaços em branco devem ser preservados no conteúdo do elemento.Gets or sets a value indicating whether to preserve white space in element content.

(Herdado de XmlDocument)
PreviousSibling

Obtém o nó imediatamente anterior a este nó.Gets the node immediately preceding this node.

(Herdado de XmlNode)
PreviousText

Obtém o nó de texto que precede imediatamente este nó.Gets the text node that immediately precedes this node.

(Herdado de XmlNode)
SchemaInfo

Retorna o PSVI (Post-Schema-Validation-Infoset) do nó.Returns the Post-Schema-Validation-Infoset (PSVI) of the node.

(Herdado de XmlDocument)
Schemas

Obtém ou define o objeto XmlSchemaSet associado a esse XmlDocument.Gets or sets the XmlSchemaSet object associated with this XmlDocument.

(Herdado de XmlDocument)
Value

Obtém ou define o valor do nó.Gets or sets the value of the node.

(Herdado de XmlNode)
XmlResolver

Define o XmlResolver que será usado para resolver recursos externos.Sets the XmlResolver to use for resolving external resources.

(Herdado de XmlDocument)

Métodos

AppendChild(XmlNode)

Adiciona o nó especificado ao final da lista de nós filho desse nó.Adds the specified node to the end of the list of child nodes, of this node.

(Herdado de XmlNode)
Clone()

Cria uma duplicação deste nó.Creates a duplicate of this node.

(Herdado de XmlNode)
CloneNode(Boolean)

Cria uma duplicata do nó atual.Creates a duplicate of the current node.

CreateAttribute(String)

Cria um XmlAttribute com o Name especificado.Creates an XmlAttribute with the specified Name.

(Herdado de XmlDocument)
CreateAttribute(String, String)

Cria um XmlAttribute com o nome e dados especificados e NamespaceURI.Creates an XmlAttribute with the specified qualified name and NamespaceURI.

(Herdado de XmlDocument)
CreateAttribute(String, String, String)

Cria um XmlAttribute com o Prefix, LocalName e NamespaceURI especificados.Creates an XmlAttribute with the specified Prefix, LocalName, and NamespaceURI.

(Herdado de XmlDocument)
CreateCDataSection(String)

Cria um XmlCDataSection que contém os dados especificados.Creates an XmlCDataSection containing the specified data.

(Herdado de XmlDocument)
CreateComment(String)

Cria um XmlComment que contém os dados especificados.Creates an XmlComment containing the specified data.

(Herdado de XmlDocument)
CreateDefaultAttribute(String, String, String)

Cria um atributo padrão com o prefixo especificado, o nome local e o URI de namespace.Creates a default attribute with the specified prefix, local name and namespace URI.

(Herdado de XmlDocument)
CreateDocumentFragment()

Cria um XmlDocumentFragment.Creates an XmlDocumentFragment.

(Herdado de XmlDocument)
CreateDocumentType(String, String, String, String)

Retorna um novo objeto XmlDocumentType.Returns a new XmlDocumentType object.

(Herdado de XmlDocument)
CreateElement(String)

Cria um elemento com o nome especificado.Creates an element with the specified name.

(Herdado de XmlDocument)
CreateElement(String, String)

Cria um XmlElement com o nome qualificado e NamespaceURI.Creates an XmlElement with the qualified name and NamespaceURI.

(Herdado de XmlDocument)
CreateElement(String, String, String)

Cria um elemento com Prefix, LocalName e NamespaceURI especificados.Creates an element with the specified Prefix, LocalName , and NamespaceURI.

CreateEntityReference(String)

Cria um XmlEntityReference com o nome especificado.Creates an XmlEntityReference with the specified name.

CreateNavigator()

Cria um novo objeto XPathNavigator para navegar nesse documento.Creates a new XPathNavigator object for navigating this document.

(Herdado de XmlDocument)
CreateNavigator(XmlNode)

Cria um novo objeto XPathNavigator para navegar nesse documento.Creates a new XPathNavigator object for navigating this document. O XPathNavigator é posicionado no nó especificado no parâmetro node.The XPathNavigator is positioned on the node specified in the node parameter.

CreateNode(String, String, String)

Cria um XmlNode com o tipo de nó especificado, Name e NamespaceURI.Creates an XmlNode with the specified node type, Name, and NamespaceURI.

(Herdado de XmlDocument)
CreateNode(XmlNodeType, String, String)

Cria um XmlNode com o XmlNodeType, Name e NamespaceURI especificados.Creates an XmlNode with the specified XmlNodeType, Name, and NamespaceURI.

(Herdado de XmlDocument)
CreateNode(XmlNodeType, String, String, String)

Cria um XmlNode com o XmlNodeType, Prefix, Name e NamespaceURI especificados.Creates a XmlNode with the specified XmlNodeType, Prefix, Name, and NamespaceURI.

(Herdado de XmlDocument)
CreateProcessingInstruction(String, String)

Cria um XmlProcessingInstruction com o nome e dados especificados.Creates an XmlProcessingInstruction with the specified name and data.

(Herdado de XmlDocument)
CreateSignificantWhitespace(String)

Cria um nó XmlSignificantWhitespace.Creates an XmlSignificantWhitespace node.

(Herdado de XmlDocument)
CreateTextNode(String)

Cria um XmlText com o texto especificado.Creates an XmlText with the specified text.

(Herdado de XmlDocument)
CreateWhitespace(String)

Cria um nó XmlWhitespace.Creates an XmlWhitespace node.

(Herdado de XmlDocument)
CreateXmlDeclaration(String, String, String)

Cria um nó XmlDeclaration com os valores especificados.Creates an XmlDeclaration node with the specified values.

(Herdado de XmlDocument)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetElementById(String)

Obtém o XmlElement com a ID especificada.Gets the XmlElement with the specified ID. Este método não tem suporte na classe XmlDataDocument.This method is not supported by the XmlDataDocument class. Chamar esse método gerará uma exceção.Calling this method throws an exception.

GetElementFromRow(DataRow)

Recupera o XmlElement associado ao DataRow especificado.Retrieves the XmlElement associated with the specified DataRow.

GetElementsByTagName(String)

Retorna um XmlNodeList que contém uma lista de todos os elementos descendentes que correspondem ao Name especificado.Returns an XmlNodeList containing a list of all descendant elements that match the specified Name.

GetElementsByTagName(String)

Retorna um XmlNodeList que contém uma lista de todos os elementos descendentes que correspondem ao Name especificado.Returns an XmlNodeList containing a list of all descendant elements that match the specified Name.

(Herdado de XmlDocument)
GetElementsByTagName(String, String)

Retorna um XmlNodeList que contém uma lista de todos os elementos descendentes que correspondem ao LocalName e NamespaceURI especificados.Returns an XmlNodeList containing a list of all descendant elements that match the specified LocalName and NamespaceURI.

(Herdado de XmlDocument)
GetEnumerator()

Obtém um enumerador que itera pelos nós filhos do nó atual.Gets an enumerator that iterates through the child nodes in the current node.

(Herdado de XmlNode)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetNamespaceOfPrefix(String)

Procura pela declaração xmlns mais próxima para o prefixo especificado no escopo para o nó atual e retorna o URI de namespace na declaração.Looks up the closest xmlns declaration for the given prefix that is in scope for the current node and returns the namespace URI in the declaration.

(Herdado de XmlNode)
GetPrefixOfNamespace(String)

Procura pela declaração xmlns mais próxima para o URI do namespace determinado que esteja no escopo para o nó atual e retorna o prefixo definido nessa declaração.Looks up the closest xmlns declaration for the given namespace URI that is in scope for the current node and returns the prefix defined in that declaration.

(Herdado de XmlNode)
GetRowFromElement(XmlElement)

Recupera o DataRow associado ao XmlElement especificado.Retrieves the DataRow associated with the specified XmlElement.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
ImportNode(XmlNode, Boolean)

Importa um nó de outro documento para o documento atual.Imports a node from another document to the current document.

(Herdado de XmlDocument)
InsertAfter(XmlNode, XmlNode)

Insere o nó especificado imediatamente após o nó de referência especificado.Inserts the specified node immediately after the specified reference node.

(Herdado de XmlNode)
InsertBefore(XmlNode, XmlNode)

Insere o nó especificado imediatamente antes do nó de referência especificado.Inserts the specified node immediately before the specified reference node.

(Herdado de XmlNode)
Load(Stream)

Carrega o XmlDataDocument do fluxo especificado.Loads the XmlDataDocument from the specified stream.

Load(String)

Carrega o XmlDataDocument usando a URL especificada.Loads the XmlDataDocument using the specified URL.

Load(TextReader)

Carrega o XmlDataDocument do TextReader especificado.Loads the XmlDataDocument from the specified TextReader.

Load(XmlReader)

Carrega o XmlDataDocument do XmlReader especificado.Loads the XmlDataDocument from the specified XmlReader.

LoadXml(String)

Carrega o documento XML da cadeia de caracteres especificada.Loads the XML document from the specified string.

(Herdado de XmlDocument)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Normalize()

Coloca todos os nós XmlText em toda a profundidade da subárvore sob esse XmlNode em uma forma "normal" em que somente a marcação (isto é, marcas, comentários, instruções de processamento, seções CDATA e referências de entidade) separa os nós XmlText, isto é, não existem nós XmlText adjacentes.Puts all XmlText nodes in the full depth of the sub-tree underneath this XmlNode into a "normal" form where only markup (that is, tags, comments, processing instructions, CDATA sections, and entity references) separates XmlText nodes, that is, there are no adjacent XmlText nodes.

(Herdado de XmlNode)
PrependChild(XmlNode)

Adiciona o nó especificado ao início da lista de nós filho desse nó.Adds the specified node to the beginning of the list of child nodes for this node.

(Herdado de XmlNode)
ReadNode(XmlReader)

Cria um objeto XmlNode com base nas informações no XmlReader.Creates an XmlNode object based on the information in the XmlReader. O leitor deve ser posicionado em um nó ou atributo.The reader must be positioned on a node or attribute.

(Herdado de XmlDocument)
RemoveAll()

Remove todos os nós filho e/ou atributos do nó atual.Removes all the child nodes and/or attributes of the current node.

(Herdado de XmlNode)
RemoveChild(XmlNode)

Remove o nó filho especificado.Removes specified child node.

(Herdado de XmlNode)
ReplaceChild(XmlNode, XmlNode)

Substitui o nó filho oldChild pelo nó newChild.Replaces the child node oldChild with newChild node.

(Herdado de XmlNode)
Save(Stream)

Salva o documento XML no fluxo especificado.Saves the XML document to the specified stream.

(Herdado de XmlDocument)
Save(String)

Salva o documento XML no arquivo especificado.Saves the XML document to the specified file. Se o arquivo especificado existir, este método o substituirá.If the specified file exists, this method overwrites it.

(Herdado de XmlDocument)
Save(TextWriter)

Salva o documento XML no TextWriter especificado.Saves the XML document to the specified TextWriter.

(Herdado de XmlDocument)
Save(XmlWriter)

Salva o documento XML no XmlWriter especificado.Saves the XML document to the specified XmlWriter.

(Herdado de XmlDocument)
SelectNodes(String)

Seleciona uma lista de nós que correspondem à expressão XPath.Selects a list of nodes matching the XPath expression.

(Herdado de XmlNode)
SelectNodes(String, XmlNamespaceManager)

Seleciona uma lista de nós que correspondem à expressão XPath.Selects a list of nodes matching the XPath expression. Todos os prefixos encontrados na expressão XPath são resolvidos usando o XmlNamespaceManager fornecido.Any prefixes found in the XPath expression are resolved using the supplied XmlNamespaceManager.

(Herdado de XmlNode)
SelectSingleNode(String)

Seleciona o primeiro XmlNode que corresponde à expressão XPath.Selects the first XmlNode that matches the XPath expression.

(Herdado de XmlNode)
SelectSingleNode(String, XmlNamespaceManager)

Seleciona o primeiro XmlNode que corresponde à expressão XPath.Selects the first XmlNode that matches the XPath expression. Todos os prefixos encontrados na expressão XPath são resolvidos usando o XmlNamespaceManager fornecido.Any prefixes found in the XPath expression are resolved using the supplied XmlNamespaceManager.

(Herdado de XmlNode)
Supports(String, String)

Testa se a implementação do DOM implementa um recurso específico.Tests if the DOM implementation implements a specific feature.

(Herdado de XmlNode)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
Validate(ValidationEventHandler)

Valida o XmlDocument em relação aos esquemas XSD (Linguagem de Definição de Esquema XML) contidos na propriedade Schemas.Validates the XmlDocument against the XML Schema Definition Language (XSD) schemas contained in the Schemas property.

(Herdado de XmlDocument)
Validate(ValidationEventHandler, XmlNode)

Valida o objeto XmlNode especificado para os esquemas de XSD (Linguagem de Definição de Esquema XML) contidos na propriedade Schemas.Validates the XmlNode object specified against the XML Schema Definition Language (XSD) schemas in the Schemas property.

(Herdado de XmlDocument)
WriteContentTo(XmlWriter)

Salva todos os filhos do nó XmlDocument para o XmlWriter especificado.Saves all the children of the XmlDocument node to the specified XmlWriter.

(Herdado de XmlDocument)
WriteTo(XmlWriter)

Salva o nó XmlDocument no XmlWriter especificado.Saves the XmlDocument node to the specified XmlWriter.

(Herdado de XmlDocument)

Eventos

NodeChanged

Ocorre quando o Value de um nó que pertence a este documento foi alterado.Occurs when the Value of a node belonging to this document has been changed.

(Herdado de XmlDocument)
NodeChanging

Ocorre quando o Value de um nó que pertence a este documento está prestes a ser alterado.Occurs when the Value of a node belonging to this document is about to be changed.

(Herdado de XmlDocument)
NodeInserted

Ocorre quando um nó que pertence a este documento foi inserido em outro nó.Occurs when a node belonging to this document has been inserted into another node.

(Herdado de XmlDocument)
NodeInserting

Ocorre quando um nó que pertence a este documento está prestes a ser inserido em outro nó.Occurs when a node belonging to this document is about to be inserted into another node.

(Herdado de XmlDocument)
NodeRemoved

Ocorre quando um nó que pertence a este documento foi removido do pai dele.Occurs when a node belonging to this document has been removed from its parent.

(Herdado de XmlDocument)
NodeRemoving

Ocorre quando um nó que pertence a este documento está prestes a ser removido do documento.Occurs when a node belonging to this document is about to be removed from the document.

(Herdado de XmlDocument)

Implantações explícitas de interface

ICloneable.Clone()

Para obter uma descrição desse membro, confira Clone().For a description of this member, see Clone().

(Herdado de XmlNode)
IEnumerable.GetEnumerator()

Para obter uma descrição desse membro, confira GetEnumerator().For a description of this member, see GetEnumerator().

(Herdado de XmlNode)

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

CreateNavigator(XmlDocument)

Cria um novo objeto do navegador XPath para navegar no documento especificado.Creates a new XPath navigator object for navigating the specified document.

CreateNavigator(XmlDocument, XmlNode)

Cria um objeto do navegador XPath para navegar no documento especificado posicionado no nó especificado.Creates an XPath navigator object for navigating the specified document positioned on the specified node.

CreateNavigator(XmlNode)

Cria um navegador XPath para navegar no nó especificado.Creates an XPath navigator for navigating the specified node.

SelectNodes(XmlNode, String)

Seleciona uma lista de nós que correspondem à expressão XPath especificada.Selects a list of nodes matching the specified XPath expression.

SelectNodes(XmlNode, String, XmlNamespaceManager)

Seleciona uma lista de nós que correspondem à expressão XPath especificada.Selects a list of nodes matching the specified XPath expression. Todos os prefixos encontrados na expressão XPath são resolvidos usando o Gerenciador de namespace fornecido.Any prefixes found in the XPath expression are resolved using the supplied namespace manager.

SelectSingleNode(XmlNode, String)

Seleciona o primeiro nó que corresponde à expressão XPath.Selects the first node that matches the XPath expression.

SelectSingleNode(XmlNode, String, XmlNamespaceManager)

Seleciona o primeiro nó que corresponde à expressão XPath.Selects the first node that matches the XPath expression. Todos os prefixos encontrados na expressão XPath são resolvidos usando o Gerenciador de namespace fornecido.Any prefixes found in the XPath expression are resolved using the supplied namespace manager.

ToXPathNavigable(XmlNode)

Cria uma IXPathNavigable instância usada para produzir navegadores.Creates an IXPathNavigable instance used for producing navigators.

Aplica-se a