XmlReader.Value Proprietà

Definizione

Spazio dei nomi:

System.Xml

Assembly:

netstandard.dll, System.Xml.ReaderWriter.dll

Origine:

XmlReader.cs

Quando ne viene eseguito l'override in una classe derivata, ottiene il valore del testo del nodo corrente.

C#

public abstract string Value { get; }

Valore della proprietà

String

Il valore restituito dipende dalla proprietà NodeType del nodo. La tabella seguente elenca i tipi di nodo che hanno un valore da restituire. Tutti gli altri tipi di nodo restituiscono String.Empty.

Tipo di nodo	Valore
Attribute	Valore dell'attributo.
CDATA	Contenuto della sezione CDATA.
Comment	Contenuto del commento.
DocumentType	Sottoinsieme interno.
ProcessingInstruction	Intero contenuto, esclusa la destinazione.
SignificantWhitespace	Spazio vuoto tra markup in un modello con contenuto misto.
Text	Contenuto del nodo di tipo text.
Whitespace	Spazio vuoto tra markup.
XmlDeclaration	Contenuto della dichiarazione.

Eccezioni

InvalidOperationException

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Esempio

Nell'esempio seguente viene letto un file XML e vengono visualizzati ognuno dei nodi.

C#

XmlReaderSettings settings = new XmlReaderSettings();
settings.DtdProcessing = DtdProcessing.Parse;
XmlReader reader = XmlReader.Create("items.xml", settings);

reader.MoveToContent();
  // Parse the file and display each of the nodes.
  while (reader.Read()) {
    switch (reader.NodeType) {
      case XmlNodeType.Element:
          Console.Write("<{0}>", reader.Name);
          break;
      case XmlNodeType.Text:
          Console.Write(reader.Value);
          break;
       case XmlNodeType.CDATA:
           Console.Write("<![CDATA[{0}]]>", reader.Value);
           break;
       case XmlNodeType.ProcessingInstruction:
           Console.Write("<?{0} {1}?>", reader.Name, reader.Value);
           break;
       case XmlNodeType.Comment:
           Console.Write("<!--{0}-->", reader.Value);
           break;
       case XmlNodeType.XmlDeclaration:
           Console.Write("<?xml version='1.0'?>");
           break;
       case XmlNodeType.Document:
           break;
       case XmlNodeType.DocumentType:
           Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);
           break;
       case XmlNodeType.EntityReference:
           Console.Write(reader.Name);
           break;
       case XmlNodeType.EndElement:
           Console.Write("</{0}>", reader.Name);
           break;
   }
}

L'esempio usa il items.xml file.

XML

<?xml version="1.0"?>
<!-- This is a sample XML document -->
<!DOCTYPE Items [<!ENTITY number "123">]>
<Items>
  <Item>Test with an entity: &number;</Item>
  <Item>Test with a child element <more/> stuff</Item>
  <Item>Test with a CDATA section <![CDATA[<456>]]> def</Item>
  <Item>Test with a char entity: A</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>

Commenti

Per la versione asincrona di questa proprietà, vedere il GetValueAsync metodo .

Si applica a