XmlTextWriter.WriteCharEntity(Char) Метод

Определение

Пространство имен:
System.Xml
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll
Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs
Исходный код:
XmlTextWriter.cs

Принудительно создает сущность символа для указанного значения символа Юникода.

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

Параметры

ch
Char

Символ Юникода, для которого создается сущность символа.

Исключения

ArgumentException

Символ находится в диапазоне символов суррогатной пары; или текст приведет к тому, 0xd800 - 0xdfffчто документ XML не хорошо сформирован.

InvalidOperationException

Значение WriteState равно Closed.

Примеры

В следующем примере метод используется WriteCharEntity для записи адреса электронной почты.

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

Комментарии

Note

Рекомендуется создавать XmlWriter экземпляры с помощью XmlWriter.Create метода и XmlWriterSettings класса, чтобы воспользоваться преимуществами новых функций.

Этот метод записывает символ Юникода в шестнадцатеричном формате ссылок на сущность.

Применяется к