C# Document Element Tutorial
IronWord es una poderosa biblioteca de documentos Word diseñada para ayudar a los desarrolladores de .NET C# a integrar las capacidades de crear, leer y editar documentos Word y DOCX en sus aplicaciones. En el contexto de un documento Word, los elementos del documento son los bloques de construcción que componen el contenido.
Inicio rápido: crear un TextRun con estilo e incrustar una imagenA continuación te mostramos cómo puedes usar IronWord para agregar contenido enriquecido: combinando texto con estilo y una imagen incrustada en un documento. Este ejemplo demuestra el patrón de envoltura Run para texto con estilo.
-
1Install IronWord with NuGet Package Manager
-
2Copie y ejecute este fragmento de código.
using IronWord; using IronWord.Models; // Create document WordDocument doc = new WordDocument(); // Create styled Run Run textRun = new Run(new TextContent("Hello IronWord!")); textRun.Style = new TextStyle() { IsBold = true, Color = Color.Blue }; // Create paragraph and add Run Paragraph paragraph = new Paragraph(); paragraph.AddChild(textRun); paragraph.AddImage(new ImageContent("pic.png")); // Add to document and save doc.AddParagraph(paragraph); doc.SaveAs("output.docx");C# -
3Despliegue para probar en su entorno real
Comienza a usar IronWord en tu proyecto hoy mismo con una prueba gratuita
Tabla de contenido
- Agregar Texto
- Contenido de Texto (Agregar, Append & Dividir)
- Definir Estilo (Familia de Fuente & Tamaño, Color, Negrita & Cursiva, Tachado, Subrayado, Superíndice & Subíndice)
- Embeder Imágenes
- Agregar Imágenes
- Cargar Imagen (Archivo & FileStream)
- Definir Ajuste de Texto
- Definir Dimensiones (Ancho & Alto)
- Definir Desplazamiento de Posición
- Definir Distancia desde las Esquinas
Conceptos clave
Jerarquía de documentos
IronWord sigue una jerarquía estructurada de documentos: Document → Paragraph → Run → TextContent. Comprender esta jerarquía es esencial para trabajar con texto con estilo:
WordDocument: El contenedor de nivel superior que representa el documento completoParagraph: Un bloque de contenido dentro del documentoRun: Un objeto de envoltura que contieneTextContenty al que se le puede aplicar estiloTextContent: La cadena de texto real
Agregar contenido a los párrafos
IronWord ofrece dos métodos para agregar contenido a los párrafos:
AddText(TextContent): Utilizar para texto plano sin estilo. AñadeTextContentdirectamente al párrafo.AddChild(Run): Utilizar para texto con estilo. Añade un objetoRun(que envuelveTextContenty contiene estilo) al párrafo.
Cuando necesites aplicar estilo como tamaño de fuente, color o formato en negrita, crea un objeto Run, asigna un TextStyle al Run, y utiliza AddChild para añadirlo al párrafo.
Agregar TextRuns
Contenido del texto
El método Split se utiliza para dividir la ejecución del texto en una lista de ejecuciones de texto más pequeñas, basado en un delimitador especificado. Esto permite la organización y manipulación de la información textual dentro del documento.
using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
// Add text
TextContent addText = new TextContent("Add text using IronWord");
doc.AddParagraph(new Paragraph(addText));
// Append text
TextContent appendText = new TextContent("The first text.");
appendText.Append(new TextContent("The second text."));
doc.AddParagraph(new Paragraph(appendText));
// Split text
TextContent splitText = new TextContent("Use split to split the sentence.");
splitText.Split(" ");
doc.AddParagraph(new Paragraph(splitText));
// Export docx
doc.SaveAs("textrun.docx");Imports IronWord
Imports IronWord.Models
Private doc As New WordDocument()
' Add text
Private addText As New TextContent("Add text using IronWord")
doc.AddParagraph(New Paragraph(addText))
' Append text
Dim appendText As New TextContent("The first text.")
appendText.Append(New TextContent("The second text."))
doc.AddParagraph(New Paragraph(appendText))
' Split text
Dim splitText As New TextContent("Use split to split the sentence.")
splitText.Split(" ")
doc.AddParagraph(New Paragraph(splitText))
' Export docx
doc.SaveAs("textrun.docx")Establecer estilo
Configurar el estilo para el texto requiere usar el patrón de envoltura Run. Crea un objeto Run que contenga TextContent, luego asigna un TextStyle al Run (no al TextContent). El TextStyle te permite definir atributos visuales como FontSize, color, negrita, cursiva, tachado, subrayado, superíndice y subíndice.
Tenga en cuenta que FontSize se configura a nivel de TextStyle, mientras que FontFamily se establece dentro de la propiedad TextFont. Una vez estilizado, usa AddChild para añadir el Run a un párrafo. Esto sigue la jerarquía del documento: Document → Paragraph → Run → TextContent.
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
// Load docx
WordDocument doc = new WordDocument("document.docx");
// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
FontSize = 72,
TextFont = new Font()
{
FontFamily = "Caveat"
},
Color = Color.Red,
IsBold = true,
IsItalic = true,
Underline = new Underline(),
Strike = StrikeValue.Strike,
};
Paragraph paragraph = new Paragraph();
// Add text
paragraph.AddChild(textRun);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("save_document.docx");Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
' Load docx
Dim doc As New WordDocument("document.docx")
' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
.FontSize = 72,
.TextFont = New Font() With {
.FontFamily = "Caveat"
},
.Color = Color.Red,
.IsBold = True,
.IsItalic = True,
.Underline = New Underline(),
.Strike = StrikeValue.Strike
}
Dim paragraph As New Paragraph()
' Add text
paragraph.AddChild(textRun)
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("save_document.docx")Obtener color de relleno de texto
Además de configurar el estilo, IronWord proporciona una forma de obtener el valor de color RGBA de documentos existentes para mantener la consistencia a lo largo del estilo.
using IronWord;
using IronWord.Models;
using System;
// Open existing Word
WordDocument doc = new WordDocument("Accent1TextThemcolor.docx");
TextContent content = doc.Texts[0];
// This will show the R G B A of the themecolor
var filledColor = content.Color;
// Print the filled color variable to the console
Console.WriteLine(filledColor);Para recuperar valores de color, carga el documento usando WordDocument, luego accede a la colección Paragraphs y al array Texts para obtener el objeto TextContent. La propiedad Color de TextContent devuelve el valor RGBA del color existente del texto, permitiéndote mantener un estilo consistente a lo largo de tu documento.
Incrustar imágenes
Esta característica te permite incluir imágenes perfectamente dentro del contenido, mejorando el atractivo visual general y el poder comunicativo del documento.
using IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 200; // In unit pixel
image.Height = 200; // In unit pixel
TextContent textRun = new TextContent();
// Add image
Paragraph para = new Paragraph(textRun);
para.AddImage(image);
// Add paragraph
doc.AddParagraph(para);
// Export docx
doc.SaveAs("save_document.docx");Agregar imágenes
Cargar imagen
Cargar imágenes es un proceso crucial. Esto involucra llevar archivos de imagen externos al documento. La capacidad de cargar imágenes facilita la inclusión de visuales relevantes, contribuyendo a un documento más atractivo e informativo.
using IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
Paragraph paragraph = new Paragraph();
// Add image
paragraph.AddImage("image.jpg");
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("document.docx");Imports IronWord
Imports IronWord.Models
' Load docx
Private doc As New WordDocument()
Private paragraph As New Paragraph()
' Add image
paragraph.AddImage("image.jpg")
' Add paragraph
doc.AddParagraph(paragraph)
' Export docx
doc.SaveAs("document.docx")Configurar imagen
Optimizar las imágenes con configuraciones configurables. Esto incluye establecer propiedades como ajuste de texto, dimensiones, posición y distancia desde las esquinas. La configuración adecuada asegura que las imágenes se muestren de manera visualmente agradable y contextualmente apropiada.
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
// Load docx
WordDocument doc = new WordDocument();
// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 100;
image.Height = 100;
image.DistanceFromTop = 50;
var position = new ElementPosition();
position.X = 50;
position.Y = 50;
image.Position = position;
Paragraph paragraph = new Paragraph();
// Add image
paragraph.AddImage(image);
// Add paragraph
doc.AddParagraph(paragraph);
// Export docx
doc.SaveAs("document.docx");Preguntas Frecuentes
¿Cómo puedo añadir texto a un documento de Word usando C#?
Puede agregar texto a un documento de Word usando IronWord para crear una instancia de un run de texto, que luego se puede agregar a un párrafo dentro del documento.
¿Cuál es el método para dividir texto en un documento de Word?
IronWord proporciona el método Split, que le permite dividir un run de texto en segmentos más pequeños basados en un delimitador especificado, facilitando la manipulación de texto.
¿Cómo doy estilo al texto en un documento de Word usando IronWord?
Puede dar estilo al texto usando IronWord configurando varios atributos como tamaño de fuente, color y estilos como negrita, cursiva, tachado, subrayado, superíndice y subíndice.
¿Cómo puedo incrustar imágenes en un documento de Word con C#?
Para incrustar imágenes en un documento de Word usando IronWord, puede cargar una imagen desde un archivo y agregarla como una imagen en línea a un párrafo dentro del documento.
¿Qué pasos están involucrados en cargar una imagen en un documento de Word?
Con IronWord, puede cargar una imagen desde un archivo o un flujo de archivos, lo que le permite incorporar contenido visual en un documento de Word.
¿Cómo configuro las propiedades de la imagen en un documento de Word?
Usando IronWord, puede configurar propiedades de imagen como el ajuste de texto, dimensiones, desplazamiento de posición y distancia desde las esquinas para asegurar una correcta visualización de la imagen en el documento.
¿Puedo obtener el valor de color RGBA del texto en un documento de Word?
Sí, IronWord le permite obtener el valor de color RGBA del texto existente en un documento para mantener un estilo coherente en todo el documento.
¿Cómo puedo empezar a usar IronWord para la manipulación de documentos de Word?
Para comenzar con IronWord, puede integrarlo en su aplicación .NET C# para crear, leer y editar documentos de Word, aprovechando sus características completas de biblioteca.
How do you save a Word document created with IronWord?
A Word document created with IronWord can be saved using the 'SaveAs' method, specifying the filename and path for saving the document.
What is the function of the 'AddParagraph' method in IronWord?
The 'AddParagraph' method in IronWord is used to add fully configured paragraphs, with text and images, to a Word document.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
