XmlTextReader.EntityHandling Właściwość

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Pobiera lub ustawia wartość określającą sposób obsługi jednostek przez czytelnika.

public:
 property System::Xml::EntityHandling EntityHandling { System::Xml::EntityHandling get(); void set(System::Xml::EntityHandling value); };

public System.Xml.EntityHandling EntityHandling { get; set; }

member this.EntityHandling : System.Xml.EntityHandling with get, set

Public Property EntityHandling As EntityHandling

Wartość właściwości

EntityHandling

Jedna z EntityHandling wartości. Jeśli nie EntityHandling zostanie określony, wartość domyślna EntityHandling.ExpandCharEntitiesto .

Uwagi

Uwaga

Począwszy od .NET Framework 2.0, zalecamy utworzenie XmlReader wystąpień przy użyciu metody , aby korzystać z XmlReader.Create nowych funkcji.

Tę właściwość można zmienić na bieżąco i będzie obowiązywać po następnym Read wywołaniu.

Gdy EntityHandling ustawiono wartość ExpandCharEntities, wartości atrybutów są tylko częściowo znormalizowane. Czytnik normalizuje każdy pojedynczy węzeł tekstowy niezależnie od zawartości sąsiednich węzłów referencyjnych jednostki.

Aby zilustrować różnicę między trybami obsługi jednostek, należy wziąć pod uwagę następujący kod XML:

<!DOCTYPE doc [<!ENTITY num "123">]>  
    <doc> &#65; &num; </doc>  

Po EntityHandling ustawieniu ExpandEntities węzła elementu "doc" zawiera jeden węzeł tekstowy z rozwiniętym tekstem jednostki:

Głębokość	Typ węzła	Nazwa	Wartość
1	Text		A 123

Gdy EntityHandling jest ustawiona wartość ExpandCharEntities, i WhitespaceHandling jest ustawiona na Significant lub All, element "doc" rozszerza jednostkę znaku i zwraca jednostkę ogólną jako węzeł:

Głębokość	Typ węzła	Nazwa	Wartość
1	Text		A
1	EntityReference	num
1	SignificantWhitespace

Zobacz też

• XmlReader