LocalPrintServer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет локальный сервер печати (компьютер, на котором выполняется приложение) и обеспечивает управление очередями печати, которые на нем размещаются.
public ref class LocalPrintServer sealed : System::Printing::PrintServer
public sealed class LocalPrintServer : System.Printing.PrintServer
type LocalPrintServer = class
inherit PrintServer
Public NotInheritable Class LocalPrintServer
Inherits PrintServer
- Наследование
Примеры
В следующем примере показано создание экземпляра класса LocalPrintServer.
// -------------------- GetPrintXpsDocumentWriter() -------------------
/// <summary>
/// Returns an XpsDocumentWriter for the default print queue.</summary>
/// <returns>
/// An XpsDocumentWriter for the default print queue.</returns>
private XpsDocumentWriter GetPrintXpsDocumentWriter()
{
// Create a local print server
LocalPrintServer ps = new LocalPrintServer();
// Get the default print queue
PrintQueue pq = ps.DefaultPrintQueue;
// Get an XpsDocumentWriter for the default print queue
XpsDocumentWriter xpsdw = PrintQueue.CreateXpsDocumentWriter(pq);
return xpsdw;
}// end:GetPrintXpsDocumentWriter()
' -------------------- GetPrintXpsDocumentWriter() -------------------
''' <summary>
''' Returns an XpsDocumentWriter for the default print queue.</summary>
''' <returns>
''' An XpsDocumentWriter for the default print queue.</returns>
Private Function GetPrintXpsDocumentWriter() As XpsDocumentWriter
' Create a local print server
Dim ps As New LocalPrintServer()
' Get the default print queue
Dim pq As PrintQueue = ps.DefaultPrintQueue
' Get an XpsDocumentWriter for the default print queue
Dim xpsdw As XpsDocumentWriter = PrintQueue.CreateXpsDocumentWriter(pq)
Return xpsdw
End Function ' end:GetPrintXpsDocumentWriter()
Комментарии
Когда приложение записывает значение в свойство объекта, это изменение не оказывает никакого LocalPrintServer влияния до тех пор, пока значение не будет передано на компьютер, представленный LocalPrintServer объектом . Чтобы убедиться, что изменение значения вступает в силу, используйте Commit метод .
Кроме того, другие приложения также могут изменять свойства службы печати компьютера. Чтобы убедиться, что объект, используемый LocalPrintServer приложением, имеет последние фактические значения, используйте Refresh метод .
Внимание!
Классы в System.Printing пространстве имен не поддерживаются для использования в службе Windows или ASP.NET приложении или службе. Попытка использовать эти классы из одного из этих типов приложений может привести к непредвиденным проблемам, таким как снижение производительности службы и исключения во время выполнения.
Если вы хотите выполнить печать из приложения Windows Forms, см. System.Drawing.Printing пространство имен.
Конструкторы
LocalPrintServer() |
Инициализирует новый экземпляр класса LocalPrintServer. |
LocalPrintServer(LocalPrintServerIndexedProperty[]) |
Инициализирует новый экземпляр класса LocalPrintServer с заданным массивом LocalPrintServerIndexedProperty. |
LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса LocalPrintServer с заданными массивом свойств LocalPrintServerIndexedProperty и доступом PrintSystemDesiredAccess. |
LocalPrintServer(PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса LocalPrintServer с заданным свойством PrintSystemDesiredAccess. |
LocalPrintServer(String[]) |
Инициализирует новый экземпляр класса LocalPrintServer с заданными свойствами. |
LocalPrintServer(String[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса LocalPrintServer с заданными свойствами и доступом PrintSystemDesiredAccess. |
Свойства
BeepEnabled |
Возвращает или задает значение, указывающее, подает ли сервер печати сигнал в ответ на ошибку принтера. (Унаследовано от PrintServer) |
DefaultPortThreadPriority |
Не используется. (Унаследовано от PrintServer) |
DefaultPrintQueue |
Возвращает или задает очередь печати по умолчанию. |
DefaultSchedulerPriority |
Не используется. (Унаследовано от PrintServer) |
DefaultSpoolDirectory |
Возвращает или задает путь к файлам очереди сервера печати. (Унаследовано от PrintServer) |
EventLog |
Возвращает или задает тип событий, регистрируемых сервером печати. (Унаследовано от PrintServer) |
IsDelayInitialized |
Возвращает или задает значение, указывающее, отложена ли инициализация свойств PrintServer. (Унаследовано от PrintServer) |
IsDisposed |
Возвращает или задает значение, указывающее, был ли удален объект. (Унаследовано от PrintSystemObject) |
MajorVersion |
Возвращает основной номер версии операционной системы. (Унаследовано от PrintServer) |
MinorVersion |
Возвращает дополнительный номер версии операционной системы вместе с основным. (Унаследовано от PrintServer) |
Name |
Возвращает имя сервера печати. (Унаследовано от PrintServer) |
NetPopup |
Возвращает или задает значение, указывающее, отправляются ли уведомления о завершении задания печати на сервер печати или на клиентский компьютер. (Унаследовано от PrintServer) |
Parent |
Возвращает родительский объект. (Унаследовано от PrintSystemObject) |
PortThreadPriority |
Возвращает или задает приоритет потока для процесса, который управляет вводом-выводом через порты принтера. (Унаследовано от PrintServer) |
PropertiesCollection |
Возвращает коллекцию пар атрибутов и значений. (Унаследовано от PrintSystemObject) |
RestartJobOnPoolEnabled |
Возвращает или задает значение, указывающее, может ли пользователь перезапустить задания после возникновения ошибки при включенном пуле принтеров. (Унаследовано от PrintServer) |
RestartJobOnPoolTimeout |
Возвращает или задает значение, указывающее время ожидания до перезапуска задания в случае возникновения ошибки при включенном пуле принтеров. (Унаследовано от PrintServer) |
SchedulerPriority |
Возвращает или задает приоритет потока для процесса, направляющего задания печати из приложений в очереди печати. (Унаследовано от PrintServer) |
SubSystemVersion |
Возвращает версию системы очереди печати принтера. (Унаследовано от PrintServer) |
Методы
Commit() |
Записывает любые изменения, внесенные программой в свойства объекта LocalPrintServer, в имеющийся сервер печати, представляемый объектом. |
ConnectToPrintQueue(PrintQueue) |
Подключает локальный сервер печати к указанной очереди PrintQueue. |
ConnectToPrintQueue(String) |
Подключает к очереди печати, указанной в строке String. |
DisconnectFromPrintQueue(PrintQueue) |
Отключает локальный сервер печати от указанной очереди PrintQueue. |
DisconnectFromPrintQueue(String) |
Отключает от очереди печати, указанной в строке String. |
Dispose() |
Освобождает все ресурсы, занятые модулем PrintSystemObject. (Унаследовано от PrintSystemObject) |
Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом PrintSystemObject, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от PrintSystemObject) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetDefaultPrintQueue() |
Возвращает ссылку на очередь печати по умолчанию на сервере печати LocalPrintServer. |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetPrintQueue(String) |
Получает ссылку на очередь печати с заданным именем с сервера печати. (Унаследовано от PrintServer) |
GetPrintQueue(String, String[]) |
Возвращает очередь печати с заданным именем с сервера печати. (Унаследовано от PrintServer) |
GetPrintQueues() |
Возвращает коллекцию очередей печати, которые размещаются на сервере печати. (Унаследовано от PrintServer) |
GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию размещенных на сервере печати очередей печати заданных типов, названия которых содержатся в коллекции EnumeratedPrintQueueTypes. (Унаследовано от PrintServer) |
GetPrintQueues(PrintQueueIndexedProperty[]) |
Возвращает коллекцию очередей печати, которые размещаются на сервере печати и у которых инициализированы только свойства, указанные в массиве PrintQueueIndexedProperty. (Унаследовано от PrintServer) |
GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию очередей печати заданных типов. У этих очередей печати инициализируются только те свойства, которые указаны в массиве PrintQueueIndexedProperty. (Унаследовано от PrintServer) |
GetPrintQueues(String[]) |
Возвращает коллекцию очередей печати, которые размещаются на сервере печати и у которых инициализированы только указанные свойства. (Унаследовано от PrintServer) |
GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию очередей печати определенного типа EnumeratedPrintQueueTypes, у которых инициализируются только указанные свойства. (Унаследовано от PrintServer) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
Initialize() |
Инициализирует свойства объекта PrintSystemObject. (Унаследовано от PrintSystemObject) |
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) |
Устанавливает очередь печати и связанный драйвер принтера на сервере печати. (Унаследовано от PrintServer) |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Устанавливает очередь печати и связанный драйвер принтера на сервере печати. (Унаследовано от PrintServer) |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Устанавливает приоритетную очередь печати и связанный драйвер принтера на сервере печати. (Унаследовано от PrintServer) |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Устанавливает общую приоритетную очередь печати и связанный драйвер принтера на сервере печати. (Унаследовано от PrintServer) |
InternalDispose(Boolean) |
Освобождает неуправляемые (а при необходимости и управляемые) ресурсы, используемые PrintServer. (Унаследовано от PrintServer) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
Refresh() |
Обновляет свойства объекта LocalPrintServer, чтобы их значения соответствовали значениям сервера печати, представленного объектом. |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |