XmlTextReader 類別

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

來源:

XmlTextReader.cs

表示提供快速、非快取、順向 (Forward-only) 存取 XML 資料的讀取器 (Reader)。

從 .NET Framework 2.0 開始，建議您改用 XmlReader 類別。

public ref class XmlTextReader : System::Xml::XmlReader, System::Xml::IXmlLineInfo, System::Xml::IXmlNamespaceResolver

public class XmlTextReader : System.Xml.XmlReader, System.Xml.IXmlLineInfo, System.Xml.IXmlNamespaceResolver

type XmlTextReader = class
    inherit XmlReader
    interface IXmlLineInfo
    interface IXmlNamespaceResolver

Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo, IXmlNamespaceResolver

繼承

Object

XmlReader

XmlTextReader

實作

IXmlLineInfo IXmlNamespaceResolver

備註

如需此 API 的詳細資訊，請參閱 XmlTextReader 的補充 API 備註。

給繼承者的注意事項

這個類別具有繼承需求。 需要完全信任才能繼承自 XmlTextReader。

建構函式

XmlTextReader()	初始化 XmlTextReader 的新執行個體。
XmlTextReader(Stream)	使用指定的資料流初始化 XmlTextReader 類別的新執行個體。
XmlTextReader(Stream, XmlNameTable)	使用指定的資料流和 XmlNameTable，初始化 XmlTextReader 類別的新執行個體。
XmlTextReader(Stream, XmlNodeType, XmlParserContext)	使用指定的資料流、XmlNodeType 和 XmlParserContext，初始化 XmlTextReader 類別的新執行個體。
XmlTextReader(String)	使用指定的檔案，初始化 XmlTextReader 類別的新執行個體。
XmlTextReader(String, Stream)	使用指定的 URL 和資料流，初始化 XmlTextReader 類別的新執行個體。
XmlTextReader(String, Stream, XmlNameTable)	使用指定的 URL、資料流和 XmlNameTable，初始化 XmlTextReader 類別的新執行個體。
XmlTextReader(String, TextReader)	使用指定的 URL 和 TextReader，初始化 XmlTextReader 類別的新執行個體。
XmlTextReader(String, TextReader, XmlNameTable)	使用指定的 URL、XmlTextReader 和 TextReader，初始化 XmlNameTable 類別的新執行個體。
XmlTextReader(String, XmlNameTable)	使用指定的檔案和 XmlNameTable，初始化 XmlTextReader 類別的新執行個體。
XmlTextReader(String, XmlNodeType, XmlParserContext)	使用指定的字串、XmlNodeType 和 XmlParserContext，初始化 XmlTextReader 類別的新執行個體。
XmlTextReader(TextReader)	使用指定的 XmlTextReader 初始化 TextReader 類別的新執行個體。
XmlTextReader(TextReader, XmlNameTable)	使用指定的 XmlTextReader 和 TextReader，初始化 XmlNameTable 類別的新執行個體。
XmlTextReader(XmlNameTable)	使用指定的 XmlTextReader 初始化 XmlNameTable 類別的新執行個體。

屬性

AttributeCount	取得目前節點的屬性數目。
BaseURI	取得目前節點的基底 (Base) URI。
CanReadBinaryContent	取得值，這個值表示 XmlTextReader 是否會實作二進位內容讀取方法。
CanReadValueChunk	取得值，表示 XmlTextReader 是否會實作 ReadValueChunk(Char[], Int32, Int32) 方法。
CanResolveEntity	取得值，指出這個讀取器是否可以剖析和解析實體。
Depth	取得 XML 文件中目前節點的深度。
DtdProcessing	取得或設定 DtdProcessing 列舉。
Encoding	取得文件的編碼方式。
EntityHandling	取得或設定值，表示讀取器如何處理實體。
EOF	取得值，表示讀取器是否位於資料流結尾。
HasAttributes	取得值，表示目前節點是否具有任何屬性。 (繼承來源 XmlReader)
HasValue	取得值，表示目前的節點是否可以具有 String.Empty 之外的其他 Value。
IsDefault	取得值，表示目前節點是否是產生自 DTD 或結構描述中定義之預設值的屬性。
IsEmptyElement	取得值，指出目前節點是否為空白元素 (，例如) <MyElement/> 。
Item[Int32]	在衍生類別中覆寫時，取得具有指定索引的屬性值。 (繼承來源 XmlReader)
Item[String, String]	在衍生類別中覆寫時，取得具有指定 LocalName 與 NamespaceURI 的屬性值。 (繼承來源 XmlReader)
Item[String]	在衍生類別中覆寫時，取得具有指定 Name 的屬性值。 (繼承來源 XmlReader)
LineNumber	取得目前的行號。
LinePosition	取得目前的行位置。
LocalName	取得目前節點的區域名稱。
Name	取得目前節點的限定名稱 (Qualified Name)。
Namespaces	取得或設定值，指出是否支援命名空間。
NamespaceURI	取得讀取器所在節點的命名空間 URI (如 W3C 命名空間規格中所定義)。
NameTable	取得與這個實作關聯的 XmlNameTable。
NodeType	取得目前節點的類型。
Normalization	取得或設定值，指示是否將空白字元與屬性值正常化。
Prefix	取得與目前節點相關聯的命名空間前置詞。
ProhibitDtd	已淘汰. 取得或設定值，指出是否允許 DTD 處理。 這個屬性已經過時。 請改用 DtdProcessing。
QuoteChar	取得用來括住屬性節點值的引號字元。
ReadState	取得讀取器的狀態。
SchemaInfo	取得在結構描述驗證之後已指派給目前節點的結構描述資訊。 (繼承來源 XmlReader)
Settings	取得 XmlReaderSettings 物件，用於建立這個 XmlReader 執行個體。 (繼承來源 XmlReader)
Value	取得目前節點的文字值。
ValueType	取得目前節點的 Common Language Runtime (CLR) 型別。 (繼承來源 XmlReader)
WhitespaceHandling	取得或設定值，指定如何處理空白字元。
XmlLang	取得目前的 xml:lang 範圍。
XmlResolver	設定用來解析 DTD 參考的 XmlResolver。
XmlSpace	取得目前的 xml:space 範圍。

方法

Close()	將 ReadState 變更為 Closed。
Dispose()	釋放 XmlReader 類別目前的執行個體所使用的全部資源。 (繼承來源 XmlReader)
Dispose(Boolean)	釋放 XmlReader 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 XmlReader)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetAttribute(Int32)	取得具有指定索引的屬性值。
GetAttribute(String)	取得具有指定名稱的屬性值。
GetAttribute(String, String)	取得具有指定的區域名稱和命名空間 URI 的屬性值。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetNamespacesInScope(XmlNamespaceScope)	取得集合，包含目前範圍內的所有命名空間。
GetRemainder()	取得已緩衝之 XML 的其他部分。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetValueAsync()	非同步取得目前節點的值。 (繼承來源 XmlReader)
HasLineInfo()	取得值，這個值指出類別是否可以傳回行資訊。
IsStartElement()	呼叫 MoveToContent() 並測試目前的內容節點為開頭標記或空白項目標記。 (繼承來源 XmlReader)
IsStartElement(String)	呼叫 MoveToContent() 並測試目前的內容節點為開頭標記或空白項目標記，以及所找到項目的 Name 屬性是否符合指定的引數。 (繼承來源 XmlReader)
IsStartElement(String, String)	呼叫 MoveToContent() 並測試目前的內容節點為開頭標記或空白項目標記，以及所找到項目的 LocalName 與 NamespaceURI 屬性是否符合指定的字串。 (繼承來源 XmlReader)
LookupNamespace(String)	解析目前項目範圍中的命名空間前置詞。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MoveToAttribute(Int32)	移至具有指定索引的屬性。
MoveToAttribute(String)	移至具有指定名稱的屬性。
MoveToAttribute(String, String)	移至具有指定的區域名稱和命名空間 URI 的屬性。
MoveToContent()	檢查目前節點是否為內容 (非空白字元文字、CDATA、Element、EndElement、EntityReference 或 EndEntity) 節點。 如果節點並非內容節點，讀取器會先跳至下一個內容節點或檔案結尾。 它會略過下列型別的節點：ProcessingInstruction、DocumentType、Comment、Whitespace 或 SignificantWhitespace。 (繼承來源 XmlReader)
MoveToContentAsync()	非同步檢查目前節點是否為內容節點。 如果節點並非內容節點，讀取器會先跳至下一個內容節點或檔案結尾。 (繼承來源 XmlReader)
MoveToElement()	移至包含目前屬性節點的項目。
MoveToFirstAttribute()	移至第一個屬性。
MoveToNextAttribute()	移至下一個屬性。
Read()	從資料流讀取下一個節點。
ReadAsync()	非同步讀取資料流中的下一個節點。 (繼承來源 XmlReader)
ReadAttributeValue()	將屬性值剖析成一或多個 Text、EntityReference 或 EndEntity 節點。
ReadBase64(Byte[], Int32, Int32)	解碼 Base64 並傳回已解碼的二進位位元組。
ReadBinHex(Byte[], Int32, Int32)	解碼 BinHex 並傳回已解碼的二進位位元組。
ReadChars(Char[], Int32, Int32)	將項目的文字內容讀入字元緩衝區中。 這個方法設計可藉由連續呼叫來讀取內嵌文字的大量資料流。
ReadContentAs(Type, IXmlNamespaceResolver)	以指定型别的物件形式讀取內容。 (繼承來源 XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)	以非同步的方式讀取做為指定型别之物件的內容。 (繼承來源 XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)	讀取內容，並傳回 Base64 已解碼的二進位位元組。
ReadContentAsBase64Async(Byte[], Int32, Int32)	以非同步的方式讀取內容，並傳回 Base64 已解碼的二進位位元組。 (繼承來源 XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	讀取內容，並傳回 BinHex 已解碼的二進位位元組。
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	以非同步的方式讀取內容，並傳回 BinHex 的解碼二進位位元組。 (繼承來源 XmlReader)
ReadContentAsBoolean()	以 Boolean 的形式，讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsDateTime()	以 DateTime 物件的形式，讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsDateTimeOffset()	以 DateTimeOffset 物件的形式，讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsDecimal()	以 Decimal 物件的形式，讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsDouble()	以雙精確度浮點數的形式讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsFloat()	以單精確度浮點數的形式讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsInt()	以 32 位元帶正負號之整數的形式讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsLong()	以 64 位元帶正負號之整數的形式讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsObject()	以 Object 的形式，讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsObjectAsync()	以非同步方式與 Object 的形式，讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsString()	以 String 物件的形式，讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadContentAsStringAsync()	以非同步方式與 String 物件的形式，讀取目前位置的文字內容。 (繼承來源 XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	以要求之型別的形式讀取項目內容。 (繼承來源 XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以要求之型別的形式讀取項目內容。 (繼承來源 XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	以要求之型別的形式，非同步讀取項目內容。 (繼承來源 XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	讀取項目，並將 Base64 內容解碼。
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	以非同步的方式讀取項目，並將 Base64 內容解碼。 (繼承來源 XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)	讀取項目，並將 BinHex 內容解碼。
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	以非同步的方式讀取項目，並將 BinHex 內容解碼。 (繼承來源 XmlReader)
ReadElementContentAsBoolean()	以 Boolean 物件的形式，讀取目前項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsBoolean(String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以 Boolean 物件的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsDateTime()	以 DateTime 物件的形式，讀取目前項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsDateTime(String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以 DateTime 物件的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsDecimal()	以 Decimal 物件的形式，讀取目前項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsDecimal(String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以 Decimal 物件的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsDouble()	以雙精確度浮點數的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsDouble(String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以雙精確度浮點數的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsFloat()	以單精確度浮點數的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsFloat(String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以單精確度浮點數的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsInt()	以 32 位元帶正負號之整數的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsInt(String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以 32 位元帶正負號之整數的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsLong()	以 64 位元帶正負號之整數的形式讀取目前的元素並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsLong(String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以 64 位元帶正負號之整數的形式讀取目前的元素並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsObject()	以 Object 的形式，讀取目前項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsObject(String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以 Object 的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsObjectAsync()	以非同步方式與 Object 的形式，讀取目前項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsString()	以 String 物件的形式，讀取目前項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsString(String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以 String 物件的形式，讀取目前的項目並傳回內容。 (繼承來源 XmlReader)
ReadElementContentAsStringAsync()	以非同步方式與 String 物件的形式，讀取目前項目並傳回內容。 (繼承來源 XmlReader)
ReadElementString()	讀取純文字項目。 不過，我們建議您改用ReadElementContentAsString()方法相反地，因為它會提供較簡單的方式來處理這項作業。 (繼承來源 XmlReader)
ReadElementString(String)	檢查Name屬性找到的項目之前讀取純文字的項目符合指定的字串。 不過，我們建議您改用ReadElementContentAsString()方法相反地，因為它會提供較簡單的方式來處理這項作業。 (繼承來源 XmlReader)
ReadElementString(String, String)	檢查LocalName和NamespaceURI項目的屬性找到符合的指定的字串之前讀取純文字的項目。 不過，我們建議您改用ReadElementContentAsString(String, String)方法相反地，因為它會提供較簡單的方式來處理這項作業。 (繼承來源 XmlReader)
ReadEndElement()	檢查目前節點為結尾標記，並使讀取器前進至下一個節點。 (繼承來源 XmlReader)
ReadInnerXml()	在衍生類別中覆寫時，將所有的內容當做字串讀取，包括標記。 (繼承來源 XmlReader)
ReadInnerXmlAsync()	以字串形式非同步讀取所有內容，包括標記。 (繼承來源 XmlReader)
ReadOuterXml()	在衍生類別中覆寫時，讀取代表這個節點及其所有子節點的內容，包括標記。 (繼承來源 XmlReader)
ReadOuterXmlAsync()	非同步讀取表示這個節點及其所有子系的內容，包括標記。 (繼承來源 XmlReader)
ReadStartElement()	檢查以確定目前節點為項目，然後使讀取器前進至下一個節點。 (繼承來源 XmlReader)
ReadStartElement(String)	檢查目前的內容節點是否具有的項目指定Name並使讀取器前進至下一個節點。 (繼承來源 XmlReader)
ReadStartElement(String, String)	檢查目前的內容節點是否具有的項目指定LocalName和NamespaceURI並使讀取器前進至下一個節點。 (繼承來源 XmlReader)
ReadString()	將項目或文字節點的內容當做字串讀取。
ReadSubtree()	傳回新XmlReader可以用來讀取目前的節點及其所有子系的執行個體。 (繼承來源 XmlReader)
ReadToDescendant(String)	往前推進XmlReader下一個子系的項目，具有指定限定名稱。 (繼承來源 XmlReader)
ReadToDescendant(String, String)	往前推進XmlReader下一個子系的項目，使用指定的區域名稱和命名空間 URI。 (繼承來源 XmlReader)
ReadToFollowing(String)	在找到具有指定限定名稱的項目之前讀取。 (繼承來源 XmlReader)
ReadToFollowing(String, String)	在找到具有指定區域名稱和命名空間 URI 的項目之前讀取。 (繼承來源 XmlReader)
ReadToNextSibling(String)	往前推進XmlReader指定限定名稱的下一個同層級項目。 (繼承來源 XmlReader)
ReadToNextSibling(String, String)	將 XmlReader 前移到下一個具有指定區域名稱和命名空間 URI 的同層級項目。 (繼承來源 XmlReader)
ReadValueChunk(Char[], Int32, Int32)	讀取 XML 文件中內嵌之大量文字資料流。 (繼承來源 XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	以非同步的方式讀取 XML 文件中內嵌之大量文字資料流。 (繼承來源 XmlReader)
ResetState()	將讀取器的狀態重設為 ReadState.Initial。
ResolveEntity()	解析 EntityReference 節點的實體參考。
Skip()	略過目前節點的子節點。
SkipAsync()	以非同步的方式略過目前節點的子節點。 (繼承來源 XmlReader)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	如需這個成員的說明，請參閱 GetNamespacesInScope(XmlNamespaceScope)。
IXmlNamespaceResolver.LookupNamespace(String)	如需這個成員的說明，請參閱 LookupNamespace(String)。
IXmlNamespaceResolver.LookupPrefix(String)	如需這個成員的說明，請參閱 LookupPrefix(String)。

另請參閱

• XML 文件和資料