Udostępnij za pośrednictwem


XmlTextReader.EntityHandling Właściwość

Definicja

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

Dotyczy

Zobacz też