PrintQueue 类

定义

命名空间:

System.Printing

程序集:

System.Printing.dll

管理打印机和打印作业。

public ref class PrintQueue : System::Printing::PrintSystemObject

public class PrintQueue : System.Printing.PrintSystemObject

type PrintQueue = class
    inherit PrintSystemObject

Public Class PrintQueue
Inherits PrintSystemObject

继承

Object

PrintSystemObject

PrintQueue

注解

对象的某些属性表示在计算机上运行的打印队列实用工具的特征，但其他属性 PrintQueue 表示打印机本身的特征或状态。 例如， NumberOfJobs 是打印队列的特征，但 Location 是打印机的属性。 打印机的许多属性，例如它是否需要用户注意，需要通过方法从 Refresh 打印机本身传递到 PrintQueue 对象。 应在程序读取相应的属性（NeedUserIntervention）之前执行此操作。 同样，当程序更改对象的一个或多个属性 PrintQueue 的值时，必须将更改写入计算机上的实际打印队列实用工具。 使用 Commit 该方法执行此操作。

注意

命名空间中的 System.Printing 类不支持在 Windows 服务或 ASP.NET 应用程序或服务中使用。 尝试在这些应用程序类型之一内使用这些类可能会导致意外问题，例如服务性能和运行时异常的降低。

如果要从 Windows 窗体应用程序打印，请参阅 System.Drawing.Printing 命名空间。

构造函数

名称	说明
PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)	使用指定的PrintServer、队列名称、打印架构版本和所需的访问初始化类的新实例PrintQueue。
PrintQueue(PrintServer, String, Int32)	使用指定的PrintServer、队列名称和打印架构版本初始化类的新实例PrintQueue。
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess)	使用指定的PrintServer、队列名称、要初始化的值数组PrintQueueIndexedProperty和所需的访问初始化类的新实例PrintQueue。
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])	使用要初始化的值 PrintQueue 的指定 PrintServer、队列名称和数组 PrintQueueIndexedProperty 初始化类的新实例。
PrintQueue(PrintServer, String, PrintSystemDesiredAccess)	使用指定的PrintServer队列名称和所需的访问初始化类的新实例PrintQueue。
PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess)	使用指定的PrintServer、队列名称、属性筛选器和所需的访问初始化类的新实例PrintQueue。
PrintQueue(PrintServer, String, String[])	使用要初始化的属性 PrintQueue 名称的指定 PrintServer、队列名称和数组初始化类的新实例。
PrintQueue(PrintServer, String)	使用指定的PrintServer和队列名称初始化类的新实例PrintQueue。

属性

名称	说明
AveragePagesPerMinute	获取以每分钟页为单位的打印机的速度。
ClientPrintSchemaVersion	获取 打印架构的版本。
Comment	获取或设置有关打印机的注释。
CurrentJobSettings	获取一个对象，该对象包含当前打印作业的配置设置。
DefaultPrintTicket	获取或设置与此 PrintQueue关联的默认打印机选项。
DefaultPriority	获取或设置分配给添加到队列的每个新打印作业的默认优先级。
Description	获取打印队列的说明。
FullName	获取队列的完整名称。
HasPaperProblem	获取一个值，该值指示打印机是否遇到未指定的纸张问题。
HasToner	获取一个值，该值指示打印机是否具有墨盒。
HostingPrintServer	获取或设置控制打印队列的打印服务器（受保护）。
InPartialTrust	获取或设置一个值，该值指示队列是否在部分信任模式下运行，这是更高的信任级别。
IsBidiEnabled	获取一个值，该值指示是否启用与打印机的双向通信。
IsBusy	获取一个值，该值指示打印设备是否繁忙。
IsDevQueryEnabled	获取一个值，该值指示当文档和打印机配置不匹配时队列是否保存文档。
IsDirect	获取一个值，该值指示队列是直接打印到打印机还是后台处理程序文档，然后打印它们。
IsDisposed	获取或设置一个值，该值指示对象是否已释放。 (继承自 PrintSystemObject)
IsDoorOpened	获取一个值，该值指示是否在打印机上打开门。
IsHidden	获取一个值，该值指示打印队列是否隐藏在应用程序的用户界面中。
IsInError	获取一个值，该值指示打印机或设备是否处于错误状态。
IsInitializing	获取一个值，该值指示打印机是否正在初始化自身。
IsIOActive	获取一个值，该值指示打印机是接收还是发送数据或信号。
IsManualFeedRequired	获取一个值，该值指示打印机是否需要为当前打印作业手动送纸。
IsNotAvailable	获取一个值，该值指示打印机是否可用。
IsOffline	获取一个值，该值指示打印机是否处于脱机状态。
IsOutOfMemory	获取一个值，该值指示打印机是否内存不足。
IsOutOfPaper	获取一个值，该值指示是否需要使用当前作业所需的纸张重新加载打印机。
IsOutputBinFull	获取一个值，该值指示打印机的输出区域是否处于溢出危险之中。
IsPaperJammed	获取一个值，该值指示当前纸张是否卡在打印机中。
IsPaused	获取一个值，该值指示打印队列是否已暂停。
IsPendingDeletion	获取一个值，该值指示打印机是否正在删除打印作业。
IsPowerSaveOn	获取一个值，该值指示打印机是否处于节能模式。
IsPrinting	获取一个值，该值指示作业是否正在打印。
IsProcessing	获取一个值，该值指示打印机是否正在处理打印作业。
IsPublished	获取一个值，该值指示打印机是否对其他网络用户可见。
IsQueued	获取一个值，该值指示打印机是否可以一次支持包含多个打印作业的队列。
IsRawOnlyEnabled	获取一个值，该值指示打印队列是否可以使用 EMF（增强的元文件），以便更快地从打印应用程序流向 Windows 后台处理程序。
IsServerUnknown	获取一个值，该值指示打印机是否处于错误状态。
IsShared	获取一个值，该值指示打印机是否可供网络上的其他计算机使用。
IsTonerLow	获取一个值，该值指示打印机是否运行不足的墨盒。
IsWaiting	获取一个值，该值指示队列是否正在等待添加作业。
IsWarmingUp	获取一个值，该值指示打印机是否正在预热。
IsXpsDevice	获取一个值，该值指示打印机的驱动程序是否基于 XPSDrv 模型 生成，以便它使用 XML 纸张规范（XPS）作为其页面说明语言。
KeepPrintedJobs	获取一个值，该值指示队列是否正在保存打印机语言文件，而不是在打印后删除它。
Location	获取或设置打印机的物理位置。
MaxPrintSchemaVersion	获取队列可以使用的 打印架构 的最新版本号。
Name	获取或设置打印队列的名称。
NeedUserIntervention	获取一个值，该值指示打印机是否需要人的注意。
NumberOfJobs	获取打印队列中排队的作业总数。
PagePunt	获取一个值，该值指示打印机是否无法打印当前页。
Parent	获取该对象的父级。 (继承自 PrintSystemObject)
PrintingIsCancelled	获取或设置一个值，该值指示当前打印作业是否正在取消。
Priority	获取或设置打印队列相对于同一打印服务器托管的其他打印队列以及使用相同的物理打印机的打印队列的优先级。
PropertiesCollection	获取特性和值对的集合。 (继承自 PrintSystemObject)
QueueAttributes	获取打印队列的属性。
QueueDriver	获取或设置队列的打印机驱动程序。
QueuePort	获取或设置队列使用的端口。
QueuePrintProcessor	获取或设置队列使用的打印处理器。
QueueStatus	获取一个值，该值表示打印机的状态。 其中包括“预热”、“初始化”、“打印”等。
ScheduleCompletedJobsFirst	获取一个值，该值指示打印机是否打印在作业之前已完成后台处理程序的作业，即使后者先进入队列，还是具有更高的优先级。
SeparatorFile	获取或设置在每个打印作业的开头插入的文件的路径和文件名。
ShareName	获取或设置共享时网络上的用户看到的打印机的名称。
StartTimeOfDay	获取或设置一天中的最早时间，表示为午夜协调世界时（UTC）（也称为格林威治时间[GMT]）后的分钟数，打印机将打印作业。
UntilTimeOfDay	获取或设置最新时间，表示为午夜协调世界时（UTC）（也称为格林威治标准时间 [GMT]）后的分钟数，打印机将打印作业。
UserPrintTicket	获取或设置当前用户的默认 PrintTicket 对象，该对象包含有关打印作业的详细信息。

方法

名称	说明
AddJob()	将新的（一般命名）打印作业（其内容为 Byte 数组）插入队列。
AddJob(String, PrintTicket)	将 XML 纸张规范 （XPS） 文档的新打印作业插入队列中，并为其指定名称和设置。
AddJob(String, String, Boolean, PrintTicket)	将 XML 纸张规范（XPS）文档的新打印作业插入队列，为其指定名称和设置，并指定是否应对其进行验证。
AddJob(String, String, Boolean)	将 XML 纸张规范（XPS）文档的新打印作业插入队列中，为其指定名称，并指定是否应对其进行验证。
AddJob(String)	将一个新的打印作业（其内容为 Byte 数组）插入队列。
Commit()	将对象的当前属性 PrintQueue 写入打印服务器上的实际打印队列。
CreateXpsDocumentWriter(Double, Double)	XpsDocumentWriter创建具有指定维度的对象。
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	创建对象 XpsDocumentWriter ，打开 Windows 通用打印对话框，为对话框提供页面范围和打印作业的说明，并返回一个 ref （ByRef 在 Visual Basic 中）参数，该参数表示有关可图像区域和媒体尺寸的信息。
CreateXpsDocumentWriter(PrintDocumentImageableArea)	创建一个 XpsDocumentWriter 对象，打开一个 Windows 通用打印对话框，并返回一个 ref （ByRef 在 Visual Basic 中）参数，该参数表示有关可图像区域和媒体尺寸的信息。
CreateXpsDocumentWriter(PrintQueue)	创建一个 XpsDocumentWriter 对象并将其与指定的打印队列相关联。
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	创建一个对象，打开一个 XpsDocumentWriter Windows 通用打印对话框，提供一个页面范围对话框，并返回一个 ref （ByRef 在 Visual Basic 中）参数，该参数表示有关可图像区域和媒体尺寸的信息。
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	创建一个 XpsDocumentWriter 对象，打开一个 Windows 通用打印对话框（并为其提供作业说明），并返回一个 ref （ByRef 在 Visual Basic 中）参数，该参数表示有关可图像区域和媒体尺寸的信息。
Dispose()	释放该 PrintSystemObject命令使用的所有资源。 (继承自 PrintSystemObject)
Dispose(Boolean)	释放由托管资源使用 PrintSystemObject 的非托管资源，并选择性地释放托管资源。 (继承自 PrintSystemObject)
GetJob(Int32)	获取具有指定 ID 号的打印作业。
GetPrintCapabilities()	获取一个 PrintCapabilities 对象，该对象标识打印机的功能。
GetPrintCapabilities(PrintTicket)	获取一个 PrintCapabilities 对象，该对象标识打印机的功能。
GetPrintCapabilitiesAsXml()	获取一个 MemoryStream 对象，该对象将打印机的功能指定为符合 打印架构的 XML 流。
GetPrintCapabilitiesAsXml(PrintTicket)	获取一个 MemoryStream 对象，该对象以符合 打印架构的 XML 格式指定打印机的功能。
GetPrintJobInfoCollection()	创建一个集合，其中包含 PrintSystemJobInfo 队列中每个作业的对象。
Initialize()	初始化 . 的属性PrintSystemObject (继承自 PrintSystemObject)
InternalDispose(Boolean)	释放由托管资源使用 PrintQueue 的非托管资源，并选择性地释放托管资源。
MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)	合并两 PrintTicket个 s 并保证结果 PrintTicket 有效，不要求打印机不支持的任何打印功能，并且仅限于指定的范围。
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)	合并两 PrintTicket个 s 并保证结果 PrintTicket 有效，并且不要求打印机不支持的任何打印功能。
Pause()	暂停打印队列。 它保持暂停，直到 Resume() 执行。
Purge()	删除打印队列中的所有作业。
Refresh()	使用打印机中的值和计算机上运行的打印队列实用工具更新对象的属性 PrintQueue 。
Resume()	重启已暂停的打印队列。

另请参阅

• PrintServer