XmlTextReader.WhitespaceHandling Propiedad
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica cómo se controla el espacio en blanco.
public:
property System::Xml::WhitespaceHandling WhitespaceHandling { System::Xml::WhitespaceHandling get(); void set(System::Xml::WhitespaceHandling value); };
public System.Xml.WhitespaceHandling WhitespaceHandling { get; set; }
member this.WhitespaceHandling : System.Xml.WhitespaceHandling with get, set
Public Property WhitespaceHandling As WhitespaceHandling
Uno de los valores de WhitespaceHandling. El valor predeterminado es WhitespaceHandling.All
(devuelve los nodos Whitespace
y SignificantWhitespace
).
Se ha especificado un valor no válido.
Esta propiedad se establece cuando el lector está cerrado (ReadState es ReadState.Closed
).
En el ejemplo siguiente se lee un fragmento XML.
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
void ReadXML( XmlParserContext^ context, String^ xmlFrag, WhitespaceHandling ws )
{
//Create the reader and specify the WhitespaceHandling setting.
XmlTextReader^ reader = gcnew XmlTextReader( xmlFrag,XmlNodeType::Element,context );
reader->WhitespaceHandling = ws;
//Parse the XML and display each of the nodes.
while ( reader->Read() )
{
switch ( reader->NodeType )
{
case XmlNodeType::Element:
Console::WriteLine( "{0}: <{1}>", reader->NodeType, reader->Name );
break;
case XmlNodeType::Text:
Console::WriteLine( "{0}: {1}", reader->NodeType, reader->Value );
break;
case XmlNodeType::EndElement:
Console::WriteLine( "{0}: </{1}>", reader->NodeType, reader->Name );
break;
case XmlNodeType::Whitespace:
Console::WriteLine( "{0}:", reader->NodeType );
break;
case XmlNodeType::SignificantWhitespace:
Console::WriteLine( "{0}:", reader->NodeType );
break;
}
}
//Close the reader.
reader->Close();
}
int main()
{
//Create the XML fragment to be parsed.
String^ xmlFrag = "<book> "
" <title>Pride And Prejudice</title>"
" <genre>novel</genre>"
"</book>";
//Create the XmlNamespaceManager.
NameTable^ nt = gcnew NameTable;
XmlNamespaceManager^ nsmgr = gcnew XmlNamespaceManager( nt );
//Create the XmlParserContext.
XmlParserContext^ context = gcnew XmlParserContext( nullptr,nsmgr,nullptr,XmlSpace::Default );
Console::WriteLine( "Read the XML and ignore all white space..." );
ReadXML( context, xmlFrag, WhitespaceHandling::None );
Console::WriteLine( "\r\nRead the XML including white space nodes..." );
ReadXML( context, xmlFrag, WhitespaceHandling::All );
}
using System;
using System.IO;
using System.Xml;
public class Sample
{
public static void Main(){
//Create the XML fragment to be parsed.
string xmlFrag ="<book> " +
" <title>Pride And Prejudice</title>" +
" <genre>novel</genre>" +
"</book>";
//Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
//Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.Default);
Console.WriteLine("Read the XML and ignore all white space...");
ReadXML(context, xmlFrag, WhitespaceHandling.None);
Console.WriteLine("\r\nRead the XML including white space nodes...");
ReadXML(context, xmlFrag, WhitespaceHandling.All);
}
public static void ReadXML(XmlParserContext context, string xmlFrag, WhitespaceHandling ws){
//Create the reader and specify the WhitespaceHandling setting.
XmlTextReader reader = new XmlTextReader(xmlFrag, XmlNodeType.Element, context);
reader.WhitespaceHandling = ws;
//Parse the XML and display each of the nodes.
while (reader.Read())
{
switch (reader.NodeType)
{
case XmlNodeType.Element:
Console.WriteLine("{0}: <{1}>", reader.NodeType, reader.Name);
break;
case XmlNodeType.Text:
Console.WriteLine("{0}: {1}", reader.NodeType, reader.Value);
break;
case XmlNodeType.EndElement:
Console.WriteLine("{0}: </{1}>", reader.NodeType, reader.Name);
break;
case XmlNodeType.Whitespace:
Console.WriteLine("{0}:", reader.NodeType);
break;
case XmlNodeType.SignificantWhitespace:
Console.WriteLine("{0}:", reader.NodeType);
break;
}
}
//Close the reader.
reader.Close();
}
} // End class
Imports System.IO
Imports System.Xml
public class Sample
public shared sub Main()
'Create the XML fragment to be parsed.
Dim xmlFrag as string ="<book> " & _
" <title>Pride And Prejudice</title>" & _
" <genre>novel</genre>" & _
"</book>"
'Create the XmlNamespaceManager.
Dim nt as NameTable = new NameTable()
Dim nsmgr as XmlNamespaceManager = new XmlNamespaceManager(nt)
'Create the XmlParserContext.
Dim context as XmlParserContext = new XmlParserContext(nothing, nsmgr, nothing, XmlSpace.Default)
Console.WriteLine("Read the XML and ignore all white space...")
ReadXML(context, xmlFrag, WhitespaceHandling.None)
Console.WriteLine()
Console.WriteLine("Read the XML including white space nodes...")
ReadXML(context, xmlFrag, WhitespaceHandling.All)
end sub
public shared sub ReadXML(context as XmlParserContext, xmlFrag as string, ws as WhitespaceHandling)
'Create the reader and specify the WhitespaceHandling setting.
Dim reader as XmlTextReader = new XmlTextReader(xmlFrag, XmlNodeType.Element, context)
reader.WhitespaceHandling = ws
'Parse the XML and display each of the nodes.
while (reader.Read())
select case reader.NodeType
case XmlNodeType.Element:
Console.WriteLine("{0}: <{1}>", reader.NodeType, reader.Name)
case XmlNodeType.Text:
Console.WriteLine("{0}: {1}", reader.NodeType, reader.Value)
case XmlNodeType.EndElement:
Console.WriteLine("{0}: </{1}>", reader.NodeType, reader.Name)
case XmlNodeType.Whitespace:
Console.WriteLine("{0}:", reader.NodeType)
case XmlNodeType.SignificantWhitespace:
Console.WriteLine("{0}:", reader.NodeType)
end select
end while
'Close the reader.
reader.Close()
end sub
end class
Nota
A partir de .NET Framework 2.0, se recomienda crear XmlReader instancias mediante el XmlReader.Create método para aprovechar las nuevas funcionalidades.
Esta propiedad se puede cambiar en cualquier momento y surte efecto en la siguiente operación de lectura.
XmlTextReader
Dado que no tiene información de DTD disponible, SignificantWhitespace
los nodos solo se devuelven dentro de un xml:space='preserve'
ámbito.
Producto | Versiones |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: