XmlValidatingReader.ReadString Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Legge il contenuto di un elemento o di un nodo di testo come stringa.
public:
override System::String ^ ReadString();public override string ReadString();override this.ReadString : unit -> stringPublic Overrides Function ReadString () As StringRestituisce
Contenuto dell'elemento o del nodo di testo. Può trattarsi di una stringa vuota se il lettore è posizionato su un elemento diverso da un elemento o un nodo di testo o se non è presente più contenuto di testo da restituire nel contesto corrente.
Commenti
Il nodo di testo può essere un elemento o un nodo di testo dell'attributo.
Annotazioni
La XmlValidatingReader classe è obsoleta in .NET Framework 2.0. È possibile creare un'istanza di convalida XmlReader usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.
Se posizionato su un elemento, ReadString concatena tutti i tipi di testo, spazi vuoti significativi, spazi vuoti e nodi di sezione CDATA insieme e restituisce i dati concatenati come contenuto dell'elemento. Il lettore si arresta quando viene rilevato un markup, inclusi i commenti e le istruzioni di elaborazione. Questo problema può verificarsi in un modello di contenuto misto o quando viene letto un tag di fine elemento.
Se posizionato in un nodo di testo, ReadString esegue la stessa concatenazione dal nodo di testo al tag di fine elemento. Se il lettore è posizionato su un nodo di testo dell'attributo, ReadString ha la stessa funzionalità di se il lettore fosse posizionato sul tag iniziale dell'elemento. Restituisce tutti i nodi di testo dell'elemento concatenati.
La EntityHandling proprietà determina il funzionamento ReadString come segue:
| Valore | Descrizione |
|---|---|
| ExpandEntities | Restituisce un carattere espanso e entità generali. Si tratta dell'impostazione predefinita. |
| ExpandCharEntities | Restituisce il contenuto di testo fino a ma non include un riferimento generale all'entità. Ciò significa che un'entità generale causa l'arresto di ReadString. È necessario chiamare Read per eseguire il passaggio del riferimento all'entità. |
