XmlTextWriter.WriteCharEntity(Char) Método

Definición

Espacio de nombres:
System.Xml
Ensamblados:
netstandard.dll, System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll
Source:
XmlTextWriter.cs
Source:
XmlTextWriter.cs
Source:
XmlTextWriter.cs
Source:
XmlTextWriter.cs
Source:
XmlTextWriter.cs

Fuerza la generación de una entidad de caracteres para el valor de carácter Unicode especificado.

public:
 override void WriteCharEntity(char ch);
public override void WriteCharEntity(char ch);
override this.WriteCharEntity : char -> unit
Public Overrides Sub WriteCharEntity (ch As Char)

Parámetros

ch
Char

Carácter Unicode para el que se va a generar una entidad de caracteres.

Excepciones

ArgumentException

El carácter está en el intervalo de caracteres del par suplente; 0xd800 - 0xdfffo el texto daría como resultado un documento XML no bien formado.

InvalidOperationException

El WriteState es Closed.

Ejemplos

En el ejemplo siguiente se usa el WriteCharEntity método para escribir una dirección de correo electrónico.

using System;
using System.Xml;

public class Sample {

  public static void Main() {

    XmlTextWriter writer = null;

      try {

        writer = new XmlTextWriter (Console.Out);

        // Write an element.
        writer.WriteStartElement("address");

        // Write an email address using entities
        // for the @ and . characters.
        writer.WriteString("someone");
        writer.WriteCharEntity('@');
        writer.WriteString("example");
        writer.WriteCharEntity('.');
        writer.WriteString("com");
        writer.WriteEndElement();
    }

    finally {
      // Close the writer.
      if (writer != null)
        writer.Close();
    }
  }
}

Imports System.Xml

Public Class Sample 
 
    Public Shared Sub Main() 
   
        Dim writer As XmlTextWriter = Nothing

        Try 

            writer = new XmlTextWriter(Console.Out)

            ' Write an element.
            writer.WriteStartElement("address")
     
            ' Write an email address using entities
            ' for the @ and . characters.
            writer.WriteString("someone")
            writer.WriteCharEntity("@"c)
            writer.WriteString("example")
            writer.WriteCharEntity("."c)
            writer.WriteString("com")
            writer.WriteEndElement()        
 
        Finally
            ' Close the writer.
            If writer IsNot Nothing
                writer.Close()
            End If
        End Try

    End Sub
End Class

Comentarios

Note

Se recomienda crear XmlWriter instancias mediante el XmlWriter.Create método y la XmlWriterSettings clase para aprovechar las nuevas funcionalidades.

Este método escribe el carácter Unicode en formato de referencia de entidad de caracteres hexadecimales.

Se aplica a