This documentation is archived and is not being maintained.

PrinterSettings.PrintToFile Property

Gets or sets a value indicating whether the printing output is sent to a file instead of a port.

Namespace:  System.Drawing.Printing
Assembly:  System.Drawing (in System.Drawing.dll)

public bool PrintToFile { get; set; }

Property Value

Type: System.Boolean
true if the printing output is sent to a file; otherwise, false. The default is false.

The PrintToFile property is used by the PrintDialog when the user selects the Print to file option. In such a case, the output port is set to "FILE," causing the Windows printing subsystem to prompt the user for a file name when the PrintDocument.Print method is called.


The PrintToFile property is only used by the PrintDialog and cannot be set programmatically. The Print to file option only appears on the PrintDialog when the PrintDialog.AllowPrintToFile property is set to true.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0