Primeiros passos com o IronWord
IronWord: Biblioteca de documentos Word for .NET
IronWord é uma biblioteca de documentos Word desenvolvida pela Iron Software. O IronWord se destaca por fornecer funcionalidades robustas para trabalhar com documentos do Word em aplicações .NET .
- Carregar, manipular e salvar documentos Word e Docx.
PageSetup: Configuração de tamanho de papel, orientação de página, margens e cor de fundo.TextRun: Tratamento de conteúdo de texto, estilos, divisão, adição de texto e inclusão de imagens.TextStyle: Gerenciamento de família de fontes, tamanho, cor, negrito, itálico, tachado, sublinhado, sobrescrito e subscrito.Paragraph: Adição de execuções de texto, imagens, formas, definição de estilos, alinhamentos, listas com marcadores e listas numeradas.Table: Manipulação da estrutura de tabelas, incluindo adição de linhas, obtenção e configuração de valores de células, remoção de linhas, mesclagem de células e mais.Image: Carregamento de imagens de arquivos ou streams, configuração de texto envolvido, deslocamento de posição, largura, altura e outras propriedades.Shape: Configuração de texto envolvido, deslocamento de posição, largura, altura, tipo de forma e rotação.
Biblioteca C# para documentos do Word em .NET
- Baixe a biblioteca C# para manipulação de documentos DOCX.
- Criar e modificar documentos do Word e DOCX
- Adicione estruturas de documento, como parágrafos, seções e tabelas.
- Adicione elementos ao documento, como blocos de texto, imagens e formas.
- Estilize os elementos do documento com facilidade.
Instalação
Biblioteca IronWord
A instalação do IronWord é rápida e fácil. Você pode instalar o pacote usando o NuGet com o seguinte comando:
Alternativamente, faça o download diretamente do site oficial do IronWord no NuGet .
Uma vez instalado, você pode começar adicionando using IronWord; ao topo do seu arquivo de código C#.
Aplicando a chave de licença
Em seguida, aplique uma licença válida ou chave de teste ao IronWord, atribuindo a chave de licença à propriedade LicenseKey da classe License. Inclua o seguinte código logo após a declaração de importação, antes de usar qualquer método do IronWord :
using IronWord;
// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";Imports IronWord
' Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"Imports IronWord
' Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"Exemplos de código
Vamos explorar alguns exemplos de código e os recursos disponíveis.
- Selecione 'Arquivo' > 'Informações' e clique em "Converter".
- Você verá uma mensagem informando que seu documento será atualizado para o formato de arquivo mais recente. Clique em "OK".
Criar documento Word e Docx
Crie o documento Word instanciando a classe WordDocument usando um de seus construtores. Depois disso, use o método SaveAs para exportar o documento Word. Exemplo:
using IronWord;
class Program
{
static void Main()
{
// Create a new Word document
var document = new WordDocument();
// Save the document as a .docx file
document.SaveAs("example.docx");
}
}using IronWord;
class Program
{
static void Main()
{
// Create a new Word document
var document = new WordDocument();
// Save the document as a .docx file
document.SaveAs("example.docx");
}
}Imports IronWord
Friend Class Program
Shared Sub Main()
' Create a new Word document
Dim document = New WordDocument()
' Save the document as a .docx file
document.SaveAs("example.docx")
End Sub
End ClassImports IronWord
Friend Class Program
Shared Sub Main()
' Create a new Word document
Dim document = New WordDocument()
' Save the document as a .docx file
document.SaveAs("example.docx")
End Sub
End ClassAdicionar imagem
Não é possível adicionar uma imagem isoladamente; Em vez disso, ele deve ser adicionado a uma das estruturas do documento, como um Paragraph, TableCell ou Section. Use o método AddImage para adicionar uma imagem. Exemplo:
using IronWord;
using IronWord.Models;
class Program
{
static void Main()
{
var document = new WordDocument();
var section = new DocumentSection();
document.AddSection(section);
// Add an image to a paragraph
var paragraph = new Paragraph();
section.AddParagraph(paragraph);
paragraph.AddImage(new ImageContent("path/to/image.jpg") { Width = 100, Height = 100 });
document.SaveAs("example_with_image.docx");
}
}using IronWord;
using IronWord.Models;
class Program
{
static void Main()
{
var document = new WordDocument();
var section = new DocumentSection();
document.AddSection(section);
// Add an image to a paragraph
var paragraph = new Paragraph();
section.AddParagraph(paragraph);
paragraph.AddImage(new ImageContent("path/to/image.jpg") { Width = 100, Height = 100 });
document.SaveAs("example_with_image.docx");
}
}Imports IronWord
Imports IronWord.Models
Class Program
Shared Sub Main()
Dim document = New WordDocument()
Dim section = New DocumentSection()
document.AddSection(section)
' Add an image to a paragraph
Dim paragraph = New Paragraph()
section.AddParagraph(paragraph)
paragraph.AddImage(New ImageContent("path/to/image.jpg") With {.Width = 100, .Height = 100})
document.SaveAs("example_with_image.docx")
End Sub
End ClassImports IronWord
Imports IronWord.Models
Class Program
Shared Sub Main()
Dim document = New WordDocument()
Dim section = New DocumentSection()
document.AddSection(section)
' Add an image to a paragraph
Dim paragraph = New Paragraph()
section.AddParagraph(paragraph)
paragraph.AddImage(New ImageContent("path/to/image.jpg") With {.Width = 100, .Height = 100})
document.SaveAs("example_with_image.docx")
End Sub
End ClassAdicionar tabela
Adicionar uma tabela requer a criação da tabela, das linhas, das colunas e das células da tabela. Isso possibilita significativas oportunidades de configuração, já que cada célula pode ter estilos diferentes. Exemplo:
using IronWord;
using IronWord.Models;
class Program
{
static void Main()
{
var document = new WordDocument();
var section = new DocumentSection();
document.AddSection(section);
var table = new Table(3, 3); // 3x3 table
section.AddTable(table);
// Iterate over cells and set their content
for (int i = 0; i < table.Rows.Count; i++)
{
for (int j = 0; j < table.Rows[i].Cells.Count; j++)
{
((TableCell)table.Rows[i].Cells[j]).AddParagraph(new Paragraph(new TextContent($"Cell {i+1},{j+1}")));
}
}
document.SaveAs("example_with_table.docx");
}
}using IronWord;
using IronWord.Models;
class Program
{
static void Main()
{
var document = new WordDocument();
var section = new DocumentSection();
document.AddSection(section);
var table = new Table(3, 3); // 3x3 table
section.AddTable(table);
// Iterate over cells and set their content
for (int i = 0; i < table.Rows.Count; i++)
{
for (int j = 0; j < table.Rows[i].Cells.Count; j++)
{
((TableCell)table.Rows[i].Cells[j]).AddParagraph(new Paragraph(new TextContent($"Cell {i+1},{j+1}")));
}
}
document.SaveAs("example_with_table.docx");
}
}Imports IronWord
Imports IronWord.Models
Class Program
Shared Sub Main()
Dim document As New WordDocument()
Dim section As New DocumentSection()
document.AddSection(section)
Dim table As New Table(3, 3) ' 3x3 table
section.AddTable(table)
' Iterate over cells and set their content
For i As Integer = 0 To table.Rows.Count - 1
For j As Integer = 0 To table.Rows(i).Cells.Count - 1
CType(table.Rows(i).Cells(j), TableCell).AddParagraph(New Paragraph(New TextContent($"Cell {i + 1},{j + 1}")))
Next
Next
document.SaveAs("example_with_table.docx")
End Sub
End ClassImports IronWord
Imports IronWord.Models
Class Program
Shared Sub Main()
Dim document As New WordDocument()
Dim section As New DocumentSection()
document.AddSection(section)
Dim table As New Table(3, 3) ' 3x3 table
section.AddTable(table)
' Iterate over cells and set their content
For i As Integer = 0 To table.Rows.Count - 1
For j As Integer = 0 To table.Rows(i).Cells.Count - 1
CType(table.Rows(i).Cells(j), TableCell).AddParagraph(New Paragraph(New TextContent($"Cell {i + 1},{j + 1}")))
Next
Next
document.SaveAs("example_with_table.docx")
End Sub
End ClassLicenciamento e suporte disponíveis
IronWord é uma biblioteca paga; No entanto, licenças de avaliação gratuitas estão disponíveis aqui .
Para obter mais informações sobre a Iron Software, visite nosso site:https://ironsoftware.com/ . Para obter mais suporte e esclarecer dúvidas, entre em contato com nossa equipe .
Suporte da Iron Software
Para suporte geral e dúvidas técnicas, envie um e-mail para:support@ironsoftware.com
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.
