1. IronPrint
  2. Tutoriais
  3. Defina Número de Cópias

Como Definir o Número de Cópias ao Imprimir em C#

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

Imprimir múltiplas cópias de um documento é um requisito rotineiro — faturas que necessitam de original e cópia, etiquetas de envio impressas em lotes, ou relatórios distribuídos para vários departamentos. Em vez de chamar Print() dentro de um loop e criar trabalhos de impressão separados para cada cópia, a abordagem correta é definir a contagem de cópias uma vez e deixar o driver da impressora lidar com a duplicação em um único trabalho.

A propriedade PrintSettings.NumberOfCopies do IronPrint aceita um número inteiro e envia o número especificado de cópias para a impressora em uma operação. Cobrimos instalação, uso básico, fluxos de trabalho assíncronos e configurações combinadas abaixo.

Início Rápido: Definir Número de Cópias

  1. Instale o IronPrint via NuGet: Install-Package IronPrint
  2. Adicione using IronPrint; ao arquivo
  3. Crie um objeto PrintSettings
  4. Defina NumberOfCopies para a contagem desejada
  5. Passe as configurações para Printer.Print() com o caminho do arquivo

  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 3 copies of a PDF in one print job
PrintSettings settings = new PrintSettings();
settings.NumberOfCopies = 3;
Printer.Print("invoice.pdf", settings);

  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 `NumberOfCopies` para a contagem desejada
  4. Passe as configurações para `Printer.Print()`
  5. Verifique se a impressora produz o número correto de cópias

Como defino a contagem de cópias para impressão silenciosa?

A impressão silenciosa envia um documento diretamente para a impressora sem exibir uma caixa de diálogo. Configuramos a contagem de cópias através do PrintSettings.NumberOfCopies e passamos as configurações para Printer.Print():

:path=/static-assets/print/content-code-examples/how-to/set-number-of-copies/silent-copies.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

O driver da impressora recebe a instrução de cópia em nível de hardware, o que é mais rápido e confiável do que enfileirar cinco trabalhos individuais. Isso é importante em impressoras de rede compartilhada onde trabalhos separados podem ser intercalados com documentos de outros usuários.

NumberOfCopies por padrão é 1 quando não explicitamente definido. Qualquer número inteiro positivo é aceito — defini-lo como 0 ou um valor negativo não tem efeito prático e o driver retorna para uma única cópia.

Como combino a contagem de cópias com outras configurações de impressão?

NumberOfCopies é uma propriedade em PrintSettings. Podemos combiná-lo com margens de papel, tamanho do papel, orientação, DPI, modo em escala de cinza e seleção de impressora em um único objeto de configuração:

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

Para fluxos de trabalho não bloqueantes, passe o mesmo PrintSettings para Printer.PrintAsync() em vez disso.

Existem limitações de plataforma na contagem de cópias?

Em certas plataformas, o driver da impressora pode não reproduzir o número exato especificado em NumberOfCopies. A documentação do IronPrint observa que limitações específicas da plataforma podem fazer com que o valor seja ignorado, resultando em uma única cópia. Esta é uma restrição em nível de driver, não uma limitação do IronPrint.

Em aplicativos de desktop Windows — o principal alvo para a maioria dos fluxos de trabalho de impressão — NumberOfCopies é respeitado de forma confiável por impressoras locais e de rede. Se você encontrar uma impressora que sistematicamente ignora a configuração, verifique se o driver dela suporta trabalhos de cópia múltipla colacionados através do painel de propriedades de impressoras do Windows.

Quais são os meus próximos passos?

Cobrimos como definir o número de cópias impressas usando PrintSettings.NumberOfCopies, demonstramos impressão silenciosa e assíncrona, combinamos a contagem de cópias com outras configurações e observamos advertências específicas para plataformas.

Para leitura adicional, explore estes recursos:

Obtenha uma licença de teste gratuita para testar cada recurso em um ambiente ao vivo, ou veja as opções de licenciamento quando estiver pronto para implantar.

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.