Como aplicar formatação condicional às células

Como Aplicar Formatação Condicional no Excel com C#

This article was translated from English: Does it need improvement?
Translated
View the article in English

Aplique formatação condicional em C# usando a API simples do IronXL para criar regras com operadores de comparação e opções de estilo, e então aplicá-las a intervalos específicos de células em suas planilhas do Excel.

A formatação condicional é um recurso em software de planilhas e processamento de dados que permite aplicar estilos ou regras de formatação específicos a células ou dados com base em certas condições ou critérios. Ela permite que você destaque ou enfatize visualmente os dados que atendem a condições ou critérios específicos, tornando mais fácil analisar e entender os dados em uma planilha ou tabela. Seja trabalhando com arquivos Excel existentes ou criando novas planilhas do zero, IronXL fornece suporte abrangente para implementar regras de formatação condicional.

Adicione, recupere e remova formatação condicional com IronXL. Ao adicionar formatação condicional com estilo, você pode fazer ajustes de fonte e tamanho, definir bordas e alinhamento e definir padrões e cores de fundo. Essas opções de formatação funcionam perfeitamente com outros recursos do Excel, como fórmulas e formatos de dados de célula.

Início rápido: Adicione uma regra de formatação 'Menor Que' sem esforço

Comece rápido com IronXL: crie uma regra de formatação condicional usando apenas uma linha e aplique-a a um intervalo de células. Defina sua condição e estilo, e o IronXL cuida do resto.

  1. Instale IronXL com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronXl.Excel
  2. Copie e execute este trecho de código.

    var rule = workSheet.ConditionalFormatting.CreateConditionalFormattingRule(ComparisonOperator.LessThan, "8"); workSheet.ConditionalFormatting.AddConditionalFormatting("A1:A10", rule);
  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronXL em seu projeto hoje com uma avaliação gratuita

    arrow pointer

Comece a usar o IronXL


Como Adicionar Regras de Formatação Condicional?

A formatação condicional consiste em regras e estilos que são aplicados quando uma célula atende aos critérios de regra especificados. Os estilos podem incluir ajustes de fonte e tamanho, configurações de borda e alinhamento, bem como padrões e cores de fundo. Essas capacidades de formatação se integram perfeitamente com a capacidade do IronXL de selecionar intervalos e trabalhar com coleções específicas de células.

Para definir uma regra, use o método CreateConditionalFormattingRule fornecido pelo IronXL. Atribua o objeto retornado por este método a uma variável e use-o para aplicar o estilo desejado. Finalmente, use o método AddConditionalFormatting, fornecendo tanto a regra criada quanto o intervalo de células ao qual deve ser aplicada. Esta abordagem é semelhante à maneira como você gerencia planilhas ou trabalha com outros recursos do Excel programaticamente.

Quais operadores de comparação estão disponíveis?

O IronXL suporta um conjunto abrangente de operadores de comparação que permitem criar regras de formatação condicional sofisticadas. Esses operadores funcionam perfeitamente com valores numéricos, datas e até comparações de texto quando apropriado. As regras disponíveis são:

  • NoComparison: Valor padrão, usado ao aplicar formatação sem comparação
  • Between: Destaca valores dentro de um intervalo específico
  • NotBetween: Destaca valores fora de um intervalo especificado
  • Equal: Corresponde a valores exatos
  • NotEqual: Exclui valores específicos
  • GreaterThan: Destaca valores acima de um limite
  • LessThan: Destaca valores abaixo de um limite
  • GreaterThanOrEqual: Inclui o valor limite
  • LessThanOrEqual: Inclui o valor limite

Esses operadores podem ser combinados com vários tipos de dados e funcionam particularmente bem ao analisar dados que você importou de arquivos CSV ou outras fontes.

Como eu estilo a formatação condicional?

Ao criar regras de formatação condicional, IronXL oferece amplas opções de estilo. Você pode personalizar a aparência das células que atendem às suas condições, modificando várias propriedades visuais. O exemplo a seguir demonstra como criar uma regra e aplicar estilo de cor de fundo:

:path=/static-assets/excel/content-code-examples/how-to/conditional-formatting-add.cs
using IronXL;
using IronXL.Formatting.Enums;

WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Create conditional formatting rule
var rule = workSheet.ConditionalFormatting.CreateConditionalFormattingRule(ComparisonOperator.LessThan, "8");

// Set style options
rule.PatternFormatting.BackgroundColor = "#54BDD9";

// Add conditional formatting rule
workSheet.ConditionalFormatting.AddConditionalFormatting("A1:A10", rule);

workBook.SaveAs("addConditionalFormatting.xlsx");
$vbLabelText   $csharpLabel

A propriedade PatternFormatting fornece acesso a várias opções de estilo além de apenas a cor de fundo. Você também pode modificar estilos de padrão, cores de primeiro plano e preenchimentos de padrão para criar indicadores visuais mais complexos. Essa flexibilidade permite criar formatações que correspondem à identidade visual da sua organização ou torna padrões de dados específicos imediatamente reconhecíveis.

Como a formatação fica quando aplicada?

Spreadsheet with columns A and B containing numbers 1-10 before conditional formatting is applied
Spreadsheet with blue conditional formatting applied to cells A1-A7, showing formatted vs unformatted columns

Como Recupero Formatação Condicional Existente?

Trabalhar com formatação condicional existente é essencial quando você precisa modificar planilhas que já contêm regras de formatação ou quando deseja analisar a lógica de formatação aplicada a intervalos específicos. O IronXL torna fácil acessar e modificar essas regras existentes.

Para recuperar uma regra de formatação condicional, use o método GetConditionalFormattingAt. O objeto de regra retornado pode conter várias regras; use o método GetRule para acessar uma específica. A maioria das propriedades de uma regra recuperada não pode ser modificada, mas você pode ajustar o BackgroundColor através da propriedade PatternFormatting. Essa limitação garante que a lógica principal da regra permaneça intacta enquanto ainda permite personalização visual.

Quais propriedades posso modificar em regras existentes?

Ao trabalhar com regras de formatação condicional recuperadas, compreenda quais propriedades podem ser modificadas. A principal propriedade modificável é a cor de fundo, que permite atualizar a aparência visual sem alterar a lógica de condição subjacente. Aqui está um exemplo que demonstra a recuperação e modificação de uma regra existente:

:path=/static-assets/excel/content-code-examples/how-to/conditional-formatting-retrieve.cs
using IronXL;

WorkBook workBook = WorkBook.Load("addConditionalFormatting.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Create conditional formatting rule
var ruleCollection = workSheet.ConditionalFormatting.GetConditionalFormattingAt(0);
var rule = ruleCollection.GetRule(0);

// Edit styling
rule.PatternFormatting.BackgroundColor = "#B6CFB6";

workBook.SaveAs("editedConditionalFormatting.xlsx");
$vbLabelText   $csharpLabel

Essa abordagem é particularmente útil quando você precisa atualizar o tema visual de uma planilha enquanto preserva a lógica de negócios incorporada nas regras de formatação condicional.

Como posso acessar múltiplas regras em uma coleção?

Ao trabalhar com planilhas complexas, você pode encontrar várias regras de formatação condicional aplicadas ao mesmo intervalo ou intervalos sobrepostos. O método GetConditionalFormattingAt retorna uma coleção que pode conter várias regras. Você pode iterar através dessas regras usando métodos de coleção padrão ou acessar regras específicas por seu índice usando GetRule(index). Essa funcionalidade é especialmente valiosa ao trabalhar com dados de várias fontes que podem ter diferentes requisitos de formatação.

Excel spreadsheet showing rows 1-7 in column A highlighted with blue conditional formatting, rows 8-10 unformatted
Excel spreadsheet with green conditional formatting applied to cells A1-A10 containing numbers 1-10

Como Removo a Formatação Condicional?

Existem cenários em que é necessário remover completamente as regras de formatação condicional. Isso pode ser necessário ao preparar dados para exportação, simplificar a manutenção de planilhas ou quando as regras de formatação não são mais relevantes para suas necessidades atuais de análise de dados.

Para remover uma regra de formatação condicional, use o método RemoveConditionalFormatting. Passe o índice da regra alvo para este método. Essa operação é permanente para a instância atual do livro, embora você sempre possa recarregar o arquivo original se necessário.

Quando devo remover regras de formatação condicional?

Considere remover regras de formatação condicional nestas situações:

  • Exportação de Dados: Ao exportar para diferentes formatos sem suporte de formatação
  • Otimização de Desempenho: Regras complexas podem impactar o desempenho com grandes conjuntos de dados
  • Conflitos de Regras: Múltiplas regras sobrepostas criam confusão ou resultados inesperados
  • Análise Simplificada: Preparando dados para processamento automatizado onde a formatação é desnecessária
  • Criação de Modelos: Criando modelos limpos para outros utilizarem
:path=/static-assets/excel/content-code-examples/how-to/conditional-formatting-remove.cs
using IronXL;

WorkBook workBook = WorkBook.Load("addConditionalFormatting.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Remove conditional formatting rule
workSheet.ConditionalFormatting.RemoveConditionalFormatting(0);

workBook.SaveAs("removedConditionalFormatting.xlsx");
$vbLabelText   $csharpLabel

O que acontece com os estilos de célula após a remoção?

Quando você remove regras de formatação condicional, apenas a formatação condicional é removida - os dados subjacentes da célula e qualquer formatação direta permanecem inalterados. As células retornam à sua formatação base, que inclui quaisquer estilos que foram aplicados diretamente às células em vez de através de regras condicionais. Se uma célula tinha uma fonte, borda ou cor de preenchimento específica aplicadas diretamente (não através de formatação condicional), esses estilos permanecem após a remoção da formatação condicional.

Esse comportamento garante que a integridade dos seus dados seja mantida enquanto lhe dá total controle sobre a apresentação visual de suas planilhas. Para necessidades mais avançadas de formatação, explore a abrangente referência da API do IronXL para entender todas as opções de formatação disponíveis.

Perguntas frequentes

Como adiciono formatação condicional a células do Excel em C#?

IronXL facilita a adição de formatação condicional em C#. Primeiro, crie uma regra de formatação condicional usando o método `CreateConditionalFormattingRule` com o operador de comparação e o valor desejados. Em seguida, aplique-a a um intervalo de células usando o método `AddConditionalFormatting`. Por exemplo: `var rule = workSheet.ConditionalFormatting.CreateConditionalFormattingRule(ComparisonOperator.LessThan, "8"); workSheet.ConditionalFormatting.AddConditionalFormatting("A1:A10", rule);`

Quais operadores de comparação estão disponíveis para regras de formatação condicional?

O IronXL oferece suporte a vários operadores de comparação para regras de formatação condicional, incluindo MenorQue, MaiorQue, Igual, Diferente e outros. Você especifica o operador ao criar uma regra com o método CreateConditionalFormattingRule, permitindo destacar células com base em diferentes critérios, como valores menores que 8, maiores que 100 ou iguais a um texto específico.

Posso aplicar vários estilos com formatação condicional?

Sim, o IronXL permite aplicar estilos abrangentes com regras de formatação condicional. Você pode ajustar fontes e tamanhos, definir bordas e alinhamento, além de definir padrões e cores de fundo. Essas opções de formatação funcionam perfeitamente com outros recursos do Excel, como fórmulas e formatos de dados de células, oferecendo controle total sobre a aparência das células quando as condições são atendidas.

Como faço para recuperar regras de formatação condicional existentes em um arquivo do Excel?

O IronXL fornece o método GetConditionalFormattingAt para recuperar regras de formatação condicional existentes em arquivos do Excel. Isso permite examinar, modificar ou remover regras que foram aplicadas anteriormente a intervalos de células específicos, facilitando o gerenciamento e a atualização da formatação condicional em planilhas existentes.

A formatação condicional funciona tanto com arquivos Excel novos quanto com arquivos Excel já existentes?

Sim, o IronXL oferece suporte completo para a implementação de regras de formatação condicional, seja você trabalhando com arquivos Excel existentes ou criando novas planilhas do zero. Você pode carregar uma planilha existente e adicionar formatação condicional ou criar uma nova pasta de trabalho e aplicar regras de formatação à medida que constrói seus dados.

Posso remover regras de formatação condicional programaticamente?

O IronXL permite adicionar, recuperar e remover regras de formatação condicional programaticamente. Isso oferece controle total sobre o gerenciamento da formatação condicional em seus arquivos do Excel, permitindo atualizar ou limpar a formatação dinamicamente com base nos requisitos do seu aplicativo.

Curtis Chau
Redator Técnico

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 ...

Leia mais

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 12
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 19
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Pronto para começar?
Nuget Downloads 1,890,100 | Versão: 2026.3 acaba de ser lançado

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 17
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 24
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronXl.Excel
executar um exemplo Veja seus dados se transformarem em uma planilha.