En savoir plus sur Xceed Words pour .NET

Si vous souhaitez créer des documents Word de manière programmatique à l'aide de C#, Xceed Words for .NET est une API puissante et facile à utiliser qui peut vous aider à réaliser ce travail. Dans cet article, nous verrons comment utiliser Xceed Words for .NET pour créer un nouveau document Word et y ajouter du contenu.

Création d'un nouveau document Word

Pour créer un nouveau document Word par programmation dans C# à l'aide de Xceed Words for .NET, il suffit de spécifier le nom du fichier ou le chemin d'accès et le nom du fichier, puis d'enregistrer le document. Ce processus peut être réalisé avec seulement quelques lignes de code, comme le montre l'exemple ci-dessous :

// Create a new document
	using( var document = DocX.Create( "NewDocument.docx" ) )
	{
		// Save this document to disk.
		document.Save();
	}

Nous pouvons également ouvrir un document existant au lieu d'en créer un nouveau (en utilisant l'option Chargement au lieu de Créer), et nous pouvons choisir d'enregistrer dans un nouveau document au lieu d'écraser le document existant (en utilisant la fonction Sauvegarde au lieu de Économisez):

// Open an existing document
	using( var document = DocX.Load( "ExistingDocument.docx" ) )
	{
		// Save this document to disk.
		document.SaveAs( "NewCopy.docx" );
	}

Notes:

• The Create, Load and SaveAs methods expect either a String or Stream as parameter.
• The Create method also supports an optional parameter to indicate the document type.
• For more information please refer to the documentation.

Ajout de paragraphes

Un document vierge n'est pas très utile, nous allons donc ajouter quelques paragraphes.

L'ajout d'un paragraphe se fait en appelant InsérerParagraphe sur le document. Cette opération renvoie le paragraphe nouvellement créé, de sorte que nous puissions l'affecter à une variable si nous prévoyons d'y apporter des modifications.

// Insert a blank paragraph.
document.InsertParagraph();

// Insert a paragraph that we want to modify.
var p = document.InsertParagraph();

Une fois que nous avons un paragraphe en main, nous pouvons le modifier de plusieurs façons. Nous pouvons ajouter des éléments tels que du texte, un signet, un lien hypertexte, une image, etc. Nous pouvons également modifier le format, comme la famille de police, la taille de la police, la couleur, la mise en gras/italique/souligné, etc.

Pour l'instant, nous nous concentrerons sur l'ajout de texte simple et nous examinerons quelques façons de personnaliser l'aspect de ce texte.

Ajouter du texte à un paragraphe

L'ajout de texte peut se faire en appelant Ajouter sur le paragraphe. Si le texte que nous ajoutons doit avoir une certaine apparence, cela peut également être spécifié en même temps.

Voici quelques exemples :

// Append text without any formatting
var p1 = document.InsertParagraph();
p1.Append(“This is the first paragraph.”);

// Append text formatted to be Red and Bold
var p2 = document.InsertParagraph();
p2.Append(“This is the second paragraph.”)
.Color( Color.Red )
.Bold();

// Append text formatted to be in Arial and size 24
var p3 = document.InsertParagraph();
p3.Append(“This is the third paragraph.”)
.Font( new Xceed.Document.NET.Font( "Arial" ) )
.FontSize( 24 );

Il est également possible d'ajouter plusieurs blocs de texte en même temps et de les doter chacun de leur propre formatage :

// Append text formatted to be Red and Bold
var p = document.InsertParagraph();
p.Append(“This is a simple formatted red bold paragraph”)
.Font( new Xceed.Document.NET.Font( "Arial" ) )
.FontSize( 24 )
.Color( Color.Red )
.Bold()
.Append(“ containing a blue italic text.”)
.Font( new Xceed.Document.NET.Font( "Times New Roman" ) )
.Color( Color.Blue )
.Italic();

Notes:

• The Append method also supports an optional parameter to indicate the Formatting.
• This Formatting parameter allows you to set a common format and re-use it more easily.
• For more information please refer to the documentation.

Voici les premières étapes de la création d'un document Word (docx) à l'aide de C#. D'autres articles seront bientôt disponibles pour vous aider à apprendre des fonctionnalités plus avancées.

Pour plus d'informations, veuillez vous référer à la la documentation.