Como Listar Formatos com GroupDocs.Redaction .NET

Gerenciar uma ampla variedade de tipos de documentos é uma realidade diária para desenvolvedores que criam aplicações centradas em documentos. Neste tutorial você aprenderá como listar formatos que o GroupDocs.Redaction .NET pode manipular, para que possa validar arquivos antes do processamento, apresentar aos usuários opções precisas e manter seu fluxo de trabalho eficiente.

Introdução

O manuseio eficiente de documentos começa com saber exatamente quais tipos de arquivo sua biblioteca suporta. O GroupDocs.Redaction fornece um método embutido para recuperar essas informações, permitindo que você construa elementos de UI dinâmicos, aplique regras de validação e evite erros em tempo de execução. Abaixo você encontrará tudo o que precisa para começar, desde a instalação até trechos de código práticos e dicas de desempenho.

Respostas Rápidas

  • O que significa “como listar formatos”? Refere‑se a recuperar a coleção de extensões de arquivo que o GroupDocs.Redaction pode processar.
  • Preciso de licença? Sim, uma licença válida do GroupDocs.Redaction é necessária para uso em produção.
  • Quais versões do .NET são suportadas? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6/7.
  • Quantos formatos estão disponíveis? Mais de 30 formatos de entrada e saída são suportados prontamente.
  • É necessária alguma configuração especial? Nenhuma configuração extra é necessária além da inicialização padrão da biblioteca.

O que é “como listar formatos”?

Envolve chamar a API FileType da biblioteca para obter uma coleção onde cada entrada contém a extensão do arquivo e um nome legível. Os desenvolvedores podem então iterar essa coleção para criar regras de validação, preencher menus suspensos da UI ou registrar tipos suportados, garantindo que apenas documentos compatíveis sejam processados.

Por que listar formatos com GroupDocs.Redaction?

O GroupDocs.Redaction suporta 30+ tipos de arquivo distintos — incluindo PDF, DOCX, PPTX e formatos de imagem — permitindo que você manipule a maioria dos documentos corporativos sem conversores de terceiros. Ao listar programaticamente esses formatos, você elimina suposições, reduz tickets de suporte e garante que apenas arquivos compatíveis entrem no seu pipeline de processamento.

Pré-requisitos

  • GroupDocs.Redaction for .NET – baixe o pacote mais recente no site oficial.
  • .NET Framework ou .NET Core – compatível com seu ambiente de desenvolvimento.
  • Visual Studio (ou qualquer IDE compatível com C#).
  • Familiaridade básica com a sintaxe C#.

Configurando GroupDocs.Redaction para .NET

.NET CLI

dotnet add package GroupDocs.Redaction

Gerenciador de Pacotes

Install-Package GroupDocs.Redaction

UI do Gerenciador de Pacotes NuGet

  • Procure por “GroupDocs.Redaction” e instale a versão mais recente.

Aquisição de Licença

O GroupDocs oferece um teste gratuito, uma licença temporária para avaliação ou opções de compra completa. Visite o site do GroupDocs para obter o arquivo de licença apropriado.

Inicialização e Configuração Básicas

Depois de adicionar o pacote, referencie o namespace e crie uma instância Redactor:

using GroupDocs.Redaction;

// Initialize with a license file (replace path as needed)
Redactor redactor = new Redactor("path/to/license/file.lic");

Guia de Implementação

Como listar formatos com GroupDocs.Redaction .NET?

Carregue a biblioteca, chame o helper estático e ordene os resultados — isso fornece uma coleção pronta para uso em apenas duas linhas de código. Use FileType.GetSupportedFileFormats() para recuperar um IEnumerable<FileType> que inclui a extensão e o nome de exibição de cada formato, então ordene por extensão para obter uma lista de UI limpa.

Recuperando Formatos de Arquivo Compatíveis

Visão Geral

O objetivo é obter uma lista de tipos de arquivo que o GroupDocs.Redaction pode manipular, facilitando a integração em lógica de validação, menus suspensos da UI ou mecanismos de registro.

Implementação Passo a Passo

1. Retrieve Supported File Types
FileType.GetSupportedFileFormats() retorna todos os formatos que a biblioteca reconhece. O método faz parte da classe GroupDocs.Redaction.FileType, que encapsula metadados como extensão de arquivo e nome amigável.

2. Display Supported File Types
Itere sobre a coleção e exiba a extensão e a descrição de cada formato. Exemplo de código inline:

var formats = FileType.GetSupportedFileFormats()
                      .OrderBy(f => f.Extension);

foreach (var format in formats)
{
    Console.WriteLine($"{format.Extension} – {format.Name}");
}

O snippet imprime uma lista ordenada como “.pdf – Portable Document Format”, tornando‑a perfeita para preencher elementos de UI.

Dicas de Solução de Problemas

  • Missing Package – Verifique a referência do pacote NuGet e restaure os pacotes se necessário.
  • Incorrect License Path – Garanta que o arquivo de licença seja copiado para o diretório de saída ou forneça um caminho absoluto.
  • Unsupported Extension – Se um formato não aparecer na lista, confirme que está usando a versão mais recente da biblioteca; versões mais novas adicionam formatos adicionais.

Aplicações Práticas

Entender os formatos de arquivo suportados desbloqueia vários cenários reais:

  1. Sistemas de Gerenciamento de Documentos – Valide uploads contra a lista suportada para evitar falhas de processamento.
  2. Segurança de Conteúdo – Aplique regras de redação apenas a tipos de arquivo que o motor pode modificar com segurança.
  3. Pipelines de Processamento em Lote – Filtre grandes lotes de arquivos antes de invocar a redação, economizando CPU e memória.

Considerações de Desempenho

  • Memory Footprint – Listar formatos é uma operação leve; não carrega nenhum documento na memória.
  • Batch Operations – Ao processar centenas de arquivos, recupere a lista de formatos uma única vez e reutilize‑a para evitar chamadas redundantes.
  • Thread Safety – FileType.GetSupportedFileFormats() é thread‑safe e pode ser chamada de tarefas paralelas sem sincronização.

Conclusão

Agora você tem uma abordagem completa e pronta para produção para como listar formatos usando GroupDocs.Redaction .NET. Ao integrar esse recurso, você pode aprimorar a validação, melhorar a experiência do usuário e manter seus pipelines de documentos robustos.

Próximos Passos

  • Explore a API Redactor para aplicar regras de redação com base no tipo de arquivo.
  • Combine a lista de formatos com um menu suspenso front‑end para seleção de arquivos sem atritos.
  • Revise o guia de desempenho para otimizar trabalhos em lote de grande escala.

Perguntas Frequentes

Q: Posso recuperar a lista de formatos sem inicializar uma instância Redactor?
A: Sim, FileType.GetSupportedFileFormats() é estático e não requer um objeto Redactor.

Q: A lista inclui formatos de entrada e saída?
A: O método retorna todos os formatos que a biblioteca pode ler e escrever; cada FileType inclui um sinalizador CanRead e CanWrite.

Q: Com que frequência a lista de formatos suportados é atualizada?
A: O GroupDocs lança atualizações de formatos a cada nova versão da biblioteca; verificar a lista em tempo de execução garante que você sempre tenha o conjunto mais recente.

Q: Existe uma forma de filtrar apenas formatos compatíveis com PDF?
A: Sim, filtre a coleção onde format.Extension == ".pdf" ou onde format.Name.Contains("PDF").

Q: Essa abordagem funciona no .NET Core 2.1?
A: O método requer .NET Core 3.1 ou posterior; runtimes mais antigos não são suportados.

Seção de FAQ

  1. Como instalo o GroupDocs.Redaction para .NET?
    Use o comando CLI dotnet add package GroupDocs.Redaction ou instale via UI do Gerenciador de Pacotes NuGet.
  2. Quais são os problemas comuns ao recuperar formatos suportados?
    Certifique‑se de que todas as dependências foram restauradas e que você está referenciando o namespace correto (GroupDocs.Redaction).
  3. Posso usar esse recurso em aplicações que não sejam .NET?
    Este tutorial foca em .NET, mas o GroupDocs fornece APIs semelhantes para Java, Python e outras plataformas.
  4. Como otimizar o desempenho ao usar o GroupDocs.Redaction?
    Reutilize a lista de formatos, evite carregar documentos completos quando apenas verificar compatibilidade e monitore o uso de memória durante trabalhos em lote.
  5. Quais tipos de arquivo o GroupDocs.Redaction suporta?
    A biblioteca suporta mais de 30 formatos, incluindo PDF, DOCX, PPTX, XLSX, BMP, PNG, JPEG e muitos outros. Use FileType.GetSupportedFileFormats() para ver a lista completa.

Recursos

Última Atualização: 2026-07-20
Testado com: GroupDocs.Redaction 4.2.0 for .NET
Autor: GroupDocs

dotnet add package GroupDocs.Redaction

Install-Package GroupDocs.Redaction

using GroupDocs.Redaction;
// Initialize the Redactor with file path
Redactor redactor = new Redactor("sample.pdf");

using System;
using System.Collections.Generic;
using System.Linq;
using GroupDocs.Redaction;

// Step 1: Use GroupDocs.Redaction API to fetch all supported formats.
IEnumerable<FileType> supportedFileTypes = FileType.GetSupportedFileFormats().OrderBy(f => f.Extension);

// Step 2: Loop through the list of file types and print details.
foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine($"{fileType.Extension} - {fileType.FileFormatName}");
}

Tutoriais Relacionados