PrintQueue Класс

Определение

Управляет принтерами и заданиями печати.Manages printers and print jobs.

public ref class PrintQueue : System::Printing::PrintSystemObject
public class PrintQueue : System.Printing.PrintSystemObject
type PrintQueue = class
    inherit PrintSystemObject
Public Class PrintQueue
Inherits PrintSystemObject
Наследование

Комментарии

Некоторые свойства объекта PrintQueue представляют характеристики служебной программы очереди печати, выполняемой на компьютере, но другие представляют функции или состояния самого принтера.Some properties of the PrintQueue object represent characteristics of the print queue utility that runs on the computer, but others represent features or states of the printer itself. Например, NumberOfJobs является характеристикой очереди печати, но Location является свойством принтера.For example, NumberOfJobs is a characteristic of the print queue, but Location is a property of the printer. Многие свойства принтера, например, требует ли он вмешательства пользователя, должны передаваться с помощью метода Refresh, от самого принтера к объекту PrintQueue.Many of the properties of the printer, such as whether it needs user attention, need to be passed, by means of the Refresh method, from the printer itself to the PrintQueue object. Это необходимо сделать, прежде чем соответствующее свойство (NeedUserIntervention) будет считано программой.This should be done before the corresponding property (NeedUserIntervention) is read by your program. Аналогично, когда программа изменяет значения одного или нескольких свойств объекта PrintQueue, это изменение должно быть записано в действующую программу очереди печати на компьютере.Similarly, when your program changes the values of one or more properties of a PrintQueue object, the change must be written to the actual print queue utility on the computer. Выполните это с помощью метода Commit.Do this with the Commit method.

Внимание!

Классы в пространстве имен System.Printing не поддерживаются для использования в службе Windows или приложении или службе ASP.NET.Classes within the System.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Попытка использования этих классов в одном из этих типов приложений может привести к непредвиденным проблемам, например к снижению производительности службы и исключений времени выполнения.Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Если требуется выполнить печать из Windows Forms приложения, см. раздел пространство имен System.Drawing.Printing.If you want to print from a Windows Forms application, see the System.Drawing.Printing namespace.

Конструкторы

PrintQueue(PrintServer, String)

Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer и имя очереди.Initializes a new instance of PrintQueue class using the specified PrintServer and queue name.

PrintQueue(PrintServer, String, Int32)

Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди и версию схемы печати.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, and print schema version.

PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)

Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди, версию схемы печати и необходимый тип доступа.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, print schema version, and desired access.

PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])

Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди и массив инициализируемых значений PrintQueueIndexedProperty.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, and array of PrintQueueIndexedProperty values to initialize.

PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess)

Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди, массив инициализируемых значений типа PrintQueueIndexedProperty и необходимый тип доступа.Initializes a new instance of PrintQueue class with the specified PrintServer, queue name, array of PrintQueueIndexedProperty values to initialize, and desired access.

PrintQueue(PrintServer, String, PrintSystemDesiredAccess)

Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди и необходимый тип доступа.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, and desired access.

PrintQueue(PrintServer, String, String[])

Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди и массив имен инициализируемых свойств.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, and array of property names to initialize.

PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess)

Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди, фильтр свойств и необходимый тип доступа.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, property filter, and desired access.

Свойства

AveragePagesPerMinute

Получает скорость принтера, измеряемую страницами в минуту.Gets the speed of the printer measured in pages per minute.

ClientPrintSchemaVersion

Возвращает версию схемы печати.Gets the version of the Print Schema.

Comment

Получает или задает комментарий к принтеру.Gets or sets a comment about the printer.

CurrentJobSettings

Получает объект, который содержит параметры конфигурации для текущего задания печати.Gets an object that contains the configuration settings for the current print job.

DefaultPrintTicket

Получает или задает параметры принтера по умолчанию, связанные с данной очередью PrintQueue.Gets or sets the default printer options associated with this PrintQueue.

DefaultPriority

Получает или задает приоритет по умолчанию, который назначается каждому новому зданию печати, добавляемому в очередь.Gets or sets the default priority that is given to each new print job added to the queue.

Description

Получает описание очереди печати.Gets a description of the print queue.

FullName

Получает полное имя очереди.Gets the complete name of the queue.

HasPaperProblem

Получает значение, указывающее наличие на принтере неопределенной проблемы с бумагой.Gets a value that indicates if the printer is having an unspecified paper problem.

HasToner

Получает значение, указывающее наличие тонера в принтере.Gets a value that indicates if the printer has toner.

HostingPrintServer

Получает или задает (защищенное свойство) сервер печати, управляющий очередью печати.Gets or sets (protected) the print server that controls the print queue.

InPartialTrust

Получает или задает значение, указывающее, работает ли очередь в режиме неполного доверия, который является более высоким уровнем доверия.Gets or sets a value that indicates whether the queue is operating in a partially trusted mode, a higher level of trust.

IsBidiEnabled

Получает значение, указывающее, включена ли двунаправленная связь с принтером.Gets a value that indicates whether bidirectional communication with the printer is enabled.

IsBusy

Получает значение, указывающее, занято ли устройство печати.Gets a value that indicates whether the printing device is busy.

IsDevQueryEnabled

Получает значение, указывающее, есть ли в очереди документы с несовпадающими конфигурациями документа и принтера.Gets a value that indicates whether the queue holds documents when document and printer configurations do not match.

IsDirect

Получает значение, указывающее, печатаются ли документы сразу на принтере или сначала буферизуются, а потом печатаются.Gets a value that indicates whether the queue prints directly to the printer or spools documents first and then prints them.

IsDisposed

Возвращает или задает значение, указывающее, был ли удален объект.Gets or sets a value that indicates whether the object has been disposed.

(Унаследовано от PrintSystemObject)
IsDoorOpened

Получает значение, указывающее, открыта ли дверца на принтере.Gets a value that indicates whether a door is open on the printer.

IsHidden

Получает значение, указывающее, скрыта ли очередь печати в пользовательском интерфейсе приложения.Gets a value that indicates whether the print queue is hidden in your application's user interface.

IsInError

Получает значение, указывающее, есть ли ошибки в работе принтера или другого устройства.Gets a value that indicates whether the printer or device is in an error condition.

IsInitializing

Получает значение, указывающее, инициализируется ли принтер самостоятельно.Gets a value that indicates whether the printer is initializing itself.

IsIOActive

Получает значение, указывающее, выполняется ли на принтере получение или отправка данных или сигналов.Gets a value that indicates whether the printer is receiving or sending data or signals.

IsManualFeedRequired

Получает значение, указывающее, необходима ли для текущего задания печати ручная подача бумаги в принтер.Gets a value that indicates whether the printer needs to be manually fed paper for the current print job.

IsNotAvailable

Получает значение, указывающее, доступен ли принтер.Gets a value that indicates whether the printer is available.

IsOffline

Возвращает значение, указывающее, отключен ли принтер.Gets a value that indicates whether the printer is offline.

IsOutOfMemory

Получает значение, указывающее, имеется ли на принтере нехватка памяти.Gets a value that indicates whether the printer is out of memory.

IsOutOfPaper

Получает значение, указывающее, необходимо ли перезагрузить в принтер бумагу необходимого размера для текущего задания.Gets a value that indicates whether the printer needs to be reloaded with paper of the size required for the current job.

IsOutputBinFull

Получает значение, указывающее, есть ли опасность переполнения области вывода принтера.Gets a value that indicates whether the output area of the printer is in danger of overflowing.

IsPaperJammed

Получает значение, указывающее, застрял ли в принтере текущий лист бумаги.Gets a value that indicates whether the current sheet of paper is stuck in the printer.

IsPaused

Получает значение, указывающее, приостановлена ли очередь печати.Gets a value that indicates whether the print queue has been paused.

IsPendingDeletion

Получает значение, указывающее, находится ли принтер в процессе удаления задания печати.Gets a value that indicates whether the printer is in the process of deleting a print job.

IsPowerSaveOn

Получает значение, указывающее, находится ли принтер в режиме экономии энергии.Gets a value that indicates whether the printer is in power save mode.

IsPrinting

Получает значение, указывающее, выполняется ли печать задания.Gets a value that indicates whether a job is printing.

IsProcessing

Получает значение, указывающее, обрабатывает ли принтер задание печати.Gets a value that indicates whether the printer is processing a print job.

IsPublished

Получает значение, указывающее, видят ли принтер другие сетевые пользователи.Gets a value that indicates whether the printer is visible to other network users.

IsQueued

Получает значение, указывающее, поддерживает ли принтер очередь, в которой одновременно содержатся несколько заданий печати.Gets a value that indicates whether the printer can support a queue with more than one print job in it at a time.

IsRawOnlyEnabled

Получает значение, указывающее, может ли очередь печати использовать расширенный метафайл (EMF), ускоряющий поток данных от приложения, которое осуществляет печать, к диспетчеру очереди Windows.Gets a value that indicates whether the print queue can use EMF (Enhanced Meta File) that enables faster data flow from a printing application to the Windows spooler.

IsServerUnknown

Получает значение, указывающее, находится ли принтер в состоянии ошибки.Gets a value that indicates whether the printer is in an error state.

IsShared

Получает значение, указывающее, доступен ли принтер для использования другими компьютерами в сети.Gets a value that indicates whether the printer is available for use by other computers on the network.

IsTonerLow

Получает значение, указывающее, заканчивается ли на принтере тонер.Gets a value that indicates whether the printer is running short of toner.

IsWaiting

Получает значение, указывающее, ожидает ли очередь добавления задания.Gets a value that indicates whether the queue is waiting for a job to be added.

IsWarmingUp

Получает значение, указывающее, прогревается ли принтер.Gets a value that indicates whether the printer is warming up.

IsXpsDevice

Возвращает значение, указывающее, создан ли драйвер принтера на основе модели XPSDrv и, следовательно, использует ли он XML Paper Specification (XPS) в качестве языка описания страниц.Gets a value that indicates whether the printer's driver is built on the XPSDrv model so it uses XML Paper Specification (XPS) as its page description language.

KeepPrintedJobs

Получает значение, указывающее, сохраняет ли очередь языковой файл принтера, вместо того, чтобы удалить его после печати.Gets a value that indicates whether the queue is saving the printer language file instead of deleting it following printing.

Location

Получает или задает физическое расположение принтера.Gets or sets the printer's physical location.

MaxPrintSchemaVersion

Возвращает номер самой последней версии схемы печати, которая может использоваться очередью.Gets the most recent possible version number of the Print Schema that the queue can use.

Name

Получает или задает имя очереди печати.Gets or sets the print queue's name.

NeedUserIntervention

Получает значение, указывающее, требуется ли принтеру вмешательство человека.Gets a value that indicates whether the printer needs the attention of a human being.

NumberOfJobs

Получает общее число заданий, выстроившихся в очереди печати.Gets the total number of jobs lined up in the print queue.

PagePunt

Получает значение, указывающее на невозможность печати принтером текущей страницы.Gets a value that indicates whether the printer is unable to print the current page.

Parent

Возвращает родительский объект.Gets the parent of the object.

(Унаследовано от PrintSystemObject)
PrintingIsCancelled

Получает или задает значение, указывающее, отменяется ли текущее задание печати.Gets or sets a value that indicates whether the current print job is being cancelled.

Priority

Получает или задает приоритет очереди печати по отношению к другим очередям печати, которые размещаются на том же сервере печати и используют тот же физический принтер.Gets or sets the priority of the print queue relative to other print queues that are hosted by the same print server and that use the same physical printer.

PropertiesCollection

Возвращает коллекцию пар атрибутов и значений.Gets a collection of attribute and value pairs.

(Унаследовано от PrintSystemObject)
QueueAttributes

Получает свойства очереди печати.Gets the properties of the print queue.

QueueDriver

Получает или задает драйвер принтера для очереди.Gets or sets the printer driver for the queue.

QueuePort

Получает или задает порт, используемый очередью.Gets or sets the port that the queue uses.

QueuePrintProcessor

Получает обработчик заданий печати, используемый очередью.Gets or sets the print processor that the queue uses.

QueueStatus

Получает значение, представляющее состояние принтера.Gets a value that represents the status of the printer. К ним относятся "прогрев","инициализация","печать" и другие.These include "warming up," "initializing," "printing," and others.

ScheduleCompletedJobsFirst

Получает значение, указывающее, печатает ли принтер задания, у которых завершен процесс буферизации, прежде чем печатать не полностью буферизованные задания, даже если последние стали в очередь раньше или имеют более высокий приоритет.Gets a value that indicates whether the printer prints jobs that have completed the spooling process before jobs that have not fully spooled even if the latter entered the queue first or have a higher priority.

SeparatorFile

Получает или задает путь и имя файла, который вставляется в начало каждого задания печати.Gets or sets the path and file name of a file that is inserted at the beginning of each print job.

ShareName

Получает или задает имя принтера, которое пользователи видят по сети, когда он находится в общем доступе.Gets or sets a name for the printer that is seen by users on the network when it is shared.

StartTimeOfDay

Получает или задает самое раннее время дня, выраженное как количество минут после полуночи в формате UTC (время по Гринвичу [GMT]), когда принтер будет печатать задание.Gets or sets the earliest time of day, expressed as the number of minutes after midnight Coordinated Universal Time (UTC) (also called Greenwich Mean Time [GMT]), that the printer will print a job.

UntilTimeOfDay

Получает или задает самое позднее время, выраженное как количество минут после полуночи в формате UTC (время по Гринвичу [GMT]), когда принтер будет печатать задание.Gets or sets the latest time, expressed as the number of minutes after midnight Coordinated Universal Time (UTC) (also called Greenwich Mean Time [GMT]), that the printer will print a job.

UserPrintTicket

Получает или задает объект текущего пользователя PrintTicket, используемый по умолчанию, который содержит подробные сведения о задании печати.Gets or sets the current user's default PrintTicket object which contains detailed information about the print job.

Методы

AddJob()

Вставляет в очередь новое задание печати (с общим именем), содержимое которого является массивом типа Byte.Inserts a new (generically named) print job, whose content is a Byte array, into the queue.

AddJob(String)

Вставляет в очередь новое задание печати, содержимое которого является массивом типа Byte.Inserts a new print job, whose content is a Byte array, into the queue.

AddJob(String, PrintTicket)

Вставляет новое задание на печать документа Формат XPS (XML Paper Specification)XML Paper Specification (XPS) в очередь, задает для него указанное имя и параметры.Inserts a new print job for an Формат XPS (XML Paper Specification)XML Paper Specification (XPS) Document into the queue, and gives it the specified name and settings.

AddJob(String, String, Boolean)

Вставляет в очередь новое задание печати для документа Формат XPS (XML Paper Specification)XML Paper Specification (XPS), присваивает ему заданное имя и указывает, должно ли оно проверяться.Inserts a new print job for an Формат XPS (XML Paper Specification)XML Paper Specification (XPS) Document into the queue, gives it the specified name, and specifies whether or not it should be validated.

AddJob(String, String, Boolean, PrintTicket)

Вставляет в очередь новое задание печати для документа Формат XPS (XML Paper Specification)XML Paper Specification (XPS), присваивает ему заданное имя и параметры и указывает, должно ли оно проверяться.Inserts a new print job for an Формат XPS (XML Paper Specification)XML Paper Specification (XPS) Document into the queue, gives it the specified name and settings, and specifies whether or not it should be validated.

Commit()

Записывает текущие свойства объекта PrintQueue в действующую очередь печати на сервере печати.Writes the current properties of the PrintQueue object to the actual print queue on the print server.

CreateXpsDocumentWriter(Double, Double)

Создает объект XpsDocumentWriter с указанными размерами.Creates an XpsDocumentWriter object with the specified dimensions.

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.Creates an XpsDocumentWriter object, opens a Windows common print dialog and returns a ref (ByRef in Visual Basic) parameter that represents information about the imageable area and the dimensions of the media.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Создает объект XpsDocumentWriter, открывает стандартный диалог печати Windows, передает в него диапазон страниц и описание задания печати и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.Creates an XpsDocumentWriter object, opens a Windows common print dialog, provides the dialog with a page range and a description of the print job, and returns a ref (ByRef in Visual Basic) parameter that represents information about the imageable area and the dimensions of the media.

CreateXpsDocumentWriter(PrintQueue)

Создает объект XpsDocumentWriter и связывает его с указанной очередью печати.Creates an XpsDocumentWriter object and associates it with the specified print queue.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows (и передает в него описание задания) и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.Creates an XpsDocumentWriter object, opens a Windows common print dialog (and provides it a job description) and returns a ref (ByRef in Visual Basic) parameter that represents information about the imageable area and the dimensions of the media.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows, передает в него диапазон страниц и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.Creates an XpsDocumentWriter object, opens a Windows common print dialog, provides the dialog with a page range, and returns a ref (ByRef in Visual Basic) parameter that represents information about the imageable area and the dimensions of the media.

Dispose()

Освобождает все ресурсы, занятые модулем PrintSystemObject.Releases all resources used by the PrintSystemObject.

(Унаследовано от PrintSystemObject)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом PrintSystemObject, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the PrintSystemObject and optionally releases the managed resources.

(Унаследовано от PrintSystemObject)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetJob(Int32)

Получает задание печати с заданным идентификатором.Gets the print job with the specified ID number.

GetPrintCapabilities()

Получает объект PrintCapabilities, указывающий возможности принтера.Gets a PrintCapabilities object that identifies the capabilities of the printer.

GetPrintCapabilities(PrintTicket)

Получает объект PrintCapabilities, указывающий возможности принтера.Gets a PrintCapabilities object that identifies the capabilities of the printer.

GetPrintCapabilitiesAsXml()

Возвращает объект MemoryStream, определяющий возможности принтера в виде XML-потока, компилируемого с помощью схемы печати.Gets a MemoryStream object that specifies the printer's capabilities as an XML stream that complies with the Print Schema.

GetPrintCapabilitiesAsXml(PrintTicket)

Возвращает объект MemoryStream, указывающий возможности принтера в формате XML, компилируемого с помощью схемы печати.Gets a MemoryStream object that specifies the printer's capabilities in an XML format that complies with the Print Schema.

GetPrintJobInfoCollection()

Создает коллекцию, в которой для каждого задания из очереди содержится объект PrintSystemJobInfo.Creates a collection that contains a PrintSystemJobInfo object for each job in the queue.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
Initialize()

Инициализирует свойства объекта PrintSystemObject.Initializes the properties of the PrintSystemObject.

(Унаследовано от PrintSystemObject)
InternalDispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом PrintQueue, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the PrintQueue and optionally releases the managed resources.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)

Выполняет слияние двух объектов PrintTicket и гарантирует, что конечный объект PrintTicket будет допустимым и ему не потребуются какие-либо возможности печати, не поддерживаемые принтером.Merges two PrintTickets and guarantees that the resulting PrintTicket is valid and does not ask for any printing functionality that the printer does not support.

MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)

Выполняет слияние двух объектов PrintTicket и гарантирует, что конечный объект PrintTicket будет допустимым, ему не потребуются какие-либо возможности печати, не поддерживаемые принтером, и он будет ограничен указанной областью.Merges two PrintTickets and guarantees that the resulting PrintTicket is valid, does not ask for any printing functionality that the printer does not support, and is limited to the specified scope.

Pause()

Приостанавливает очередь печати.Pauses the print queue. Очередь остается приостановленной до тех пор, пока не будет выполнен метод Resume().It remains paused until Resume() is executed.

Purge()

Удаляет все задания из очереди печати.Removes all the jobs in the print queue.

Refresh()

Обновляет свойства объекта PrintQueue значениями, поступающими от принтера и утилиты очереди печати, запущенной на компьютере.Updates the properties of the PrintQueue object with values from the printer and the print queue utility that runs on the computer.

Resume()

Возобновляет работу приостановленной очереди печати.Restarts a print queue that was paused.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно