NameTable 類別

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

NameTable.cs

實作單一執行緒的 XmlNameTable。

public ref class NameTable : System::Xml::XmlNameTable

public class NameTable : System.Xml.XmlNameTable

type NameTable = class
    inherit XmlNameTable

Public Class NameTable
Inherits XmlNameTable

繼承

Object

XmlNameTable

NameTable

範例

下列範例會比較兩個元素名稱。

NameTable nt = new NameTable();
object book = nt.Add("book");
object price = nt.Add("price");

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

reader.MoveToContent();
reader.ReadToDescendant("book");

 if (System.Object.ReferenceEquals(book, reader.Name)) {
     // Do additional processing.
 }

   Dim nt As NameTable  = New NameTable()
   Dim book As object = nt.Add("book")
   Dim price As object = nt.Add("price")

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

   reader.MoveToContent()
   reader.ReadToDescendant("book")

    If (System.Object.ReferenceEquals(book, reader.Name)) 
        ' Do additional processing.
    End If

備註

數個類別，例如 XmlDocument 和 XmlReader ，會在 NameTable 內部使用 類別來儲存屬性和元素名稱。 當項目或屬性名稱在 XML 文件中出現多次時，它只會在 NameTable 中儲存一次。

這些名稱會儲存為 Common Language Runtime (CLR) 物件型別。 這可讓您對這些字串進行物件比較，而不需要更耗費資源的字串比較。 這些字串物件稱為不可部分完成的字串。

建構函式

名稱	Description
NameTable()	初始化 NameTable 類別的新執行個體。

方法

名稱	Description
Add(Char[], Int32, Int32)	將指定的字串原子化，並將其加入至 NameTable。
Add(String)	將指定的字串原子化，並將其加入至 NameTable。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Get(Char[], Int32, Int32)	取得包含與指定陣列中指定字元範圍內的字元相同的字串。
Get(String)	取得具有指定值的原子化字串。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)