docs-desktop/dotnet-desktop-guide/net/wpf/documents/how-to-print-xps-files.md

title, description, ms.date, dev_langs, helpviewer_keywords

title	description	ms.date	dev_langs	helpviewer_keywords
How to print an XML Paper Specification (XPS) file	Learn how to print an XPS file from your application by using the System.Printing.PrintQueue.AddJob method.	09/16/2021	csharp vb	programmatically print xps files [WPF]

How to print an XPS file (WPF .NET)

Sometimes you'll want to add a new print job to the print queue without opening a print dialog box. You can use one of the xref:System.Printing.PrintQueue.AddJob%2A?displayProperty=nameWithType methods to do that. Here's how.

[!INCLUDE desktop guide under construction]

In the following example, we use the xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29 method, one of the several overloads of AddJob, to:

• Add a new print job for an XML Paper Specification (XPS) document into the default print queue.
• Name the new job.
• Specify whether the XPS document should be validated (by using the fastCopy parameter).

When using the AddJob(String, String, Boolean) method, the value of the fastCopy parameter is a key consideration:

• If you set the fastCopy parameter to true, then XPS validation is skipped and the print job will spool quickly without page-by-page progress feedback.
• If you set the fastCopy parameter to false, then the thread that calls the AddJob method must have a single-threaded apartment state, otherwise an exception will be thrown. For more information, see the Remarks section for xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29.

Add new print jobs to the queue

This example adds one or more XPS documents to the default queue. The code will:

1. Use xref:System.Threading.Tasks.Task.Run%2A?displayProperty=nameWithType to avoid blocking the UI thread—since there's no async version of AddJob.
2. If the fastCopy parameter value is false, run xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29 on a thread with single-threaded apartment state.
3. Get a reference to the default xref:System.Printing.PrintQueue of the xref:System.Printing.LocalPrintServer.
4. Call AddJob(String, String, Boolean) on the print queue reference, passing in a job name, an XPS document path, and the fastCopy parameter.

If the queue isn't paused and the printer is working, then a print job will automatically begin printing when it reaches the top of the print queue.

Tip

To avoid the Save Output File As dialog when adding a print job to the default queue, ensure that your default printer isn't Microsoft XPS Document Writer, Microsoft Print to PDF, or other print-to-file options.

:::code language="csharp" source="./snippets/how-to-print-xps-files/csharp/MainWindow.xaml.cs" id="SampleCode1"::: :::code language="vb" source="./snippets/how-to-print-xps-files/vb/MainWindow.xaml.vb" id="SampleCode1":::

Tip

You can also print XPS files by using:

• xref:System.Windows.Controls.PrintDialog.PrintDocument%2A?displayProperty=nameWithType or xref:System.Windows.Controls.PrintDialog.PrintVisual%2A?displayProperty=nameWithType methods.
• xref:System.Windows.Xps.XpsDocumentWriter.Write%2A?displayProperty=nameWithType and xref:System.Windows.Xps.XpsDocumentWriter.WriteAsync%2A?displayProperty=nameWithType methods.

For more information, see How to display a print dialog box and Printing documents overview.

See also

• xref:System.Printing.PrintQueue.AddJob%2A?displayProperty=nameWithType
• Documents in WPF
• How to display a print dialog box
• Printing documents overview