ToString

ToString(SaveFormat)

Exporte le contenu du nœud dans une chaîne au format spécifié.

public string ToString(SaveFormat saveFormat)

Return_Value

Le contenu du nœud au format spécifié.

Exemples

Montre la différence entre l’appel des méthodes GetText et ToString sur un nœud.

Document doc = new Document();

DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertField("MERGEFIELD Field");

// GetText récupérera le texte visible ainsi que les codes de champs et les caractères spéciaux.
Assert.AreEqual("\u0013MERGEFIELD Field\u0014«Field»\u0015\u000c", doc.GetText());

// ToString nous donnera l'apparence du document s'il est enregistré dans un format de sauvegarde transmis.
Assert.AreEqual("«Field»\r\n", doc.ToString(SaveFormat.Text));

Exporte le contenu d’un nœud vers String au format HTML.

Document doc = new Document(MyDir + "Document.docx");

Node node = doc.LastSection.Body.LastParagraph;

// Lorsque nous appelons la méthode ToString en utilisant la surcharge html SaveFormat,
// il convertit le contenu du nœud en sa représentation HTML brute.
Assert.AreEqual("<p style=\"margin-top:0pt; margin-bottom:8pt; line-height:108%; font-size:12pt\">" +
                "<span style=\"font-family:'Times New Roman'\">Hello World!</span>" +
                "</p>", node.ToString(SaveFormat.Html));

// On peut également modifier le résultat de cette conversion à l'aide d'un objet SaveOptions.
HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.ExportRelativeFontSize = true;

Assert.AreEqual("<p style=\"margin-top:0pt; margin-bottom:8pt; line-height:108%\">" +
                "<span style=\"font-family:'Times New Roman'\">Hello World!</span>" +
                "</p>", node.ToString(saveOptions));

Montre comment extraire les étiquettes de liste de tous les paragraphes qui sont des éléments de liste.

Document doc = new Document(MyDir + "Rendering.docx");
doc.UpdateListLabels();

NodeCollection paras = doc.GetChildNodes(NodeType.Paragraph, true);

// Trouve si nous avons la liste des paragraphes. Dans notre document, notre liste utilise des chiffres arabes simples,
// qui commence à trois heures et se termine à six heures.
foreach (Paragraph paragraph in paras.OfType<Paragraph>().Where(p => p.ListFormat.IsListItem))
{
    Console.WriteLine($"List item paragraph #{paras.IndexOf(paragraph)}");

    // Il s'agit du texte que nous obtenons lorsque nous extrayons ce nœud au format texte.
     // Cette sortie texte omettra les étiquettes de liste. Coupez tous les caractères de formatage de paragraphe.
    string paragraphText = paragraph.ToString(SaveFormat.Text).Trim();
    Console.WriteLine($"\tExported Text: {paragraphText}");

    ListLabel label = paragraph.ListLabel;

    // Ceci obtient la position du paragraphe dans le niveau actuel de la liste. Si nous avons une liste à plusieurs niveaux,
    // cela nous dira quelle est sa position à ce niveau.
    Console.WriteLine($"\tNumerical Id: {label.LabelValue}");

    // Combinez-les ensemble pour inclure l'étiquette de liste avec le texte dans la sortie.
    Console.WriteLine($"\tList label combined with text: {label.LabelString} {paragraphText}");
}

Voir également


ToString(SaveOptions)

Exporte le contenu du nœud dans une chaîne à l’aide des options de sauvegarde spécifiées.

public string ToString(SaveOptions saveOptions)
ParamètreTaperLa description
saveOptionsSaveOptionsSpécifie les options qui contrôlent la manière dont le nœud est enregistré.

Return_Value

Le contenu du nœud au format spécifié.

Exemples

Exporte le contenu d’un nœud vers String au format HTML.

Document doc = new Document(MyDir + "Document.docx");

Node node = doc.LastSection.Body.LastParagraph;

// Lorsque nous appelons la méthode ToString en utilisant la surcharge html SaveFormat,
// il convertit le contenu du nœud en sa représentation HTML brute.
Assert.AreEqual("<p style=\"margin-top:0pt; margin-bottom:8pt; line-height:108%; font-size:12pt\">" +
                "<span style=\"font-family:'Times New Roman'\">Hello World!</span>" +
                "</p>", node.ToString(SaveFormat.Html));

// On peut également modifier le résultat de cette conversion à l'aide d'un objet SaveOptions.
HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.ExportRelativeFontSize = true;

Assert.AreEqual("<p style=\"margin-top:0pt; margin-bottom:8pt; line-height:108%\">" +
                "<span style=\"font-family:'Times New Roman'\">Hello World!</span>" +
                "</p>", node.ToString(saveOptions));

Voir également