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)	使用指定的 PrintQueue 和队列名称初始化 PrintServer 类的一个新实例。
PrintQueue(PrintServer, String, Int32)	使用指定 PrintQueue、队列名称和打印架构版本初始化 PrintServer 类的一个新实例。
PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)	使用指定的 PrintQueue、队列名称、打印架构版本和所需访问初始化 PrintServer 类的一个新实例。
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])	使用指定的 PrintQueue、队列名称和要初始化的 PrintServer 值的数组初始化 PrintQueueIndexedProperty 类的一个新实例。
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess)	使用指定的 PrintQueue、队列名称、要初始化的 PrintServer 值的数组和所需的访问初始化 PrintQueueIndexedProperty 类的一个新实例。
PrintQueue(PrintServer, String, PrintSystemDesiredAccess)	使用指定 PrintQueue、队列名称和所需访问初始化 PrintServer 类的一个新实例。
PrintQueue(PrintServer, String, String[])	使用指定 PrintQueue、队列名称和要初始化的属性名称的数组初始化 PrintServer 类的一个新实例。
PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess)	使用指定的 PrintQueue、队列名称、属性过滤器和所需访问初始化 PrintServer 类的一个新实例。

属性

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)	将一个内容为 Byte 数组的新打印作业插入到队列中。
AddJob(String, PrintTicket)	将 XML 纸张规范的新打印作业 (XPS) Document 插入队列，并为其指定名称和设置。
AddJob(String, String, Boolean)	将 XML 纸张规范 (XPS) Document 的新打印作业插入队列，为其指定名称，并指定是否应对其进行验证。
AddJob(String, String, Boolean, PrintTicket)	将 XML 纸张规范的新打印作业 (XPS) Document 插入队列，为其指定名称和设置，并指定是否应对其进行验证。
Commit()	将 PrintQueue 对象的当前属性写入打印服务器上的实际打印队列中。
CreateXpsDocumentWriter(Double, Double)	创建具有指定维度的 XpsDocumentWriter 对象。
CreateXpsDocumentWriter(PrintDocumentImageableArea)	创建 XpsDocumentWriter 对象，打开 Windows 通用打印对话框并返回 ref（Visual Basic 中为 ByRef）参数，该参数表示有关可绘制区域和介质维度的信息。
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	创建 XpsDocumentWriter 对象，打开 Windows 通用打印对话框，为对话框提供页面范围和打印作业说明，并返回 ref（Visual Basic 中为 ByRef）参数，该参数表示有关可绘制区域和介质维度的信息。
CreateXpsDocumentWriter(PrintQueue)	创建一个 XpsDocumentWriter 对象并将其与指定的打印队列关联。
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	创建 XpsDocumentWriter 对象，打开 Windows 通用打印对话框（同时为其提供一个作业说明）并返回 ref（Visual Basic 中为 ByRef）参数，该参数表示有关可绘制区域和介质维度的信息。
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	创建 XpsDocumentWriter 对象，打开 Windows 通用打印对话框，为对话框提供一个页面范围并返回 ref（Visual Basic 中为 ByRef）参数，该参数表示有关可绘制区域和介质维度的信息。
Dispose()	释放由 PrintSystemObject 使用的所有资源。 (继承自 PrintSystemObject)
Dispose(Boolean)	释放由 PrintSystemObject 占用的非托管资源，还可以另外再释放托管资源。 (继承自 PrintSystemObject)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetJob(Int32)	获取具有指定 ID 号的打印作业。
GetPrintCapabilities()	获取用于标识打印机功能的 PrintCapabilities 对象。
GetPrintCapabilities(PrintTicket)	获取用于标识打印机功能的 PrintCapabilities 对象。
GetPrintCapabilitiesAsXml()	获取一个 MemoryStream 对象，该对象将打印机的功能指定为遵从打印架构的 XML 流。
GetPrintCapabilitiesAsXml(PrintTicket)	获取一个 MemoryStream 对象，该对象指定 XML 格式的打印机功能，该格式符合打印架构。
GetPrintJobInfoCollection()	创建包含队列中每个作业的 PrintSystemJobInfo 对象的集合。
GetType()	获取当前实例的 Type。 (继承自 Object)
Initialize()	初始化 PrintSystemObject 的属性。 (继承自 PrintSystemObject)
InternalDispose(Boolean)	释放由 PrintQueue 占用的非托管资源，还可以另外再释放托管资源。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)	合并两种 PrintTicket，保证所得的 PrintTicket 有效且不请求打印机所不支持的任何打印功能。
MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)	合并两种 PrintTicket，保证所得的 PrintTicket 有效，不请求打印机所不支持的任何打印功能，且限于指定的作用域。
Pause()	暂停打印队列。 它保持暂停状态，直到执行 Resume() 为止。
Purge()	移除打印队列中的所有作业。
Refresh()	使用来自打印机的值和计算机上运行的打印队列实用工具更新 PrintQueue 对象的属性。
Resume()	重新启动暂停的打印队列。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• PrintServer