Click or drag to resize

RtfToHtmlHtmlSaveOptionsUseNumericCharacterReference Property

In case of 'true': Write the all characters in "NCR" notation: &#xxx;. In case of 'false': Write the all characters as Unicode (recommended). Default value: false.

Namespace: SautinSoft
Assembly: SautinSoft.RtfToHtml (in SautinSoft.RtfToHtml.dll) Version: 2024.8.23
Syntax
Copy
public bool UseNumericCharacterReference { get; set; }

Property Value

Boolean
Remarks
A numeric character reference (NCR) is a common markup construct used in SGML and other SGML-related markup languages such as HTML and XML. It consists of a short sequence of characters that, in turn, represent a single character from the Universal Character Set (UCS) of Unicode.

See details in Wikipedia ...
Example
Use Numeric Character Reference in C#
Copy
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;
using SautinSoft;

namespace Example
{
    class Program
    {
        static void Main(string[] args)
        {
            UseNumericCharacterReference();
        }
        /// <summary>
        /// This sample shows how to use Numeric Character Reference.
        /// </summary>
        static void UseNumericCharacterReference()
        {
            string inpFile = @"..\..\..\utf-8.rtf";
            string outFile = @"Result.html";

            RtfToHtml r = new RtfToHtml();

            RtfToHtml.HtmlFlowingSaveOptions opt = new RtfToHtml.HtmlFlowingSaveOptions()
            {
                UseNumericCharacterReference = true,
                Title = "UseNumericCharacterReference"
            };

            try
            {
                r.Convert(inpFile, outFile, opt);
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Conversion failed! {ex.Message}");
            }

            // Open the result.
            System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo(outFile) { UseShellExecute = true });
        }
    }
}
Use Numeric Character Reference in VB.Net
Copy
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Text
Imports System.IO
Imports SautinSoft

Namespace Example
    Friend Class Program
        Shared Sub Main(ByVal args() As String)
            UseNumericCharacterReference()
        End Sub
        ''' <summary>
        ''' This sample shows how to use Numeric Character Reference.
        ''' </summary>
        Private Shared Sub UseNumericCharacterReference()
            Dim inpFile As String = "..\..\..\utf-8.rtf"
            Dim outFile As String = "Result.html"

            Dim r As New RtfToHtml()

            Dim opt As New RtfToHtml.HtmlFlowingSaveOptions() With {
                .UseNumericCharacterReference = True,
                .Title = "UseNumericCharacterReference"
            }

            Try
                r.Convert(inpFile, outFile, opt)
            Catch ex As Exception
                Console.WriteLine($"Conversion failed! {ex.Message}")
            End Try

            ' Open the result.
            System.Diagnostics.Process.Start(New System.Diagnostics.ProcessStartInfo(outFile) With {.UseShellExecute = True})
        End Sub
    End Class
End Namespace
See Also