PrintServer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Управляет очередями печати на сервере печати, который обычно является компьютером, но может быть выделенным аппаратным устройством сервера печати.
public ref class PrintServer : System::Printing::PrintSystemObjectpublic class PrintServer : System.Printing.PrintSystemObjecttype PrintServer = class
inherit PrintSystemObjectPublic Class PrintServer
Inherits PrintSystemObject- Наследование
- Производный
Примеры
В следующем примере показано, как создать экземпляр PrintServer.
// Create a PrintServer
// "theServer" must be a print server to which the user has full print access.
PrintServer myPrintServer = new PrintServer(@"\\theServer");
// List the print server's queues
PrintQueueCollection myPrintQueues = myPrintServer.GetPrintQueues();
String printQueueNames = "My Print Queues:\n\n";
foreach (PrintQueue pq in myPrintQueues)
{
printQueueNames += "\t" + pq.Name + "\n";
}
Console.WriteLine(printQueueNames);
Console.WriteLine("\nPress Return to continue.");
Console.ReadLine();
' Create a PrintServer
' "theServer" must be a print server to which the user has full print access.
Dim myPrintServer As New PrintServer("\\theServer")
' List the print server's queues
Dim myPrintQueues As PrintQueueCollection = myPrintServer.GetPrintQueues()
Dim printQueueNames As String = "My Print Queues:" & vbLf & vbLf
For Each pq As PrintQueue In myPrintQueues
printQueueNames &= vbTab & pq.Name & vbLf
Next pq
Console.WriteLine(printQueueNames)
Console.WriteLine(vbLf & "Press Return to continue.")
Console.ReadLine()
Комментарии
Когда программа записывает значение в свойство PrintServer, это изменение не влияет, пока он не передается на компьютер, представленный PrintServer объектом. Чтобы зафиксировать изменения, используйте Commit метод для объекта.
Аналогичным образом другие приложения могут изменять фактические свойства службы печати компьютера. Чтобы убедиться, что PrintServer объект программы имеет последние значения, используйте Refresh метод для объекта.
Предостережение
Классы в System.Printing пространстве имен не поддерживаются для использования в службе Windows или ASP.NET приложения или службы. При попытке использовать эти классы из одного из этих типов приложений могут возникнуть непредвиденные проблемы, такие как снижение производительности службы и исключения во время выполнения.
Если вы хотите распечатать из приложения Windows Forms, просмотрите System.Drawing.Printing пространство имен.
Конструкторы
| Имя | Описание |
|---|---|
| PrintServer() |
Инициализирует новый экземпляр класса PrintServer. |
| PrintServer(PrintSystemDesiredAccess) |
Инициализирует новый экземпляр PrintServer класса, представляющий локальный сервер печати, и назначает его указанному PrintSystemDesiredAccess. |
| PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр PrintServer класса и предоставляет указанный путь, PrintServerIndexedProperty массив и необходимый доступ. |
| PrintServer(String, PrintServerIndexedProperty[]) |
Инициализирует новый экземпляр класса с помощью указанного PrintServerPrintServerIndexedProperty массива, чтобы определить, какие свойства будут инициализированы. |
| PrintServer(String, PrintSystemDesiredAccess) |
Инициализирует новый экземпляр PrintServer класса с указанным путем и необходимым доступом. |
| PrintServer(String, String[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр PrintServer класса, имеющий указанный путь, фильтр свойств и необходимый доступ. |
| PrintServer(String, String[]) |
Инициализирует новый экземпляр PrintServer класса с указанным фильтром пути и свойств. |
| PrintServer(String) |
Инициализирует новый экземпляр PrintServer класса с указанным путем. |
Свойства
| Имя | Описание |
|---|---|
| BeepEnabled |
Возвращает или задает значение, указывающее, выполняется ли сигнал сервера печати в ответ на условие ошибки на принтере. |
| DefaultPortThreadPriority |
Не используйте. |
| DefaultSchedulerPriority |
Не используйте. |
| DefaultSpoolDirectory |
Получает или задает путь, по которому находятся файлы пула печати сервера печати. |
| EventLog |
Возвращает или задает тип событий, которые журналы сервера печати. |
| IsDelayInitialized |
Возвращает или задает значение, указывающее, была ли отложена инициализация PrintServer свойств. |
| IsDisposed |
Возвращает или задает значение, указывающее, был ли удален объект. (Унаследовано от PrintSystemObject) |
| MajorVersion |
Возвращает основную версию операционной системы. |
| MinorVersion |
Возвращает дополнительную версию в основной версии операционной системы. |
| Name |
Возвращает имя сервера печати. |
| NetPopup |
Возвращает или задает значение, указывающее, отправляются ли уведомления о завершении задания печати на сервер печати или клиентский компьютер. |
| Parent |
Возвращает родительский объект объекта . (Унаследовано от PrintSystemObject) |
| PortThreadPriority |
Возвращает или задает приоритет потока для процесса, который управляет операцией ввода-вывода через порты принтера. |
| PropertiesCollection |
Возвращает коллекцию пар атрибутов и значений. (Унаследовано от PrintSystemObject) |
| RestartJobOnPoolEnabled |
Возвращает или задает значение, указывающее, могут ли пользователи перезапустить задания после возникновения ошибки, если пул принтеров включен. |
| RestartJobOnPoolTimeout |
Возвращает или задает значение, указывающее время ожидания перед перезапуском задания, если ошибка возникает при включении пула принтеров. |
| SchedulerPriority |
Возвращает или задает приоритет потока для процесса, который направляет задания печати из приложений на печать очередей. |
| SubSystemVersion |
Возвращает версию системы spooler печати. |
Методы
| Имя | Описание |
|---|---|
| Commit() |
Фиксирует любые изменения, внесенные программой в свойства объекта сервера печати, записывая их на сервер печати, который представляет объект. |
| DeletePrintQueue(PrintQueue) |
Удаляет указанный с PrintQueue сервера печати. |
| DeletePrintQueue(String) |
Удаляет очередь печати с указанным именем с сервера печати. |
| Dispose() |
Освобождает все ресурсы, используемые параметром PrintSystemObject. (Унаследовано от PrintSystemObject) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые PrintSystemObject и при необходимости освобождает управляемые ресурсы. (Унаследовано от PrintSystemObject) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetPrintQueue(String, String[]) |
Возвращает указанную очередь печати с сервера печати. |
| GetPrintQueue(String) |
Получает ссылку на именованную очередь печати с сервера печати. |
| GetPrintQueues() |
Возвращает коллекцию очередей печати, на которые размещается сервер печати. |
| GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию очередей печати указанных типов, именованных EnumeratedPrintQueueTypes и размещенных сервером печати. |
| GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию очередей печати указанных типов. Эти очереди печати инициализированы только в свойствах, указанных в массиве PrintQueueIndexedProperty . |
| GetPrintQueues(PrintQueueIndexedProperty[]) |
Возвращает коллекцию очередей печати, размещенных сервером печати и инициализированных только в свойствах, указанных в массиве PrintQueueIndexedProperty . |
| GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию очередей печати, которые являются указанными EnumeratedPrintQueueTypes и инициализированы только в указанных свойствах. |
| GetPrintQueues(String[]) |
Возвращает коллекцию очередей печати, размещенных сервером печати и инициализируемых только в указанных свойствах. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| Initialize() |
Инициализирует свойства объекта PrintSystemObject. (Унаследовано от PrintSystemObject) |
| InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) |
Устанавливает очередь печати и связанный драйвер принтера на сервере печати. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Устанавливает приоритетную очередь печати и связанный драйвер принтера на сервере печати. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Устанавливает общую, приоритетную очередь печати и связанный драйвер принтера на сервере печати. |
| InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Устанавливает очередь печати и связанный драйвер принтера на сервере печати. |
| InternalDispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые PrintServer и при необходимости освобождает управляемые ресурсы. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Refresh() |
Обновляет свойства объекта таким образом, чтобы каждое значение свойства PrintServer соответствовало соответствующему значению атрибута сервера печати, представляющего объект. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
