Aracılığıyla paylaş

XPS dosyası yazdırma (WPF .NET)

  • Makale

Bazen yazdırma iletişim kutusunu açmadan yazdırma kuyruğuna yeni bir yazdırma işi eklemek isteyebilirsiniz. Bunu yapmak için yöntemlerden birini PrintQueue.AddJob kullanabilirsiniz. Bunu nasıl yapacağınızı buradan öğrenebilirsiniz.

Aşağıdaki örnekte, öğesinin AddJob(String, String, Boolean) çeşitli aşırı yüklemelerinden AddJobbiri olan yöntemini kullanarak şunları yaparız:

  • Xml Kağıt Belirtimi (XPS) belgesi için varsayılan yazdırma kuyruğuna yeni bir yazdırma işi ekleyin.
  • Yeni işi adlandırın.
  • XPS belgesinin doğrulanıp doğrulanmayacağını belirtin (parametresini fastCopy kullanarak).

yöntemi kullanılırken AddJob(String, String, Boolean) parametresinin fastCopy değeri önemli bir noktadır:

  • parametresini fastCopy olarak trueayarlarsanız, XPS doğrulaması atlanır ve yazdırma işi sayfa sayfa ilerleme geri bildirimi olmadan hızla biriktirilir.
  • parametresini fastCopy falseolarak ayarlarsanız, yöntemini çağıran AddJob iş parçacığının tek iş parçacıklı bir daire durumuna sahip olması gerekir, aksi takdirde bir özel durum oluşturulur. Daha fazla bilgi için AddJob(String, String, Boolean)için Açıklamalar bölümüne bakın.

Kuyruğa yeni yazdırma işleri ekleme

Bu örnek, varsayılan kuyruğa bir veya daha fazla XPS belgesi ekler. Kod:

  1. kullanıcı arabirimi iş parçacığını engellemekten kaçınmak için kullanın Task.Run ; çünkü zaman uyumsuz sürümü AddJobyoktur.
  2. fastCopy Parametre değeri isefalse, tek iş parçacıklı daire durumuna sahip bir iş parçacığı üzerinde çalıştırınAddJob(String, String, Boolean).
  3. varsayılanı PrintQueue LocalPrintServeriçin bir başvuru alın.
  4. Bir iş adı, bir XPS belge yolu ve parametresini geçirerek yazdırma kuyruğu başvurusunda çağrısıAddJob(String, String, Boolean).fastCopy

Kuyruk duraklatılmıyorsa ve yazıcı çalışıyorsa yazdırma işi yazdırma kuyruğunun en üstüne ulaştığında otomatik olarak yazdırmaya başlar.

İpucu

Varsayılan kuyruğa yazdırma işi eklerken Çıktı Dosyasını Farklı Kaydet iletişim kutusunun olmaması için, varsayılan yazıcınızın Microsoft XPS Belge Yazıcısı, Microsoft PDF'ye Yazdır veya diğer dosyaya yazdır seçenekleri olmadığından emin olun.

/// <summary>
/// Asyncronously, add a batch of XPS documents to the print queue using a PrintQueue.AddJob method.
/// Handle the thread apartment state required by the PrintQueue.AddJob method.
/// </summary>
/// <param name="xpsFilePaths">A collection of XPS documents.</param>
/// <param name="fastCopy">Whether to validate the XPS documents.</param>
/// <returns>Whether all documents were added to the print queue.</returns>
public static async Task<bool> BatchAddToPrintQueueAsync(IEnumerable<string> xpsFilePaths, bool fastCopy = false)
{
    bool allAdded = true;

    // Queue some work to run on the ThreadPool.
    // Wait for completion without blocking the calling thread.
    await Task.Run(() =>
    {
        if (fastCopy)
            allAdded = BatchAddToPrintQueue(xpsFilePaths, fastCopy);
        else
        {
            // Create a thread to call the PrintQueue.AddJob method.
            Thread newThread = new(() =>
            {
                allAdded = BatchAddToPrintQueue(xpsFilePaths, fastCopy);
            });

            // Set the thread to single-threaded apartment state.
            newThread.SetApartmentState(ApartmentState.STA);

            // Start the thread.
            newThread.Start();

            // Wait for thread completion. Blocks the calling thread,
            // which is a ThreadPool thread.
            newThread.Join();
        }
    });

    return allAdded;
}

/// <summary>
/// Add a batch of XPS documents to the print queue using a PrintQueue.AddJob method.
/// </summary>
/// <param name="xpsFilePaths">A collection of XPS documents.</param>
/// <param name="fastCopy">Whether to validate the XPS documents.</param>
/// <returns>Whether all documents were added to the print queue.</returns>
public static bool BatchAddToPrintQueue(IEnumerable<string> xpsFilePaths, bool fastCopy)
{
    bool allAdded = true;

    // To print without getting the "Save Output File As" dialog, ensure
    // that your default printer is not the Microsoft XPS Document Writer,
    // Microsoft Print to PDF, or other print-to-file option.

    // Get a reference to the default print queue.
    PrintQueue defaultPrintQueue = LocalPrintServer.GetDefaultPrintQueue();

    // Iterate through the document collection.
    foreach (string xpsFilePath in xpsFilePaths)
    {
        // Get document name.
        string xpsFileName = Path.GetFileName(xpsFilePath);

        try
        {
            // The AddJob method adds a new print job for an XPS
            // document into the print queue, and assigns a job name.
            // Use fastCopy to skip XPS validation and progress notifications.
            // If fastCopy is false, the thread that calls PrintQueue.AddJob
            // must have a single-threaded apartment state.
            PrintSystemJobInfo xpsPrintJob =
                    defaultPrintQueue.AddJob(jobName: xpsFileName, documentPath: xpsFilePath, fastCopy);

            // If the queue is not paused and the printer is working, then jobs will automatically begin printing.
            Debug.WriteLine($"Added {xpsFileName} to the print queue.");
        }
        catch (PrintJobException e)
        {
            allAdded = false;
            Debug.WriteLine($"Failed to add {xpsFileName} to the print queue: {e.Message}\r\n{e.InnerException}");
        }
    }

    return allAdded;
}

''' <summary>
''' Asyncronously, add a batch of XPS documents to the print queue using a PrintQueue.AddJob method.
''' Handle the thread apartment state required by the PrintQueue.AddJob method.
''' </summary>
''' <param name="xpsFilePaths">A collection of XPS documents.</param>
''' <param name="fastCopy">Whether to validate the XPS documents.</param>
''' <returns>Whether all documents were added to the print queue.</returns>
Public Shared Async Function BatchAddToPrintQueueAsync(xpsFilePaths As IEnumerable(Of String), Optional fastCopy As Boolean = False) As Task(Of Boolean)

    Dim isAllPrinted As Boolean = True

    ' Queue some work to run on the ThreadPool.
    ' Wait for completion without blocking the calling thread.
    Await Task.Run(
        Sub()
            If fastCopy Then
                isAllPrinted = BatchAddToPrintQueue(xpsFilePaths, fastCopy)
            Else
                ' Create a thread to call the PrintQueue.AddJob method.
                Dim newThread As New Thread(
                    Sub()
                        isAllPrinted = BatchAddToPrintQueue(xpsFilePaths, fastCopy)
                    End Sub
                )

                ' Set the thread to single-threaded apartment state.
                newThread.SetApartmentState(ApartmentState.STA)

                ' Start the thread.
                newThread.Start()

                ' Wait for thread completion. Blocks the calling thread,
                ' which is a ThreadPool thread.
                newThread.Join()
            End If
        End Sub
    )

    Return isAllPrinted

End Function

''' <summary>
''' Add a batch of XPS documents to the print queue using a PrintQueue.AddJob method.
''' </summary>
''' <param name="xpsFilePaths">A collection of XPS documents.</param>
''' <param name="fastCopy">Whether to validate the XPS documents.</param>
''' <returns>Whether all documents were added to the print queue.</returns>
Public Shared Function BatchAddToPrintQueue(xpsFilePaths As IEnumerable(Of String), fastCopy As Boolean) As Boolean

    Dim isAllPrinted As Boolean = True

    ' To print without getting the "Save Output File As" dialog, ensure
    ' that your default printer is not the Microsoft XPS Document Writer,
    ' Microsoft Print to PDF, or other print-to-file option.

    ' Get a reference to the default print queue.
    Dim defaultPrintQueue As PrintQueue = LocalPrintServer.GetDefaultPrintQueue()

    ' Iterate through the document collection.
    For Each xpsFilePath As String In xpsFilePaths

        ' Get document name.
        Dim xpsFileName As String = Path.GetFileName(xpsFilePath)

        Try
            ' The AddJob method adds a new print job for an XPS
            ' document into the print queue, and assigns a job name.
            ' Use fastCopy to skip XPS validation and progress notifications.
            ' If fastCopy is false, the thread that calls PrintQueue.AddJob
            ' must have a single-threaded apartment state.
            Dim xpsPrintJob As PrintSystemJobInfo = defaultPrintQueue.AddJob(jobName:=xpsFileName, documentPath:=xpsFilePath, fastCopy)

            ' If the queue is not paused and the printer is working, then jobs will automatically begin printing.
            Debug.WriteLine($"Added {xpsFileName} to the print queue.")
        Catch e As PrintJobException
            isAllPrinted = False
            Debug.WriteLine($"Failed to add {xpsFileName} to the print queue: {e.Message}\r\n{e.InnerException}")
        End Try
    Next

    Return isAllPrinted

End Function

İpucu

XpS dosyalarını aşağıdakini kullanarak da yazdırabilirsiniz:

Daha fazla bilgi için bkz . Yazdırma iletişim kutusunu görüntüleme ve Belgeleri yazdırmaya genel bakış.

Ayrıca bkz.