XmlNameTable Classe

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Tabela de objetos atomizados de cadeia de caracteres.

public ref class XmlNameTable abstract

public abstract class XmlNameTable

type XmlNameTable = class

Public MustInherit Class XmlNameTable

Herança

Object

XmlNameTable

Derivado

System.Xml.NameTable

Exemplos

O exemplo a seguir compara dois nomes de elemento.

// Add the element names to the NameTable.
NameTable nt = new NameTable();
object book = nt.Add("book");
object title = nt.Add("title");

 // Create a reader that uses the NameTable.
 XmlReaderSettings settings = new XmlReaderSettings();
 settings.NameTable = nt;
 XmlReader reader = XmlReader.Create("books.xml", settings);

 while (reader.Read()) {
    if (reader.NodeType == XmlNodeType.Element) {
      // Cache the local name to prevent multiple calls to the LocalName property.
      object localname = reader.LocalName;

      // Do a comparison between the object references. This just compares pointers.
      if (book == localname) {
          // Add additional processing here.
      }
      // Do a comparison between the object references. This just compares pointers.
      if (title == localname) {
         // Add additional processing here.
      }
    }
 }  // End While

// Close the reader.
reader.Close();

' Add the element names to the NameTable.
Dim nt As New NameTable()
Dim book As Object = nt.Add("book")
Dim title As Object = nt.Add("title")

' Create a reader that uses the NameTable.
Dim settings As New XmlReaderSettings()
settings.NameTable = nt
Dim reader As XmlReader = XmlReader.Create("books.xml", settings)

While reader.Read()
    If reader.NodeType = XmlNodeType.Element Then
        ' Cache the local name to prevent multiple calls to the LocalName property.
        Dim localname As Object = reader.LocalName
        
        ' Do a comparison between the object references. This just compares pointers.
        If book Is localname Then
           ' Add additional processing here.
        End If 
        ' Do a comparison between the object references. This just compares pointers.
        If title Is localname Then
           ' Add additional processing here.
        End If 
    End If
End While 

' Close the reader.
reader.Close()

Comentários

Várias classes, como XmlDocument e XmlReader, usam a XmlNameTable classe internamente para armazenar nomes de atributo e elemento. Quando um elemento ou nome de atributo ocorre várias vezes em um documento XML, ele é armazenado apenas uma vez no XmlNameTable.

Os nomes são armazenados como tipos de objeto CLR (Common Language Runtime). Isso permite que você faça comparações de objeto nessas cadeias de caracteres em vez de uma comparação de cadeia de caracteres mais cara. Esses objetos de cadeia de caracteres são chamados de "cadeias de caracteres atomizadas".

XmlNameTable é implementado na NameTable classe.

Construtores

XmlNameTable()

Inicializa uma nova instância da classe XmlNameTable.

Métodos

Add(Char[], Int32, Int32)	Quando substituído em uma classe derivada, atomiza a cadeia de caracteres especificada e adiciona-o ao XmlNameTable.
Add(String)	Quando substituído em uma classe derivada, atomiza a cadeia de caracteres especificada e adiciona-o ao XmlNameTable.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Get(Char[], Int32, Int32)	Quando substituído em uma classe derivada, obtém a cadeia de caracteres atomizada que contém os mesmos caracteres que o intervalo especificado de caracteres na matriz fornecida.
Get(String)	Quando substituído em uma classe derivada, obtém a cadeia de caracteres atomizada que contém o mesmo valor daquela especificada.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• NameTable