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[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр LocalPrintServer класса с указанным LocalPrintServerIndexedProperty массивом и указанным PrintSystemDesiredAccess. |
| LocalPrintServer(LocalPrintServerIndexedProperty[]) |
Инициализирует новый экземпляр LocalPrintServer класса с указанным LocalPrintServerIndexedProperty массивом. |
| LocalPrintServer(PrintSystemDesiredAccess) |
Инициализирует новый экземпляр LocalPrintServer класса с указанным PrintSystemDesiredAccess. |
| LocalPrintServer(String[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр LocalPrintServer класса с указанными свойствами и PrintSystemDesiredAccess. |
| LocalPrintServer(String[]) |
Инициализирует новый экземпляр LocalPrintServer класса с указанными свойствами. |
Свойства
| Имя | Описание |
|---|---|
| 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 |
Возвращает версию системы spooler печати. (Унаследовано от 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, String[]) |
Возвращает указанную очередь печати с сервера печати. (Унаследовано от PrintServer) |
| GetPrintQueue(String) |
Получает ссылку на именованную очередь печати с сервера печати. (Унаследовано от PrintServer) |
| GetPrintQueues() |
Возвращает коллекцию очередей печати, на которые размещается сервер печати. (Унаследовано от PrintServer) |
| GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию очередей печати указанных типов, именованных EnumeratedPrintQueueTypes и размещенных сервером печати. (Унаследовано от PrintServer) |
| GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию очередей печати указанных типов. Эти очереди печати инициализированы только в свойствах, указанных в массиве PrintQueueIndexedProperty . (Унаследовано от PrintServer) |
| GetPrintQueues(PrintQueueIndexedProperty[]) |
Возвращает коллекцию очередей печати, размещенных сервером печати и инициализированных только в свойствах, указанных в массиве PrintQueueIndexedProperty . (Унаследовано от PrintServer) |
| GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию очередей печати, которые являются указанными EnumeratedPrintQueueTypes и инициализированы только в указанных свойствах. (Унаследовано от PrintServer) |
| GetPrintQueues(String[]) |
Возвращает коллекцию очередей печати, размещенных сервером печати и инициализируемых только в указанных свойствах. (Унаследовано от PrintServer) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| Initialize() |
Инициализирует свойства объекта PrintSystemObject. (Унаследовано от PrintSystemObject) |
| InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) |
Устанавливает очередь печати и связанный драйвер принтера на сервере печати. (Унаследовано от PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Устанавливает приоритетную очередь печати и связанный драйвер принтера на сервере печати. (Унаследовано от PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Устанавливает общую, приоритетную очередь печати и связанный драйвер принтера на сервере печати. (Унаследовано от PrintServer) |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Устанавливает очередь печати и связанный драйвер принтера на сервере печати. (Унаследовано от PrintServer) |
| InternalDispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые PrintServer и при необходимости освобождает управляемые ресурсы. (Унаследовано от PrintServer) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Refresh() |
Обновляет свойства LocalPrintServer объекта таким образом, чтобы их значения соответствовали значениям сервера печати, который представляет объект. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |