XmlDocument.CreateCDataSection(String) XmlDocument.CreateCDataSection(String) XmlDocument.CreateCDataSection(String) XmlDocument.CreateCDataSection(String) Method

Definición

Crea un XmlCDataSection que contiene los datos especificados.Creates an XmlCDataSection containing the specified data.

public:
 virtual System::Xml::XmlCDataSection ^ CreateCDataSection(System::String ^ data);
public virtual System.Xml.XmlCDataSection CreateCDataSection (string data);
abstract member CreateCDataSection : string -> System.Xml.XmlCDataSection
override this.CreateCDataSection : string -> System.Xml.XmlCDataSection
Public Overridable Function CreateCDataSection (data As String) As XmlCDataSection

Parámetros

data
String String String String

Contenido del nuevo objeto XmlCDataSection.The content of the new XmlCDataSection.

Devoluciones

Nuevo objeto XmlCDataSection.The new XmlCDataSection.

Ejemplos

En el ejemplo siguiente se crea un nodo CDATA y se agrega al documento.The following example creates a CDATA node and adds it to the document.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book>" );
   
   //Create a CData section.
   XmlCDataSection^ CData;
   CData = doc->CreateCDataSection( "All Jane Austen novels 25% off starting 3/23!" );
   
   //Add the new node to the document.
   XmlElement^ root = doc->DocumentElement;
   root->AppendChild( CData );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    //Create a CData section.
    XmlCDataSection CData;
    CData = doc.CreateCDataSection("All Jane Austen novels 25% off starting 3/23!");    

    //Add the new node to the document.
    XmlElement root = doc.DocumentElement;
    root.AppendChild(CData);  
        
    Console.WriteLine("Display the modified XML...");        
    doc.Save(Console.Out);
  }
}
Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>"  & _
                    "<title>Pride And Prejudice</title>"  & _
                    "</book>")
        
        'Create a CData section.
        Dim CData As XmlCDataSection
        CData = doc.CreateCDataSection("All Jane Austen novels 25% off starting 3/23!")
        
        'Add the new node to the document.
        Dim root As XmlElement = doc.DocumentElement
        root.AppendChild(CData)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Comentarios

Aunque este método crea el nuevo objeto en el contexto del documento, no agrega automáticamente el nuevo objeto al árbol del documento.Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. Para agregar el nuevo objeto, debe llamar explícitamente a uno de los métodos de inserción de nodo.To add the new object, you must explicitly call one of the node insert methods.

Según la recomendación del W3C lenguaje de marcado extensible (XML) 1,0, se permiten nodos CDataSection en nodos de elementos y en nodos EntityReference cuando el nodo EntityReference no es un elemento secundario de un nodo de atributo.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, CDataSection nodes are allowed within Element nodes and in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

Se aplica a