XmlTextReader.EntityHandling Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic Property EntityHandling As EntityHandlingWartość właściwości
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> A # </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 |