PrintServer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Управляет очередями печати на сервере печати, который обычно является компьютером, но может быть и выделенным аппаратным устройством сервера печати.
public ref class PrintServer : System::Printing::PrintSystemObject
public class PrintServer : System.Printing.PrintSystemObject
type PrintServer = class
inherit PrintSystemObject
Public 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) |
Инициализирует новый экземпляр класса PrintServer, для которого задан путь. |
PrintServer(String, PrintServerIndexedProperty[]) |
Инициализирует новый экземпляр класса PrintServer, используя указанный массив PrintServerIndexedProperty для определения инициализируемых свойств. |
PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса PrintServer и предоставляет заданный путь, массив PrintServerIndexedProperty и необходимый тип доступа. |
PrintServer(String, PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса PrintServer, для которого задан путь и необходимый тип доступа. |
PrintServer(String, String[]) |
Инициализирует новый экземпляр класса PrintServer, для которого задан путь и фильтр свойств. |
PrintServer(String, String[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса PrintServer, для которого задан путь, фильтр свойств и необходимый тип доступа. |
Свойства
BeepEnabled |
Возвращает или задает значение, указывающее, подает ли сервер печати сигнал в ответ на ошибку принтера. |
DefaultPortThreadPriority |
Не используется. |
DefaultSchedulerPriority |
Не используется. |
DefaultSpoolDirectory |
Возвращает или задает путь к файлам очереди сервера печати. |
EventLog |
Возвращает или задает тип событий, регистрируемых сервером печати. |
IsDelayInitialized |
Возвращает или задает значение, указывающее, отложена ли инициализация свойств PrintServer. |
IsDisposed |
Возвращает или задает значение, указывающее, был ли удален объект. (Унаследовано от PrintSystemObject) |
MajorVersion |
Возвращает основной номер версии операционной системы. |
MinorVersion |
Возвращает дополнительный номер версии операционной системы вместе с основным. |
Name |
Возвращает имя сервера печати. |
NetPopup |
Возвращает или задает значение, указывающее, отправляются ли уведомления о завершении задания печати на сервер печати или на клиентский компьютер. |
Parent |
Возвращает родительский объект. (Унаследовано от PrintSystemObject) |
PortThreadPriority |
Возвращает или задает приоритет потока для процесса, который управляет вводом-выводом через порты принтера. |
PropertiesCollection |
Возвращает коллекцию пар атрибутов и значений. (Унаследовано от PrintSystemObject) |
RestartJobOnPoolEnabled |
Возвращает или задает значение, указывающее, может ли пользователь перезапустить задания после возникновения ошибки при включенном пуле принтеров. |
RestartJobOnPoolTimeout |
Возвращает или задает значение, указывающее время ожидания до перезапуска задания в случае возникновения ошибки при включенном пуле принтеров. |
SchedulerPriority |
Возвращает или задает приоритет потока для процесса, направляющего задания печати из приложений в очереди печати. |
SubSystemVersion |
Возвращает версию системы очереди печати принтера. |
Методы
Commit() |
Сохраняет все изменения, внесенные программой в свойства объекта сервера печати, путем записи их в сервер печати, представляемый объектом. |
DeletePrintQueue(PrintQueue) |
Удаляет указанную очередь PrintQueue с сервера печати. |
DeletePrintQueue(String) |
Удаляет очередь печати с заданным именем с сервера печати. |
Dispose() |
Освобождает все ресурсы, занятые модулем PrintSystemObject. (Унаследовано от PrintSystemObject) |
Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом PrintSystemObject, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от PrintSystemObject) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetPrintQueue(String) |
Получает ссылку на очередь печати с заданным именем с сервера печати. |
GetPrintQueue(String, String[]) |
Возвращает очередь печати с заданным именем с сервера печати. |
GetPrintQueues() |
Возвращает коллекцию очередей печати, которые размещаются на сервере печати. |
GetPrintQueues(EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию размещенных на сервере печати очередей печати заданных типов, названия которых содержатся в коллекции EnumeratedPrintQueueTypes. |
GetPrintQueues(PrintQueueIndexedProperty[]) |
Возвращает коллекцию очередей печати, которые размещаются на сервере печати и у которых инициализированы только свойства, указанные в массиве PrintQueueIndexedProperty. |
GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию очередей печати заданных типов. У этих очередей печати инициализируются только те свойства, которые указаны в массиве PrintQueueIndexedProperty. |
GetPrintQueues(String[]) |
Возвращает коллекцию очередей печати, которые размещаются на сервере печати и у которых инициализированы только указанные свойства. |
GetPrintQueues(String[], EnumeratedPrintQueueTypes[]) |
Возвращает коллекцию очередей печати определенного типа EnumeratedPrintQueueTypes, у которых инициализируются только указанные свойства. |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
Initialize() |
Инициализирует свойства объекта PrintSystemObject. (Унаследовано от PrintSystemObject) |
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary) |
Устанавливает очередь печати и связанный драйвер принтера на сервере печати. |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes) |
Устанавливает очередь печати и связанный драйвер принтера на сервере печати. |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32) |
Устанавливает приоритетную очередь печати и связанный драйвер принтера на сервере печати. |
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32) |
Устанавливает общую приоритетную очередь печати и связанный драйвер принтера на сервере печати. |
InternalDispose(Boolean) |
Освобождает неуправляемые (а при необходимости и управляемые) ресурсы, используемые PrintServer. |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
Refresh() |
Обновляет свойства объекта PrintServer, чтобы значение каждого свойства соответствовало значению соответствующего атрибута сервера печати, представляемого объектом. |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |