PrintServer 類別

定義

命名空間:

System.Printing

組件:

System.Printing.dll

管理列印伺服器上的列印佇列，而列印伺服器通常是電腦，但也可以是專屬的硬體列印伺服器應用裝置。

public ref class PrintServer : System::Printing::PrintSystemObject

public class PrintServer : System.Printing.PrintSystemObject

type PrintServer = class
    inherit PrintSystemObject

Public Class PrintServer
Inherits PrintSystemObject

繼承

Object

PrintSystemObject

PrintServer

衍生

System.Printing.LocalPrintServer

範例

下列範例示範如何建立 的 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	取得或設定透過印表機通訊埠管理 I/O 之處理序的執行緒優先權。
PropertiesCollection	取得屬性和值組的集合。 (繼承來源 PrintSystemObject)
RestartJobOnPoolEnabled	取得或設定值，指出使用者在啟動印表機集區下，是否能在發生錯誤後重新啟動工作。
RestartJobOnPoolTimeout	取得或設定值，指出如果在啟動印表機集區時發生錯誤，重新啟動工作之前的等待時間。
SchedulerPriority	取得或設定處理序的執行緒優先權，這個處理序會將列印工作從應用程式傳送到列印佇列。
SubSystemVersion	取得列印多工緩衝處理程式系統的版本。

方法

Commit()	將應用程式對列印伺服器物件之屬性所做的任何變更寫入至該物件所代表的列印伺服器，以認可所有的變更。
DeletePrintQueue(PrintQueue)	從列印伺服器中移除指定的 PrintQueue。
DeletePrintQueue(String)	從列印伺服器中移除指定名稱的列印佇列。
Dispose()	釋放 PrintSystemObject 所使用的所有資源。 (繼承來源 PrintSystemObject)
Dispose(Boolean)	釋放 PrintSystemObject 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 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 所使用的 Unmanaged 資源，並選擇性釋放 Managed 資源。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Refresh()	更新 PrintServer 物件的屬性 (Property)，讓每個屬性值符合物件所代表之列印伺服器的對應屬性 (Attribute) 值。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• PrintQueue
• LocalPrintServer