Freigeben über


XmlNameTable-Klasse

Tabelle atomisierter Zeichenfolgenobjekte.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public MustInherit Class XmlNameTable
'Usage
Dim instance As XmlNameTable
public abstract class XmlNameTable
public ref class XmlNameTable abstract
public abstract class XmlNameTable
public abstract class XmlNameTable

Hinweise

Verschiedene Klassen, z. B. XmlDocument und XmlReader, verwenden die XmlNameTable-Klasse intern zum Speichern von Attribut- und Elementnamen. Wenn ein Element- oder Attributname in einem XML-Dokument mehrfach auftritt, wird er in der XmlNameTable nur einmal gespeichert.

Die Namen werden als Objekttypen der CLR (Common Language Runtime) gespeichert. Dadurch können Sie statt eines aufwendigeren Zeichenfolgenvergleichs Objektvergleiche an diesen Zeichenfolgen durchführen. Diese Zeichenfolgenobjekte werden als atomizedstrings bezeichnet.

XmlNameTable wird in der NameTable-Klasse implementiert.

Beispiel

Im folgenden Beispiel werden zwei Elementnamen verglichen.

' 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()
// 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();     

Vererbungshierarchie

System.Object
  System.Xml.XmlNameTable
     System.Xml.NameTable

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlNameTable-Member
System.Xml-Namespace
NameTable-Klasse