LocalPrintServer 类

参考

定义

命名空间:: System.Printing

程序集:: System.Printing.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示本地打印服务器（应用程序正在其上运行的计算机）和启用其打印队列的管理。

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

继承: Object

PrintSystemObject

PrintServer
LocalPrintServer

示例

下面的示例演示如何创建 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 窗体应用程序打印，请参阅 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	获取或设置管理打印机端口 I/O 的进程的线程优先级别。 (继承自 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)

适用于

另请参阅

PrintServer

LocalPrintServer 类

定义

示例

注解

构造函数

属性

方法

适用于

另请参阅

反馈

其他资源