Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Como: programaticamente imprimir arquivos XPS

 

Publicado: junho de 2016

Você pode usar uma sobrecarga do AddJob método imprimir XPS (XML Paper Specification) arquivos sem abrir uma PrintDialog ou, em princípio, qualquer UI (interface do usuário) todo.

Você também pode imprimir XPS (XML Paper Specification) arquivos usando os muitos Write e WriteAsync métodos de XpsDocumentWriter. Para obter mais informações sobre isso, Imprimir um documento XPS.

Outra maneira de impressão XPS (XML Paper Specification) é usar oPrintDocument ou PrintVisual métodos de PrintDialog controle. Consulte Como: chamar um diálogo de impressão.

Exemplo

As etapas principais para usar o parâmetro de três AddJob(String, String, Boolean) método são os seguintes. O exemplo a seguir fornece detalhes.

  1. Determine se a impressora é uma impressora XPSDrv. (Consulte Visão geral de impressão para obter mais informações sobre XPSDrv.)

  2. Se a impressora não é uma impressora XPSDrv, defina o apartment do thread como thread único.

  3. Criar uma instância de um servidor de impressão e um objeto de fila de impressão.

  4. Chame o método, especificando um nome de trabalho, o arquivo a ser impresso e um Boolean Sinalizador que indica se a impressora é uma impressora XPSDrv ou não.

O exemplo a seguir mostra como imprimir todos em lote XPS arquivos em um diretório. Embora o aplicativo solicite ao usuário especificar o diretório, o parâmetro de três AddJob(String, String, Boolean) método não requer um UI (interface do usuário). Ele pode ser usado em qualquer caminho de código onde você tem uma XPS nome de arquivo e caminho que você pode passar para ele.

O parâmetro de três AddJob(String, String, Boolean) sobrecarga de AddJob deve ser executado em um single thread apartment sempre que o Boolean parâmetro é false, que deve ser quando uma impressora não-XPSDrv está sendo usada. No entanto, o estado apartment padrão Microsoft .NET é de vários threads. Esse padrão deve ser revertido já que o exemplo supõe uma impressora não-XPSDrv.

Há duas maneiras de alterar o padrão. Uma maneira é simplesmente adicionar o STAThreadAttribute (ou seja, "[System.STAThreadAttribute()]") apenas acima da primeira linha do aplicativo Main método (normalmente "static void Main(string[] args)"). No entanto, muitos aplicativos exigem que o Main método tem um estado de apartment multissegmentado, portanto, há um segundo método: colocar a chamada para AddJob(String, String, Boolean) em um thread separado cujo estado apartment é definido como STA com SetApartmentState. O exemplo a seguir usa essa segunda técnica.

Da mesma forma, o exemplo começa por instanciar um Thread objeto e passá-lo um PrintXPS método como o ThreadStart parâmetro. (O PrintXPS método é definido posteriormente no exemplo.) Em seguida, o thread é definido como um apartamento de thread único. O código restante somente do Main método inicia o novo thread.

É a parte principal do exemplo no staticBatchXPSPrinter.PrintXPS método. Depois de criar um servidor de impressão e fila, o método solicita ao usuário um diretório que contém XPS arquivos. Após validar a existência do diretório e a presença de arquivos *. xps nele, o método adiciona cada arquivo para a fila de impressão. O exemplo pressupõe que a impressora é não-XPSDrv, portanto, passa false para o último parâmetro de AddJob(String, String, Boolean) método. Por esse motivo, o método validará o XPS marcação no arquivo antes de tentar convertê-lo em linguagem de descrição de página da impressora. Se a validação falhar, uma exceção é lançada. O código de exemplo capturar a exceção, notificar o usuário sobre ela e, em seguida, vá para processar o próximo XPS arquivo.

class Program
{
    [System.MTAThreadAttribute()] // Added for clarity, but this line is redundant because MTA is the default.
    static void Main(string[] args)
    {
        // Create the secondary thread and pass the printing method for 
        // the constructor's ThreadStart delegate parameter. The BatchXPSPrinter
        // class is defined below.
        Thread printingThread = new Thread(BatchXPSPrinter.PrintXPS);

        // Set the thread that will use PrintQueue.AddJob to single threading.
        printingThread.SetApartmentState(ApartmentState.STA);

        // Start the printing thread. The method passed to the Thread 
        // constructor will execute.
        printingThread.Start();

    }//end Main

}//end Program class

public class BatchXPSPrinter
{
    public static void PrintXPS()
    {
        // Create print server and print queue.
        LocalPrintServer localPrintServer = new LocalPrintServer();
        PrintQueue defaultPrintQueue = LocalPrintServer.GetDefaultPrintQueue();

        // Prompt user to identify the directory, and then create the directory object.
        Console.Write("Enter the directory containing the XPS files: ");
        String directoryPath = Console.ReadLine();
        DirectoryInfo dir = new DirectoryInfo(directoryPath);

        // If the user mistyped, end the thread and return to the Main thread.
        if (!dir.Exists)
        {
            Console.WriteLine("There is no such directory.");
        }
        else
        {
            // If there are no XPS files in the directory, end the thread 
            // and return to the Main thread.
            if (dir.GetFiles("*.xps").Length == 0)
            {
                Console.WriteLine("There are no XPS files in the directory.");
            }
            else
            {
                Console.WriteLine("\nJobs will now be added to the print queue.");
                Console.WriteLine("If the queue is not paused and the printer is working, jobs will begin printing.");

                // Batch process all XPS files in the directory.
                foreach (FileInfo f in dir.GetFiles("*.xps"))
                {
                    String nextFile = directoryPath + "\\" + f.Name;
                    Console.WriteLine("Adding {0} to queue.", nextFile);

                    try
                    {
                        // Print the Xps file while providing XPS validation and progress notifications.
                        PrintSystemJobInfo xpsPrintJob = defaultPrintQueue.AddJob(f.Name, nextFile, false);
                    }
                    catch (PrintJobException e)
                    {
                        Console.WriteLine("\n\t{0} could not be added to the print queue.", f.Name);
                        if (e.InnerException.Message == "File contains corrupted data.")
                        {
                            Console.WriteLine("\tIt is not a valid XPS file. Use the isXPS Conformance Tool to debug it.");
                        }
                        Console.WriteLine("\tContinuing with next XPS file.\n");
                    }

                }// end for each XPS file

            }//end if there are no XPS files in the directory

        }//end if the directory does not exist

        Console.WriteLine("Press Enter to end program.");
        Console.ReadLine();

    }// end PrintXPS method

}// end BatchXPSPrinter class

Se você estiver usando uma impressora XPSDrv, você pode definir o parâmetro final true. Nesse caso, desde XPS é a linguagem de descrição de página da impressora, o método será enviar o arquivo para a impressora sem validá-lo ou convertê-lo para outra linguagem de descrição de página. Se você não tiver certeza em tempo de design se o aplicativo usará uma impressora XPSDrv, você pode modificar o aplicativo para que ele leia o IsXpsDevice propriedade e ramificação de acordo com o que encontrar.

Como inicialmente haverá poucas impressoras XPSDrv disponíveis imediatamente após o lançamento do Windows Vista e Microsoft .NET Framework, talvez você precise disfarçar uma impressora não-XPSDrv como uma impressora XPSDrv. Para fazer isso, adicione Pipelineconfig. XML para a lista de arquivos na seguinte chave do registro do computador que executa o aplicativo:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print\Environments\Windows NT x86\Drivers\Version-3 \< PseudoXPSPrinter >\DependentFiles

onde < PseudoXPSPrinter > é qualquer fila de impressão. A máquina, em seguida, deve ser reinicializada.

Este disfarce permitirá que você passe true como o parâmetro final de AddJob(String, String, Boolean) sem causar uma exceção, mas como < PseudoXPSPrinter > não é realmente uma impressora XPSDrv, somente lixo será impresso.

Observação   para simplificar, o exemplo acima usa a presença de uma extensão *. XPS como seu teste que um arquivo é XPS. No entanto, XPS arquivos não precisam ter essa extensão. O isXPS.exe (conformidade isXPS) é uma maneira de testar um arquivo para XPS validade.

Mostrar: