LocalPrintServer Класс

Определение

Представляет локальный сервер печати (компьютер, на котором выполняется приложение) и обеспечивает управление очередями печати, которые на нем размещаются.Represents the local print server (the computer on which your application is running) and enables management of its print queues.

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.The following example shows how to create an instance of the LocalPrintServer class.

// -------------------- 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 объектом.When your application writes a value to a property of the LocalPrintServer object, that change has no effect until the value is passed to the computer that is represented by the LocalPrintServer object. Чтобы убедиться, что изменение значения вступает в силу, используйте Commit метод.To ensure that the change in value takes effect, use the Commit method.

Кроме того, другие приложения также могут изменять свойства службы печати компьютера.In addition, other applications may also change the print service properties of the computer. Чтобы убедиться, что LocalPrintServer объект, используемый приложением, имеет последние фактические значения, Refresh используйте метод.To ensure that the LocalPrintServer object used by your application has the latest actual values, use the Refresh 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.

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

LocalPrintServer()

Инициализирует новый экземпляр класса LocalPrintServer.Initializes a new instance of the LocalPrintServer class.

LocalPrintServer(LocalPrintServerIndexedProperty[])

Инициализирует новый экземпляр класса LocalPrintServer с заданным массивом LocalPrintServerIndexedProperty.Initializes a new instance of the LocalPrintServer class that has the specified LocalPrintServerIndexedProperty array.

LocalPrintServer(LocalPrintServerIndexedProperty[], PrintSystemDesiredAccess)

Инициализирует новый экземпляр класса LocalPrintServer с заданными массивом свойств LocalPrintServerIndexedProperty и доступом PrintSystemDesiredAccess.Initializes a new instance of the LocalPrintServer class that has the specified LocalPrintServerIndexedProperty array and the specified PrintSystemDesiredAccess.

LocalPrintServer(PrintSystemDesiredAccess)

Инициализирует новый экземпляр класса LocalPrintServer с заданным свойством PrintSystemDesiredAccess.Initializes a new instance of the LocalPrintServer class that has the specified PrintSystemDesiredAccess.

LocalPrintServer(String[])

Инициализирует новый экземпляр класса LocalPrintServer с заданными свойствами.Initializes a new instance of the LocalPrintServer class that has the specified properties.

LocalPrintServer(String[], PrintSystemDesiredAccess)

Инициализирует новый экземпляр класса LocalPrintServer с заданными свойствами и доступом PrintSystemDesiredAccess.Initializes a new instance of the LocalPrintServer class that has the specified properties and PrintSystemDesiredAccess.

Свойства

BeepEnabled

Возвращает или задает значение, указывающее, подает ли сервер печати сигнал в ответ на ошибку принтера.Gets or sets a value that indicates whether the print server beeps in response to an error condition in the printer.

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

Не используется.Do not use.

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

Возвращает или задает очередь печати по умолчанию.Gets or sets the default print queue.

DefaultSchedulerPriority

Не используется.Do not use.

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

Возвращает или задает путь к файлам очереди сервера печати.Gets or sets the path where the print server's spool files are located.

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

Возвращает или задает тип событий, регистрируемых сервером печати.Gets or sets the type of events that the print server logs.

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

Возвращает или задает значение, указывающее, отложена ли инициализация свойств PrintServer.Gets or sets a value that indicates whether initialization of the PrintServer properties has been postponed.

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

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

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

Возвращает основной номер версии операционной системы.Gets the major version of the operating system.

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

Возвращает дополнительный номер версии операционной системы вместе с основным.Gets the minor version within the major version of the operating system.

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

Возвращает имя сервера печати.Gets the name of the print server.

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

Возвращает или задает значение, указывающее, отправляются ли уведомления о завершении задания печати на сервер печати или на клиентский компьютер.Gets or sets a value that indicates whether notifications that a print job has finished are sent to either the print server or the client computer.

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

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

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

Возвращает или задает приоритет потока для процесса, который управляет вводом-выводом через порты принтера.Gets or sets the thread priority for the process that manages I/O through the printer ports.

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

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

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

Возвращает или задает значение, указывающее, может ли пользователь перезапустить задания после возникновения ошибки при включенном пуле принтеров.Gets or sets a value that indicates whether users can restart jobs after an error occurs if printer pooling is enabled.

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

Возвращает или задает значение, указывающее время ожидания до перезапуска задания в случае возникновения ошибки при включенном пуле принтеров.Gets or sets a value that indicates the wait time before a job can be restarted, if an error occurs when printer pooling is also enabled.

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

Возвращает или задает приоритет потока для процесса, направляющего задания печати из приложений в очереди печати.Gets or sets the thread priority for the process that routes print jobs from applications to print queues.

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

Возвращает версию системы очереди печати принтера.Gets the version of the print spooler system.

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

Методы

Commit()

Записывает любые изменения, внесенные программой в свойства объекта LocalPrintServer, в имеющийся сервер печати, представляемый объектом.Writes any changes that your application made to the properties of the LocalPrintServer to the actual print server that the object represents.

ConnectToPrintQueue(PrintQueue)

Подключает локальный сервер печати к указанной очереди PrintQueue.Connects the local print server to the specified PrintQueue.

ConnectToPrintQueue(String)

Подключает к очереди печати, указанной в строке String.Connects to the print queue that is specified by using the String.

DisconnectFromPrintQueue(PrintQueue)

Отключает локальный сервер печати от указанной очереди PrintQueue.Disconnects the local print server from the specified PrintQueue.

DisconnectFromPrintQueue(String)

Отключает от очереди печати, указанной в строке String.Disconnects from the print queue that is specified in the String.

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)
GetDefaultPrintQueue()

Возвращает ссылку на очередь печати по умолчанию на сервере печати LocalPrintServer.Returns a reference to the default print queue of the LocalPrintServer.

GetHashCode()

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

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

Получает ссылку на очередь печати с заданным именем с сервера печати.Obtains a reference to the named print queue from the print server.

(Унаследовано от PrintServer)
GetPrintQueue(String, String[])

Возвращает очередь печати с заданным именем с сервера печати.Gets a specified print queue from the print server.

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

Возвращает коллекцию очередей печати, которые размещаются на сервере печати.Gets the collection of print queues that the print server hosts.

(Унаследовано от PrintServer)
GetPrintQueues(EnumeratedPrintQueueTypes[])

Возвращает коллекцию размещенных на сервере печати очередей печати заданных типов, названия которых содержатся в коллекции EnumeratedPrintQueueTypes.Gets the collection of print queues of the specified types that are named in EnumeratedPrintQueueTypes and hosted by the print server.

(Унаследовано от PrintServer)
GetPrintQueues(PrintQueueIndexedProperty[])

Возвращает коллекцию очередей печати, которые размещаются на сервере печати и у которых инициализированы только свойства, указанные в массиве PrintQueueIndexedProperty.Gets a collection of print queues that are hosted by the print server and initialized only in the properties that are specified in the PrintQueueIndexedProperty array.

(Унаследовано от PrintServer)
GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[])

Возвращает коллекцию очередей печати заданных типов.Gets a collection of print queues of the specified types. У этих очередей печати инициализируются только те свойства, которые указаны в массиве PrintQueueIndexedProperty.These print queues are only initialized in the properties that are specified in the PrintQueueIndexedProperty array.

(Унаследовано от PrintServer)
GetPrintQueues(String[])

Возвращает коллекцию очередей печати, которые размещаются на сервере печати и у которых инициализированы только указанные свойства.Gets a collection of print queues that are hosted by the print server and that are initialized only in the specified properties.

(Унаследовано от PrintServer)
GetPrintQueues(String[], EnumeratedPrintQueueTypes[])

Возвращает коллекцию очередей печати определенного типа EnumeratedPrintQueueTypes, у которых инициализируются только указанные свойства.Gets the collection of print queues, which are of the specified EnumeratedPrintQueueTypes and are initialized only in the specified properties.

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

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

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

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

(Унаследовано от PrintSystemObject)
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)

Устанавливает очередь печати и связанный драйвер принтера на сервере печати.Installs a print queue, and associated printer driver, on the print server.

(Унаследовано от PrintServer)
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)

Устанавливает очередь печати и связанный драйвер принтера на сервере печати.Installs a print queue, and associated printer driver, on the print server.

(Унаследовано от PrintServer)
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)

Устанавливает приоритетную очередь печати и связанный драйвер принтера на сервере печати.Installs a prioritized print queue, and associated printer driver, on the print server.

(Унаследовано от PrintServer)
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)

Устанавливает общую приоритетную очередь печати и связанный драйвер принтера на сервере печати.Installs a shared, prioritized print queue, and associated printer driver, on the print server.

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

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

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

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

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

Обновляет свойства объекта LocalPrintServer, чтобы их значения соответствовали значениям сервера печати, представленного объектом.Updates the properties of the LocalPrintServer object so that their values match the values of the print server that the object represents.

ToString()

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

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

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

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