Como definir borda e alinhamento de célula em C# com IronXL
Defina bordas de células e alinhamento de texto em arquivos Excel em C# usando IronXL aplicando tipos de borda como MediumDashed e propriedades de alinhamento como HorizontalAlignment.Center diretamente nas células da planilha sem dependências do Microsoft Interop.
No Excel, as bordas das células são linhas ou contornos que podem ser aplicados a células individuais ou grupos de células, enquanto o alinhamento do texto refere-se ao posicionamento do texto dentro de uma célula tanto vertical quanto horizontalmente. O IronXL fornece uma API abrangente para trabalhar com estilos de células do Excel que permite controlar esses elementos visuais programaticamente com precisão.
Início Rápido: Defina Bordas de Células e Centralize o Alinhamento de Texto com Uma ChamadaAplique um estilo de borda a um lado e centralize o texto horizontalmente em apenas duas linhas. Comece rapidamente sem sobrecarga do Interop.
-
1Install IronXL with NuGet Package Manager
-
2Copie e execute este trecho de código.
workSheet["B2"].Style.LeftBorder.Type = IronXL.Styles.BorderType.MediumDashed; workSheet["B2"].Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center;C# -
3Implante para testar em seu ambiente de produção.
Comece a usar IronXL em seu projeto hoje com uma avaliação gratuita
Fluxo de trabalho mínimo (5 etapas)
- Baixe a biblioteca C# para definir padrão e cor de fundo
- Abra uma planilha do Excel existente ou crie uma nova.
- Defina a propriedade Type da borda para um dos tipos de borda disponíveis em BorderType
- Alinhe horizontal ou verticalmente usando as propriedades HorizontalAlignment e VerticalAlignment
- Defina a cor da borda a partir de um tipo disponível ou de um código de cor hexadecimal.
Comece com o IronXL.
Como defino bordas de células e alinhamento de texto em um exemplo básico?
Personalize a aparência de uma célula, coluna, linha, ou intervalo selecionados adicionando bordas usando as propriedades TopBorder, RightBorder, BottomBorder, e LeftBorder. Escolha entre vários estilos disponíveis no enum [BorderType]. Explore todos os tipos de borda disponíveis para encontrar o encaixe perfeito.
IronXL.Styles.BorderType HorizontalAlignment VerticalAlignment IronXL.Styles.HorizontalAlignment IronXL.Styles.VerticalAlignment
Para alinhamento de texto preciso, ajuste as propriedades [HorizontalAlignment] e [VerticalAlignment] em Style para obter o layout desejado. Use os enums [HorizontalAlignment] e [VerticalAlignment] para definir o alinhamento desejado. Descubra todos os tipos de alinhamento disponíveis para apresentar seus dados impecavelmente. Esta abordagem é particularmente útil ao criar planilhas profissionais que exigem formatação consistente.
Antes de aplicar bordas e alinhamento, garanta que você tenha carregado seu workbook Excel corretamente. Aqui está um exemplo completo demonstrando a configuração básica de borda e alinhamento:
using IronXL;
using IronXL.Styles;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
workSheet["B2"].Value = "B2";
// Set cell border
workSheet["B2"].Style.LeftBorder.Type = BorderType.MediumDashed;
workSheet["B2"].Style.RightBorder.Type = BorderType.MediumDashed;
// Set text alignment
workSheet["B2"].Style.HorizontalAlignment = HorizontalAlignment.Center;
workBook.SaveAs("setBorderAndAlignment.xlsx");Imports IronXL
Imports IronXL.Styles
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private workSheet("B2").Value = "B2"
' Set cell border
Private workSheet("B2").Style.LeftBorder.Type = BorderType.MediumDashed
Private workSheet("B2").Style.RightBorder.Type = BorderType.MediumDashed
' Set text alignment
Private workSheet("B2").Style.HorizontalAlignment = HorizontalAlignment.Center
workBook.SaveAs("setBorderAndAlignment.xlsx")
Quais opções avançadas de borda e alinhamento estão disponíveis?
Como posso personalizar as cores das bordas?
Por padrão, a cor da borda é preta, mas você pode personalizá-la para qualquer cor disponível na classe Color ou usar um código de cor Hex. Para definir a cor da borda, use a propriedade [Color] com a cor desejada ou o código Hex. Além disso, a propriedade [Color] permite que você recupere a cor da borda. Essa flexibilidade é semelhante à maneira como você pode definir cores de fundo para células.
A personalização de cores de borda funciona perfeitamente com outros recursos de formatação de células. Quando combinado com formatação condicional, você pode criar sinais visuais dinâmicos que ajudam os usuários a identificar rapidamente padrões de dados importantes em suas planilhas.
using IronXL;
using IronXL.Styles;
using IronSoftware.Drawing;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
workSheet["B2"].Style.LeftBorder.Type = BorderType.Thick;
workSheet["B2"].Style.RightBorder.Type = BorderType.Thick;
// Set cell border color
workSheet["B2"].Style.LeftBorder.SetColor(Color.Aquamarine);
workSheet["B2"].Style.RightBorder.SetColor("#FF7F50");
workBook.SaveAs("setBorderColor.xlsx");Imports IronXL
Imports IronXL.Styles
Imports IronSoftware.Drawing
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private workSheet("B2").Style.LeftBorder.Type = BorderType.Thick
Private workSheet("B2").Style.RightBorder.Type = BorderType.Thick
' Set cell border color
workSheet("B2").Style.LeftBorder.SetColor(Color.Aquamarine)
workSheet("B2").Style.RightBorder.SetColor("#FF7F50")
workBook.SaveAs("setBorderColor.xlsx")
Quais posições e padrões de linhas de borda posso aplicar?
No total, há seis posições de linha de borda, cada uma oferecendo uma variedade de padrões ou tipos. Estas posições incluem topo, direita, fundo, esquerda, assim como linhas diagonais avançando, retrocedendo e ambas. Este conjunto abrangente de opções permite criar layouts visuais complexos semelhantes aos que você pode alcançar ao trabalhar com células mescladas, mas com mais flexibilidade.
Ao trabalhar com bordas diagonais, compreenda como elas interagem com o conteúdo e as configurações de alinhamento da célula. As bordas diagonais podem ser particularmente úteis para criar seções de cabeçalho ou separadores visuais em seus relatórios Excel.
using IronXL;
using IronXL.Styles;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
workSheet["B2"].StringValue = "Top";
workSheet["B4"].StringValue = "Forward";
// Set top border line
workSheet["B2"].Style.TopBorder.Type = BorderType.Thick;
// Set diagonal border line
workSheet["B4"].Style.DiagonalBorder.Type = BorderType.Thick;
// Set diagonal border direction
workSheet["B4"].Style.DiagonalBorderDirection = DiagonalBorderDirection.Forward;
workBook.SaveAs("borderLines.xlsx");Imports IronXL
Imports IronXL.Styles
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private workSheet("B2").StringValue = "Top"
Private workSheet("B4").StringValue = "Forward"
' Set top border line
Private workSheet("B2").Style.TopBorder.Type = BorderType.Thick
' Set diagonal border line
Private workSheet("B4").Style.DiagonalBorder.Type = BorderType.Thick
' Set diagonal border direction
Private workSheet("B4").Style.DiagonalBorderDirection = DiagonalBorderDirection.Forward
workBook.SaveAs("borderLines.xlsx")Para cenários de borda mais complexos, considere criar uma função reutilizável que aplique um estilo de borda consistente em várias células ou intervalos:
void ApplyUniformBorder(WorkSheet sheet, string range, BorderType borderType, Color borderColor)
{
var cells = sheet[range];
// Apply borders to all sides
cells.Style.TopBorder.Type = borderType;
cells.Style.RightBorder.Type = borderType;
cells.Style.BottomBorder.Type = borderType;
cells.Style.LeftBorder.Type = borderType;
// Apply color to all borders
cells.Style.TopBorder.SetColor(borderColor);
cells.Style.RightBorder.SetColor(borderColor);
cells.Style.BottomBorder.SetColor(borderColor);
cells.Style.LeftBorder.SetColor(borderColor);
}
// Usage example
ApplyUniformBorder(workSheet, "A1:D4", BorderType.Thin, Color.Black);Sub ApplyUniformBorder(sheet As WorkSheet, range As String, borderType As BorderType, borderColor As Color)
Dim cells = sheet(range)
' Apply borders to all sides
cells.Style.TopBorder.Type = borderType
cells.Style.RightBorder.Type = borderType
cells.Style.BottomBorder.Type = borderType
cells.Style.LeftBorder.Type = borderType
' Apply color to all borders
cells.Style.TopBorder.SetColor(borderColor)
cells.Style.RightBorder.SetColor(borderColor)
cells.Style.BottomBorder.SetColor(borderColor)
cells.Style.LeftBorder.SetColor(borderColor)
End Sub
' Usage example
ApplyUniformBorder(workSheet, "A1:D4", BorderType.Thin, Color.Black)Linhas de Borda
Padrões de Bordas
Quais opções de alinhamento de texto são suportadas?
O alinhamento de texto no IronXL proporciona controle abrangente sobre como o conteúdo é posicionado dentro das células. Este recurso é particularmente importante ao exportar dados para formatos diferentes, onde manter a consistência visual é crucial. O sistema de alinhamento funciona em conjunto com outros recursos de formatação como estilização de fonte para criar planilhas com aparência profissional.
Color Color
Enumeração HorizontalAlignment
General: Alinhamento horizontal geral. Os dados de texto são alinhados à esquerda. Números, datas e horas são alinhados à direita. Tipos booleanos são centralizados. A alteração do alinhamento não afeta o tipo de dado. Este é o alinhamento padrão quando nenhum alinhamento específico é definido.Left: Alinhamento horizontal à esquerda, mesmo no modo da direita para a esquerda. Alinha o conteúdo na borda esquerda da célula. Se um valor de indentação for especificado, o conteúdo da célula é indentado a partir da esquerda pelo número especificado de espaços de caracteres.Center: Alinhamento horizontal centralizado. O texto é centralizado em toda a célula. Isso é comumente usado para cabeçalhos e títulos.Right: Alinhamento horizontal à direita. O conteúdo da célula é alinhado na borda direita da célula, mesmo em modo da direita para a esquerda. Isso é tipicamente usado para apresentação de dados numéricos.Fill: O valor da célula preenche toda a largura. Se as células adjacentes à direita também tiverem o mesmo alinhamento de preenchimento, elas também serão preenchidas. Regras adicionais:- Apenas valores inteiros podem ser adicionados, não valores parciais.
- A coluna não será alargada para "ajuste ideal" do valor preenchido.
- Se a adição de uma ocorrência adicional do valor exceder a borda esquerda/direita da célula, não será adicionada.
- O valor exibido da célula é preenchido, não o número bruto subjacente.
Justify: Alinhamento horizontal justificado (alinhamento à esquerda e à direita). Aplica quebra de texto à célula e garante que cada linha alinhe a primeira palavra com a borda esquerda e a última palavra com a borda direita da célula (exceto para a última linha). Isso é particularmente útil para células carregadas de texto contendo parágrafos.CenterSelection: Centraliza horizontalmente o conteúdo da célula mais à esquerda até o centro em várias células. Aparência visual semelhante à fusão de células, mas sem realmente fundi-las. Usar esta opção ajuda a evitar problemas potenciais que podem surgir de células mescladas.Distributed: Cada 'palavra' em cada linha de texto dentro da célula é distribuída uniformemente pela largura da célula, com margens à direita e à esquerda igualadas. Se houver um valor de indentação a aplicar, ambos os lados direito e esquerdo da célula são preenchidos pelo valor de indentação.
Enumeração VerticalAlignment
None: O alinhamento padrão, que normalmente resulta no comportamento de alinhamento inferior.Top: Alinha o conteúdo na parte superior da célula. Útil para células com alturas de conteúdo variáveis.Center: Centraliza verticalmente o conteúdo dentro da célula. Isso cria uma aparência equilibrada, especialmente quando combinado com centralização horizontal.Bottom: Alinha o conteúdo na parte inferior da célula. Este é o comportamento padrão para a maioria dos aplicativos de planilha.Justify: Distribui as linhas de texto uniformemente pela altura da célula, com margens de topo e fundo igualadas. Funciona de forma semelhante à justificação horizontal, quebrando o texto e ajustando os espaços entre as linhas para ocupar toda a altura da linha.Distributed: Distribui cada 'palavra' em cada linha de texto uniformemente pela altura da célula, com margens de topo e fundo igualadas na direção do texto horizontal. Na direção vertical do texto, comporta-se exatamente como o alinhamento horizontal distribuído, distribuindo uniformemente as linhas de texto de cima a baixo.
Ao trabalhar com configurações de alinhamento, considere como elas interagem com outras propriedades da célula. Por exemplo, quando você ajusta automaticamente o tamanho das linhas e colunas, as configurações de alinhamento afetarão como o conteúdo se encaixa dentro das células dimensionadas automaticamente. Da mesma forma, ao trabalhar com fórmulas, o alinhamento adequado pode tornar seus cálculos de planilha mais legíveis e profissionais.
Perguntas frequentes
Como adicionar bordas às células do Excel em C# sem usar o Microsoft Office?
Você pode adicionar bordas às células do Excel usando a API de Estilos do IronXL. Basta acessar a propriedade `Style` da célula e definir os tipos de borda, como `MediumDashed`, usando propriedades como `LeftBorder.Type`, `RightBorder.Type`, `TopBorder.Type` e `BottomBorder.Type`. O IronXL funciona de forma independente, sem exigir dependências do Microsoft Office ou de interoperabilidade.
Quais estilos de borda estão disponíveis para células do Excel em C#?
O IronXL oferece diversos estilos de borda através da enumeração IronXL.Styles.BorderType, incluindo opções como MediumDashed, Thin, Thick, Double e muito mais. Você pode aplicar esses estilos a qualquer lado de uma célula (superior, direito, inferior, esquerdo) para criar planilhas com aparência profissional.
Como posso centralizar o texto em células do Excel programaticamente?
Para centralizar o texto em células do Excel usando o IronXL, defina a propriedade Style.HorizontalAlignment como IronXL.Styles.HorizontalAlignment.Center. Você também pode controlar o alinhamento vertical usando a propriedade VerticalAlignment para ter controle total sobre o posicionamento do texto.
Posso aplicar bordas e alinhamento a várias células ao mesmo tempo?
Sim, o IronXL permite aplicar bordas e alinhamento a intervalos, colunas ou linhas inteiras. Basta selecionar o intervalo desejado e aplicar as propriedades de Estilo para formatar várias células simultaneamente, tornando as operações de formatação em massa mais eficientes.
Como faço para definir cores de borda para células do Excel em C#?
O IronXL permite definir cores de borda usando tipos de cores predefinidos ou códigos de cores hexadecimais personalizados. Acesse a propriedade de cor da borda por meio do objeto Estilo para personalizar a aparência das bordas das células.
Qual é o código mínimo necessário para adicionar bordas e centralizar o texto?
Com o IronXL, você pode adicionar bordas e centralizar o texto em apenas duas linhas: `workSheet["B2"].Style.LeftBorder.Type = IronXL.Styles.BorderType.MediumDashed;` e `workSheet["B2"].Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center;`. Isso proporciona formatação rápida sem sobrecarga de interoperabilidade.
How do I ensure seamless visuals while applying borders in IronXL?
In IronXL, apply consistent border types and colors using the same BorderType and SetColor methods across cells to ensure seamless visuals, and consider combining them with other formatting options like conditional formatting for dynamic styling.
Can IronXL handle both horizontal and vertical text alignment in Excel sheets?
Yes, IronXL can manage both horizontal and vertical text alignment through the HorizontalAlignment and VerticalAlignment properties, allowing comprehensive control over how text appears in cells.
What function can I use to apply a uniform border across multiple cells using IronXL?
You can create a custom function like ApplyUniformBorder, which takes parameters for the worksheet, cell range, border type, and color, to apply consistent borders across multiple cells using IronXL's BorderType and Coloring features.
How does IronXL facilitate professional spreadsheet formatting?
IronXL supports detailed formatting features such as precise control over cell borders and text alignment, including advanced border types and alignment options, which enable you to create professional-looking spreadsheets and reports effortlessly.
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.
