PrintServer 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 PrintServer 類別的新執行個體。
多載
| 名稱 | Description |
|---|---|
| PrintServer() |
初始化 PrintServer 類別的新執行個體。 |
| PrintServer(PrintSystemDesiredAccess) |
初始化代表本地列印伺服器的類別新實例 PrintServer ,並指派指定的 PrintSystemDesiredAccess。 |
| PrintServer(String) |
初始化一個擁有指定路徑的類別新實例 PrintServer 。 |
| PrintServer(String, PrintServerIndexedProperty[]) |
透過使用指定的PrintServer陣列初始化該類別的新實例PrintServerIndexedProperty,以決定將被初始化的屬性。 |
| PrintServer(String, PrintSystemDesiredAccess) |
初始化一個擁有指定路徑與所需存取權限的類別新實例 PrintServer 。 |
| PrintServer(String, String[]) |
初始化一個擁有指定路徑與屬性過濾器的類別新實例 PrintServer 。 |
| PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess) |
初始化該類別的新實例 PrintServer ,並提供指定的路徑、 PrintServerIndexedProperty 陣列及所需的存取權限。 |
| PrintServer(String, String[], PrintSystemDesiredAccess) |
初始化一個擁有指定路徑、屬性篩選器及所需存取權限的類別新實例 PrintServer 。 |
PrintServer()
PrintServer(PrintSystemDesiredAccess)
初始化代表本地列印伺服器的類別新實例 PrintServer ,並指派指定的 PrintSystemDesiredAccess。
public:
PrintServer(System::Printing::PrintSystemDesiredAccess desiredAccess);
public PrintServer(System.Printing.PrintSystemDesiredAccess desiredAccess);
new System.Printing.PrintServer : System.Printing.PrintSystemDesiredAccess -> System.Printing.PrintServer
Public Sub New (desiredAccess As PrintSystemDesiredAccess)
參數
- desiredAccess
- PrintSystemDesiredAccess
一個指定你程式需要的列印伺服器存取類型的值。
例外狀況
desiredAccess 是一個只能套用於 PrintQueue 物件的值,而非物件本身 LocalPrintServer 。 例如: UsePrinter 。
備註
將 PrintServer 以本地列印伺服器的屬性初始化,例如 Name。
適用於
PrintServer(String)
初始化一個擁有指定路徑的類別新實例 PrintServer 。
public:
PrintServer(System::String ^ path);
public PrintServer(string path);
new System.Printing.PrintServer : string -> System.Printing.PrintServer
Public Sub New (path As String)
參數
- path
- String
列印伺服器的名稱與完整路徑。
範例
以下範例說明如何使用此建構子來建立 的 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()
備註
若path為 ,則 null 將代表本地列印伺服器,並以其屬性初始化,例如 PrintServerName。
適用於
PrintServer(String, PrintServerIndexedProperty[])
透過使用指定的PrintServer陣列初始化該類別的新實例PrintServerIndexedProperty,以決定將被初始化的屬性。
public:
PrintServer(System::String ^ path, cli::array <System::Printing::PrintServerIndexedProperty> ^ propertiesFilter);
public PrintServer(string path, System.Printing.PrintServerIndexedProperty[] propertiesFilter);
new System.Printing.PrintServer : string * System.Printing.PrintServerIndexedProperty[] -> System.Printing.PrintServer
Public Sub New (path As String, propertiesFilter As PrintServerIndexedProperty())
參數
- path
- String
列印伺服器的完整路徑與名稱。
- propertiesFilter
- PrintServerIndexedProperty[]
建構子初始化的屬性。
備註
若path為 ,則 null 將代表本地列印伺服器,並以其屬性初始化,例如 PrintServerName。
適用於
PrintServer(String, PrintSystemDesiredAccess)
初始化一個擁有指定路徑與所需存取權限的類別新實例 PrintServer 。
public:
PrintServer(System::String ^ path, System::Printing::PrintSystemDesiredAccess desiredAccess);
public PrintServer(string path, System.Printing.PrintSystemDesiredAccess desiredAccess);
new System.Printing.PrintServer : string * System.Printing.PrintSystemDesiredAccess -> System.Printing.PrintServer
Public Sub New (path As String, desiredAccess As PrintSystemDesiredAccess)
參數
- path
- String
列印伺服器的名稱與完整路徑。
- desiredAccess
- PrintSystemDesiredAccess
一個指定你程式需要的列印伺服器存取類型的值。
例外狀況
desiredAccess 是一個只能套用於 PrintQueue 物件的值,而非物件本身 LocalPrintServer 。 例如: UsePrinter 。
範例
以下範例說明如何使用此建構器來調查所有印表機,以判斷可能的錯誤狀態。
// Survey queue status for every queue on every print server
System::String^ line;
System::String^ statusReport = "\n\nAny problem states are indicated below:\n\n";
while ((line = fileOfPrintServers->ReadLine()) != nullptr)
{
System::Printing::PrintServer^ myPS = gcnew System::Printing::PrintServer(line, PrintSystemDesiredAccess::AdministrateServer);
System::Printing::PrintQueueCollection^ myPrintQueues = myPS->GetPrintQueues();
statusReport = statusReport + "\n" + line;
for each (System::Printing::PrintQueue^ pq in myPrintQueues)
{
pq->Refresh();
statusReport = statusReport + "\n\t" + pq->Name + ":";
if (useAttributesResponse == "y")
{
TroubleSpotter::SpotTroubleUsingQueueAttributes(statusReport, pq);
// TroubleSpotter class is defined in the complete example.
} else
{
TroubleSpotter::SpotTroubleUsingProperties(statusReport, pq);
}
}
}
fileOfPrintServers->Close();
Console::WriteLine(statusReport);
Console::WriteLine("\nPress Return to continue.");
Console::ReadLine();
// Survey queue status for every queue on every print server
String line;
String statusReport = "\n\nAny problem states are indicated below:\n\n";
while ((line = fileOfPrintServers.ReadLine()) != null)
{
PrintServer myPS = new PrintServer(line, PrintSystemDesiredAccess.AdministrateServer);
PrintQueueCollection myPrintQueues = myPS.GetPrintQueues();
statusReport = statusReport + "\n" + line;
foreach (PrintQueue pq in myPrintQueues)
{
pq.Refresh();
statusReport = statusReport + "\n\t" + pq.Name + ":";
if (useAttributesResponse == "y")
{
TroubleSpotter.SpotTroubleUsingQueueAttributes(ref statusReport, pq);
// TroubleSpotter class is defined in the complete example.
}
else
{
TroubleSpotter.SpotTroubleUsingProperties(ref statusReport, pq);
}
}// end for each print queue
}// end while list of print servers is not yet exhausted
fileOfPrintServers.Close();
Console.WriteLine(statusReport);
Console.WriteLine("\nPress Return to continue.");
Console.ReadLine();
' Survey queue status for every queue on every print server
Dim line As String
Dim statusReport As String = vbLf & vbLf & "Any problem states are indicated below:" & vbLf & vbLf
line = fileOfPrintServers.ReadLine()
Do While line IsNot Nothing
Dim myPS As New PrintServer(line, PrintSystemDesiredAccess.AdministrateServer)
Dim myPrintQueues As PrintQueueCollection = myPS.GetPrintQueues()
statusReport = statusReport & vbLf & line
For Each pq As PrintQueue In myPrintQueues
pq.Refresh()
statusReport = statusReport & vbLf & vbTab & pq.Name & ":"
If useAttributesResponse = "y" Then
TroubleSpotter.SpotTroubleUsingQueueAttributes(statusReport, pq)
' TroubleSpotter class is defined in the complete example.
Else
TroubleSpotter.SpotTroubleUsingProperties(statusReport, pq)
End If
Next pq ' end for each print queue
line = fileOfPrintServers.ReadLine()
Loop ' end while list of print servers is not yet exhausted
fileOfPrintServers.Close()
Console.WriteLine(statusReport)
Console.WriteLine(vbLf & "Press Return to continue.")
Console.ReadLine()
備註
若path為 ,則 null 將代表本地列印伺服器,並以其屬性初始化,例如 PrintServerName。
適用於
PrintServer(String, String[])
初始化一個擁有指定路徑與屬性過濾器的類別新實例 PrintServer 。
public:
PrintServer(System::String ^ path, cli::array <System::String ^> ^ propertiesFilter);
public PrintServer(string path, string[] propertiesFilter);
new System.Printing.PrintServer : string * string[] -> System.Printing.PrintServer
Public Sub New (path As String, propertiesFilter As String())
參數
- path
- String
列印伺服器的名稱與完整路徑。
- propertiesFilter
- String[]
一個由建構子初始化的屬性名稱陣列。
備註
若path為 ,則 null 將代表本地列印伺服器,並以其屬性初始化,例如 PrintServerName。
適用於
PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess)
初始化該類別的新實例 PrintServer ,並提供指定的路徑、 PrintServerIndexedProperty 陣列及所需的存取權限。
public:
PrintServer(System::String ^ path, cli::array <System::Printing::PrintServerIndexedProperty> ^ propertiesFilter, System::Printing::PrintSystemDesiredAccess desiredAccess);
public PrintServer(string path, System.Printing.PrintServerIndexedProperty[] propertiesFilter, System.Printing.PrintSystemDesiredAccess desiredAccess);
new System.Printing.PrintServer : string * System.Printing.PrintServerIndexedProperty[] * System.Printing.PrintSystemDesiredAccess -> System.Printing.PrintServer
Public Sub New (path As String, propertiesFilter As PrintServerIndexedProperty(), desiredAccess As PrintSystemDesiredAccess)
參數
- path
- String
列印伺服器的完整路徑與名稱。
- propertiesFilter
- PrintServerIndexedProperty[]
建構子初始化的屬性。
- desiredAccess
- PrintSystemDesiredAccess
一個指定你程式需要的列印伺服器存取類型的值。
例外狀況
desiredAccess 是一個只能套用於 PrintQueue 物件的值,而非物件本身 LocalPrintServer 。 例如: UsePrinter 。
備註
若path為 ,則 null 將代表本地列印伺服器,並以其屬性初始化,例如 PrintServerName。
適用於
PrintServer(String, String[], PrintSystemDesiredAccess)
初始化一個擁有指定路徑、屬性篩選器及所需存取權限的類別新實例 PrintServer 。
public:
PrintServer(System::String ^ path, cli::array <System::String ^> ^ propertiesFilter, System::Printing::PrintSystemDesiredAccess desiredAccess);
public PrintServer(string path, string[] propertiesFilter, System.Printing.PrintSystemDesiredAccess desiredAccess);
new System.Printing.PrintServer : string * string[] * System.Printing.PrintSystemDesiredAccess -> System.Printing.PrintServer
Public Sub New (path As String, propertiesFilter As String(), desiredAccess As PrintSystemDesiredAccess)
參數
- path
- String
列印伺服器的名稱與完整路徑。
- propertiesFilter
- String[]
一個由建構子初始化的屬性名稱陣列。
- desiredAccess
- PrintSystemDesiredAccess
一個指定你程式需要的列印伺服器存取類型的值。
例外狀況
desiredAccess 是一個只能套用於 PrintQueue 物件的值,而非物件本身 LocalPrintServer 。 例如: UsePrinter 。
備註
若path為 ,則 null 將代表本地列印伺服器,並以其屬性初始化,例如 PrintServerName。