XmlReader.Value XmlReader.Value XmlReader.Value XmlReader.Value Property

Definición

Cuando se invalida en una clase derivada, obtiene el valor de texto del nodo actual.When overridden in a derived class, gets the text value of the current node.

public:
 abstract property System::String ^ Value { System::String ^ get(); };
public abstract string Value { get; }
member this.Value : string
Public MustOverride ReadOnly Property Value As String

Valor de propiedad

El valor devuelto depende de la propiedad NodeType del nodo:The value returned depends on the NodeType of the node. En la siguiente tabla se recogen los tipos de nodo que tienen un valor para devolver.The following table lists node types that have a value to return. Todos los demás tipos de nodo devuelven String.Empty.All other node types return String.Empty.

Tipo de nodoNode type ValorValue
Attribute El valor del atributo.The value of the attribute.
CDATA Contenido de la sección CDATA.The content of the CDATA section.
Comment El contenido del comentario.The content of the comment.
DocumentType El subconjunto interno.The internal subset.
ProcessingInstruction El contenido completo, sin incluir el destino.The entire content, excluding the target.
SignificantWhitespace Espacio en blanco entre marcas en un modelo de contenido mixto.The white space between markup in a mixed content model.
Text El contenido del nodo de texto.The content of the text node.
Whitespace El espacio en blanco entre marcado.The white space between markup.
XmlDeclaration El contenido de la declaración.The content of the declaration.

Excepciones

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Ejemplos

En el ejemplo siguiente se lee un archivo XML y se muestra cada uno de los nodos.The following example reads an XML file and displays each of the nodes.

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;
   } 
}
Dim settings As New XmlReaderSettings()
settings.DtdProcessing = DtdProcessing.Parse
Dim reader As XmlReader = XmlReader.Create("items.xml", settings)
reader.MoveToContent()
' Parse the file and display each of the nodes.
While reader.Read()
  Select Case reader.NodeType
    Case XmlNodeType.Element
      Console.Write("<{0}>", reader.Name)
    Case XmlNodeType.Text
      Console.Write(reader.Value)
    Case XmlNodeType.CDATA
      Console.Write("<![CDATA[{0}]]>", reader.Value)
    Case XmlNodeType.ProcessingInstruction
      Console.Write("<?{0} {1}?>", reader.Name, reader.Value)
    Case XmlNodeType.Comment
      Console.Write("<!--{0}-->", reader.Value)
    Case XmlNodeType.XmlDeclaration
      Console.Write("<?xml version='1.0'?>")
    Case XmlNodeType.Document
    Case XmlNodeType.DocumentType
      Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value)
    Case XmlNodeType.EntityReference
      Console.Write(reader.Name)
    Case XmlNodeType.EndElement
      Console.Write("</{0}>", reader.Name)
  End Select
End While

En el ejemplo se items.xml usa el archivo.The sample uses the items.xml file.

<?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: &#65;</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>

Comentarios

Para obtener la versión asincrónica de esta propiedad, vea el GetValueAsync método.For the asynchronous version of this property, see the GetValueAsync method.

Se aplica a