1. IronPrint
  2. Tutoriais
  3. Defina o DPI

Como configurar oDPIde impressão em C#

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

DPI (pontos por polegada) controla a resolução da impressão — o número de pontos de tinta que uma impressora coloca por polegada de papel. MaiorDPIproduz texto mais nítido e imagens mais suaves, mas aumenta o tempo de processamento e o uso de toner.DPImais baixo imprime mais rápido e funciona bem para rascunhos internos. ConfigurarDPIprogramaticamente garante que cada trabalho de impressão atenda ao padrão de qualidade que a aplicação exige, independentemente da configuração padrão da impressora do usuário.

IronPrint expõe uma propriedade Dpi na classe PrintSettings. Configuramos com um valor inteiro, passamos as configurações para Printer.Print(), e o documento é impresso na resolução especificada. O padrão é 300 DPI, que corresponde ao padrão para impressão comercial.

Início Rápido: DefinirDPIde Impressão

  1. Instale o IronPrint via NuGet: Install-Package IronPrint
  2. Adicione using IronPrint; ao arquivo
  3. Crie um objeto PrintSettings
  4. Defina Dpi para a resolução desejada (por exemplo, 300, 600, 1200)
  5. Passe as configurações para Printer.Print() ou Printer.ShowPrintDialog()

  1. Instale IronPrint com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPrint

  2. Copie e execute este trecho de código.

    using IronPrint;

// Print a PDF at 600DPIfor high-quality output
Printer.Print("report.pdf", new PrintSettings
{
    Dpi = 600
});

  3. Implante para testar em seu ambiente de produção.

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

    arrow pointer
### Fluxo de trabalho mínimo (5 etapas)
  1. Instale a biblioteca de impressão IronPrint C#
  2. Crie um objeto `PrintSettings`
  3. Defina `Dpi` para a resolução desejada
  4. Passe as configurações para `Printer.Print()`
  5. Execute o projeto para imprimir noDPIconfigurado

Como defino oDPIde impressão em C#?

A propriedade Dpi em PrintSettings aceita qualquer inteiro positivo. O valor padrão é 300, que é a resolução padrão para documentos comerciais. ODPIreal usado para impressão pode ser limitado pelas capacidades da impressora física — se definirmos 1200DPIem uma impressora que atinge no máximo 600, a impressora usará sua resolução mais alta suportada.

:path=/static-assets/print/content-code-examples/how-to/set-the-dpi/office-and-high-res-dpi.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

Com o .NET nativo, controlar a resolução de impressão requer criar um PrintDocument, acessar DefaultPageSettings.PrinterResolution, manipular o evento PrintPage, e renderizar o conteúdo manualmente com Graphics.DrawImage(). Isso envolve 15–25 linhas de código modelo. IronPrint reduz isso a uma única propriedade de inteiro em um objeto de configurações.

QualDPIdevo usar para diferentes trabalhos de impressão?

Escolher oDPIcerto depende do tipo de conteúdo e do propósito. Resolução mais alta nem sempre é melhor — ela aumenta o tamanho do spool e o tempo de impressão sem benefício visível para documentos ricos em texto.

DPI Ideal para Notas
72–150 Rascunhos internos, provas, impressões de teste Saída rápida, baixo uso de toner
300 Documentos comerciais, faturas, relatórios Padrão IronPrint; qualidade comercial padrão
600 Materiais de marketing, gráficos, tabelas Imagens visivelmente mais nítidas e linhas finas
1200+ Fotografia, arquivo, arte fina Requer impressora compatível; arquivos de spool grandes

Para a maioria das aplicações, 300DPIoferece o melhor equilíbrio entre qualidade e desempenho. Recomendamos começar com o padrão e aumentar apenas quando a saída exigir melhoria visível na clareza da imagem ou detalhe fino.

Como combinarDPIcom outras configurações de impressão?

ODPIfunciona juntamente com outras propriedades de PrintSettings para definir um trabalho de impressão completo. Podemos configurar o tamanho do papel, orientação, margens, cópias e modo em escala de cinza no mesmo objeto.

:path=/static-assets/print/content-code-examples/how-to/set-the-dpi/combine-dpi-with-settings.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

Definir Grayscale = true em 600DPIproduz uma saída monocromática nítida que é ideal para gráficos e tabelas de dados. Os valores de PaperMargins estão em milímetros.

Como permitir que os usuários ajustem oDPIno diálogo de impressão?

Quando passamos PrintSettings para Printer.ShowPrintDialog(), o diálogo abre com nossoDPIpredefinido. O usuário pode aceitá-lo ou ajustar a resolução antes de imprimir.

:path=/static-assets/print/content-code-examples/how-to/set-the-dpi/dialog-with-dpi-preset.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

Para cenários de IU não bloqueantes, Printer.ShowPrintDialogAsync() aceita os mesmos parâmetros e mantém o aplicativo responsivo. O diálogo permite que os usuários verifiquem oDPIcontra as resoluções suportadas pela impressora antes da impressão — útil ao alternar entre um laser de escritório de 600DPIe uma impressora fotográfica de 1200 DPI. Para fluxos de trabalho totalmente automatizados onde nenhuma interação do usuário é necessária, use Printer.Print() para impressão silenciosa em vez disso.

Próximos passos

DPI é um único inteiro no objeto PrintSettings — ajuste-o para atender às exigências de qualidade de cada trabalho de impressão. Comece com 300 para documentos comerciais e aumente para 600 ou mais para saídas ricas em gráficos.

Explore o guia de configurações de impressão para cada propriedade disponível, a referência da API da classe Printer para todos os métodos disponíveis, e a página de exemplos de código para snippets prontos para uso. Os tutoriais do IronPrint percorrem todo o ciclo de vida da impressão, e o changelog acompanha as atualizações recentes.

Comece um teste gratuito de 30 dias para testar configurações deDPIem um projeto ao vivo. Quando estiver pronto, veja as opções de licenciamento começando em $749.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
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
Pronto para começar?
Nuget Downloads 38,093 | Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPrint
executar um exemplo Veja seu documento chegar à impressora.