Execute a mesclagem horizontal ou a mesclagem vertical de uma ou mais células de tabela em arquivos docs/docx. FileFormat.words fornece métodos para trabalhar com tabelas nos arquivos do Word.
Visão geral {.wp-block-heading} A versão mais recente do [FileFormat.words] 2 oferece mais métodos para trabalhar com tabelas em [Word] 3 documentos. O [versão] anterior 4 contém métodos para criar, editar e ler propriedades da tabela, enquanto a versão mais recente permite que os usuários mesclem programaticamente células da tabela nos arquivos docs/docx. Além disso, você pode fazer mesclar horizontal ou mesclagem vertical de células de tabela usando este código aberto .NET [Biblioteca] 5. Além disso, é uma biblioteca fácil de usar cujos métodos não são complexos e não precisam de nenhuma dependência de terceiros. Nesta postagem do blog, aprenderemos como mesclar as células da tabela em documentos do Word. Então, vamos iniciar o processo de instalação e começar a escrever o código -fonte. Abordaremos os seguintes títulos neste artigo:
- [Instalação da API do gerador de tabela] 6
- [Como mesclar as células da tabela em documentos do Word] 7
Instalação da API do gerador de tabela
Visite este [link] 8 para obter informações detalhadas sobre a instalação. Apenas para re-capítulo, o processo de instalação desta API .NET gratuita é relativamente fácil. Bem, você pode baixar o [Nuget Package] 9 ou executar o seguinte comando no Nuget Package Manager:
Install-Package FileFormat.Words
Como mesclar células de tabela em documentos do Word
Escreveremos um trecho de código para obter a mesclagem horizontal e a fusão vertical das células da tabela. Para esse fim, usaremos as classes e métodos expostos. Visite este guia para saber como criar uma tabela em um documento do Word usando o FileFormat.words. Então, usaremos mais classes e métodos em nosso snippet de código:
- Crie um objeto da classe [verticalMerge] 10.
- [Mergerestart] 11 A propriedade é usada para especificar que o elemento deve iniciar uma nova região mesclada verticalmente na tabela.
- Invoque o método [Apêndos] 12 para anexar o objeto VerticalMerge ao objeto TBLCELLPROPS.
- Instanciar uma instância da classe [Horizontalmerge] 13.
- [Mergerestart] 14 A propriedade é usada para especificar que o elemento deve iniciar uma nova região mesclada horizontalmente na tabela.
- Ligue para o método [APÊNDAR] 15 para anexar o objeto Horizontalmerge ao objeto TBLCellProps.
- [Mergecontinue] 16 A propriedade é usada para especificar que o elemento deve encerrar uma região mesclada horizontalmente na tabela.
- [Mergecontinue] 17 A propriedade é usada para especificar que o elemento deve encerrar uma região mesclada verticalmente na tabela.
using FileFormat.Words;
using FileFormat.Words.Table;
namespace Example
{
class Program
{
static void Main(string[] args)
{
// Initialize an instance of the Document class.
using (Document doc = new Document())
{
// Instantiate the constructor of the Body class with the Document class object.
Body body = new Body(doc);
// Create an object of the Table class.
Table table = new Table();
// Initialize the constructor of the TopBorder class to set the border of the top side of the table.
TopBorder topBorder = new TopBorder();
// Invoke the basicBlackSquares_border method to set the border style and border line width.
topBorder.basicBlackSquares_border(20);
// To set the border of the bottom side of the table.
BottomBorder bottomBorder = new BottomBorder();
bottomBorder.basicBlackSquares_border(20);
// To set the border of the right side of the table.
RightBorder rightBorder = new RightBorder();
rightBorder.basicBlackSquares_border(20);
// To set the border of the left side of the table.
LeftBorder leftBorder = new LeftBorder();
leftBorder.basicBlackSquares_border(20);
// To set the inside vertical border of the table.
InsideVerticalBorder insideVerticalBorder = new InsideVerticalBorder();
insideVerticalBorder.basicBlackSquares_border(20);
// To set the inside vehorizontalrtical border of the table.
InsideHorizontalBorder insideHorizontalBorder = new InsideHorizontalBorder();
insideHorizontalBorder.basicBlackSquares_border(20);
// Create an instance of the TableBorders class.
TableBorders tableBorders = new TableBorders();
// Append the object of the TopBorder class to the object of the TableBorders class.
tableBorders.AppendTopBorder(topBorder);
// Append the object of the BottomBorder class.
tableBorders.AppendBottomBorder(bottomBorder);
// Append the object of the RightBorder class.
tableBorders.AppendRightBorder(rightBorder);
// Append the object of the LeftBorder class.
tableBorders.AppendLeftBorder(leftBorder);
// Append the object of the InsideVerticalBorder class.
tableBorders.AppendInsideVerticalBorder(insideVerticalBorder);
// Append the object of the InsideHorizontalBorder class.
tableBorders.AppendInsideHorizontalBorder(insideHorizontalBorder);
// Initialize an instance of the TableProperties class.
TableProperties tblProp = new TableProperties();
// Invoke the Append method to attach the object of the TableBorders class.
tblProp.Append(tableBorders);
// Create an instance of the TableJustification class
TableJustification tableJustification = new TableJustification();
// Call the AlignLeft method to position the table on left side of the document.
tableJustification.AlignLeft();
// Invoke the Append method to attach the tableJustification object to the tblProp object.
tblProp.Append(tableJustification);
// The AppendChild method will attach the table properties to the table.
table.AppendChild(tblProp);
// Create an object of the TableRow class to create a table row.
TableRow tableRow = new TableRow();
TableRow tableRow2 = new TableRow();
// Initialize an instance of the TableCell class.
TableCell tableCell = new TableCell();
Paragraph para = new Paragraph();
Run run = new Run();
// Set the header of the first column by invoking the TableHeaders method.
table.TableHeaders("Name");
run.Text = "Mustafa";
para.AppendChild(run);
// Call the Append method to add text inside the table cell.
tableCell.Append(para);
// Create an object of the TableCellProperties table properties
TableCellProperties tblCellProps = new TableCellProperties();
// Set the width of table cell by initializing the object of the TableCellWidth class and append to tblCellProps object.
tblCellProps.Append(new TableCellWidth("2400"));
// Append method will attach the tblCellProps object with the object of the TableCell class.
tableCell.Append(tblCellProps);
TableCell tableCell2 = new TableCell();
Paragraph para2 = new Paragraph();
Run run2 = new Run();
// set the header of the second column
table.TableHeaders("Nationality");
run2.Text = "Pakistani";
para2.AppendChild(run2);
tableCell2.Append(para2);
TableCellProperties tblCellProps2 = new TableCellProperties();
// Create an object of the VerticalMerge class.
VerticalMerge verticalMerge = new VerticalMerge();
// MergeRestart property is used to specify that the element shall start a new vertically merged region in the table.
verticalMerge.MergeRestart = true;
// Invoke the Append method to attach the verticalMerge object with the tblCellProps object.
tblCellProps.Append(verticalMerge);
// Instantiate an instance of the HorizontalMerge class.
HorizontalMerge horizontalMerge = new HorizontalMerge();
// MergeRestart property is used to specify that the element shall start a new horizontally merged region in the table.
horizontalMerge.MergeRestart = true;
// Call the Append method to attach the horizontalMerge object with the tblCellProps object.
tblCellProps2.Append(horizontalMerge);
tblCellProps2.Append(new TableCellWidth("1400"));
tableCell2.Append(tblCellProps2);
TableCell tableCell3 = new TableCell();
Paragraph para3 = new Paragraph();
Run run3 = new Run();
table.TableHeaders("Age");
run3.Text = "30";
para3.AppendChild(run3);
tableCell3.Append(para3);
HorizontalMerge horizontalMerge1 = new HorizontalMerge();
// MergeContinue property is used to specify that the element shall end a horizontally merged region in the table.
horizontalMerge1.MergeContinue = true;
TableCellProperties tblCellProps3 = new TableCellProperties();
tblCellProps3.Append(new TableCellWidth("1400"));
tblCellProps3.Append(horizontalMerge1);
tableCell3.Append(tblCellProps3);
// Call the Append method to add cells into table row.
tableRow.Append(tableCell);
tableRow.Append(tableCell2);
tableRow.Append(tableCell3);
// create table cell
TableCell _tableCell = new TableCell();
Paragraph _para = new Paragraph();
Run _run = new Run();
_run.Text = "sultan";
_para.AppendChild(_run);
_tableCell.Append(_para);
TableCellProperties tblCellProps1_ = new TableCellProperties();
VerticalMerge verticalMerge2 = new VerticalMerge();
// MergeContinue property is used to specify that the element shall end a vertically merged region in the table.
verticalMerge2.MergeContinue = true;
tblCellProps1_.Append(verticalMerge2);
tblCellProps1_.Append(new TableCellWidth("2400"));
_tableCell.Append(tblCellProps1_);
TableCell _tableCell2 = new TableCell();
Paragraph _para2 = new Paragraph();
Run _run2 = new Run();
_run2.Text = "British";
_para2.AppendChild(_run2);
_tableCell2.Append(_para2);
TableCellProperties tblCellProps2_ = new TableCellProperties();
tblCellProps2_.Append(new TableCellWidth("1400"));
_tableCell2.Append(tblCellProps2_);
TableCell _tableCell3 = new TableCell();
Paragraph _para3 = new Paragraph();
Run _run3 = new Run();
_run3.Text = "2";
_para3.AppendChild(_run3);
_tableCell3.Append(_para3);
TableCellProperties tblCellProps3_ = new TableCellProperties();
tblCellProps3_.Append(new TableCellWidth("1400"));
_tableCell3.Append(tblCellProps3_);
tableRow2.Append(_tableCell);
tableRow2.Append(_tableCell2);
tableRow2.Append(_tableCell3);
// Call the Append method to add the rows into table.
table.Append(tableRow);
table.Append(tableRow2);
// The AppendChild method will add the table to the body of the document.
body.AppendChild(table);
// The Save method will save the Word document onto the disk.
doc.Save("/Users/Mustafa/Desktop/Docs.docx");
}
}
}
}
Copie e cole o segmento de código acima no seu arquivo principal e execute. Você verá o arquivo Word gerado com o conteúdo mostrado na imagem abaixo:
Conclusão
Estamos encerrando esta postagem do blog aqui com a esperança de que você aprendeu como mesas de mesclar células no Word documentos programaticamente. Além disso, também escrevemos o código -fonte para implementar a mesclagem horizontal e a fusão vertical das células da tabela. Portanto, você pode optar por esta API de gerador de tabela de código aberto para automatizar a automação do arquivo de palavras. No final, não se esqueça de visitar a [documentação] 19 para aprender sobre mais classes e métodos. Finalmente, [FileFormat.com] 20 está constantemente escrevendo postagens no tutorial sobre tópicos interessantes. Então, por favor, mantenha contato para atualizações regulares. Além disso, você pode nos seguir em nossas plataformas de mídia social, incluindo [Facebook] 21, [LinkedIn] 22 e [Twitter] 23.
Contribua
Desde [FileFormat.words para .net] 5 é um projeto de código aberto e está disponível no [Github] 24. Portanto, a contribuição da comunidade é muito apreciada.
Faça uma pergunta
Você pode nos informar sobre suas perguntas ou consultas em nosso [fórum] 25.
FAQs
Como faço para mesclar células em um documento do Word? Você pode mesclar células de tabela usando classes [verticalMerge] 10 e [Horizontalmerge] 13. Como faço para mesclar células em uma tabela em doc? Siga este [link] 7 para aprender as etapas e o trecho de código para obter essa funcionalidade.