PrintServer Klasse

Referenz

Definition

Namespace:: System.Printing

Assembly:: System.Printing.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Verwaltet die Druckwarteschlangen auf einem Druckerserver. Hierbei kann es sich um einen Computer oder um ein dediziertes als Druckerserver fungierendes Hardwaregerät handeln.

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

public class PrintServer : System.Printing.PrintSystemObject

type PrintServer = class
    inherit PrintSystemObject

Public Class PrintServer
Inherits PrintSystemObject

Vererbung: Object

PrintSystemObject
PrintServer

Abgeleitet: System.Printing.LocalPrintServer

Beispiele

Im folgenden Beispiel wird gezeigt, wie Eine Instanz von 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()

Hinweise

Wenn Ihr Programm einen Wert in eine Eigenschaft PrintServerschreibt, hat diese Änderung keine Auswirkung, bis sie an den Computer übergeben wird, der durch das PrintServer Objekt dargestellt wird. Um Änderungen zu übernehmen, verwenden Sie die Commit Methode für das Objekt.

Ebenso können andere Anwendungen die tatsächlichen Druckdiensteigenschaften des Computers ändern. Um sicherzustellen, dass das PrintServer Objekt für Ihr Programm über die neuesten Werte verfügt, verwenden Sie die Refresh Methode für das Objekt.

Achtung

Klassen innerhalb des Namespace werden für die System.Printing Verwendung in einem Windows Dienst oder ASP.NET Anwendung oder Dienst nicht unterstützt. Beim Versuch, diese Klassen innerhalb eines dieser Anwendungstypen zu verwenden, können unerwartete Probleme auftreten, z. B. verringerte Dienstleistung und Laufzeit-Ausnahmen.

Wenn Sie aus einer Windows Forms Anwendung drucken möchten, lesen Sie den System.Drawing.Printing Namespace.

Konstruktoren

PrintServer()	Initialisiert eine neue Instanz der PrintServer-Klasse.
PrintServer(PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der PrintServer-Klasse, die den lokalen Druckerserver darstellt, und weist der Instanz den angegebenen PrintSystemDesiredAccess zu.
PrintServer(String)	Initialisiert eine neue Instanz der PrintServer-Klasse mit dem angegebenen Pfad.
PrintServer(String, PrintServerIndexedProperty[])	Initialisiert eine neue Instanz der PrintServer-Klasse. Anhand des übergebenen PrintServerIndexedProperty-Arrays wird ermittelt, welche Eigenschaften initialisiert werden sollen.
PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der PrintServer-Klasse unter Angabe eines Pfades, eines PrintServerIndexedProperty-Arrays und des benötigten Zugriffs.
PrintServer(String, PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der PrintServer-Klasse mit dem angegebenen Pfad und dem erforderlichen Zugriff.
PrintServer(String, String[])	Initialisiert eine neue Instanz der PrintServer-Klasse mit dem angegebenen Pfad und Eigenschaftenfilter.
PrintServer(String, String[], PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der PrintServer-Klasse mit dem angegebenen Pfad und Eigenschaftenfilter sowie dem benötigten Zugriff.

Eigenschaften

BeepEnabled	Ruft einen Wert ab, der angibt, ob der Druckerserver beim Auftreten eines Fehlers im Drucker einen Signalton ausgibt, oder legt diesen Wert fest
DefaultPortThreadPriority	Darf nicht verwendet werden.
DefaultSchedulerPriority	Darf nicht verwendet werden.
DefaultSpoolDirectory	Ruft den Pfad der Spooldateien des Druckerservers ab, oder legt diesen Wert fest.
EventLog	Ruft den Ereignistyp für die Ereignisprotokollierung des Druckerservers ab, oder legt diesen Wert fest.
IsDelayInitialized	Ruft einen Wert ab, der angibt, ob die Initialisierung der PrintServer-Eigenschaften zurückgestellt wurde, oder legt diesen Wert fest.
IsDisposed	Ruft einen Wert ab, mit dem angegeben wird, ob das Objekt freigegeben wurde, oder legt diesen Wert fest. (Geerbt von PrintSystemObject)
MajorVersion	Ruft die Hauptversion des Betriebssystems ab.
MinorVersion	Ruft die Nebenversionsnummer aus der Hauptversionsnummer des Betriebssystems ab.
Name	Ruft den Namen des Druckerservers ab.
NetPopup	Ruft einen Wert ab, der angibt, ob Benachrichtigungen über die Fertigstellung eines Druckauftrags an den Druckerserver oder an den Clientcomputer gesendet werden, oder legt diesen Wert fest.
Parent	Ruft das übergeordnete Element des Objekts ab. (Geerbt von PrintSystemObject)
PortThreadPriority	Ruft die Threadpriorität des Prozesses ab, der die E/A für die Druckeranschlüsse verwaltet, oder legt diesen Wert fest.
PropertiesCollection	Ruft eine Auflistung mit Attribut-Wert-Paaren ab. (Geerbt von PrintSystemObject)
RestartJobOnPoolEnabled	Ruft einen Wert ab, der angibt, ob Benutzer einen Auftrag bei aktiviertem Druckerpool neu starten können, nachdem ein Fehler aufgetreten ist, oder legt diesen Wert fest.
RestartJobOnPoolTimeout	Ruft einen Wert ab, der die Wartezeit angibt, nach der ein Auftrag bei aktiviertem Druckerpool neu gestartet werden kann, wenn ein Fehler aufgetreten ist, oder legt diesen Wert fest.
SchedulerPriority	Ruft die Threadpriorität des Prozesses ab, der Druckaufträge von Anwendungen an die Druckwarteschlangen weiterleitet, oder legt diesen Wert fest.
SubSystemVersion	Ruft die Version des Druckerspoolersystems ab.

Methoden

Commit()	Übernimmt alle Änderungen, die Ihr Programm an den Eigenschaften des Druckerserverobjekts vorgenommen hat, indem die Änderungen an den vom Objekt dargestellten Druckerserver übertragen werden.
DeletePrintQueue(PrintQueue)	Entfernt die angegebene PrintQueue vom Druckerserver.
DeletePrintQueue(String)	Entfernt die Druckwarteschlange mit dem angegebenen Namen vom Druckerserver.
Dispose()	Gibt alle vom PrintSystemObject verwendeten Ressourcen frei. (Geerbt von PrintSystemObject)
Dispose(Boolean)	Gibt die von PrintSystemObject verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von PrintSystemObject)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetPrintQueue(String)	Erstellt einen Verweis auf die genannte Druckwarteschlange auf dem Druckerserver.
GetPrintQueue(String, String[])	Ruft eine angegebene Druckwarteschlange vom Druckerserver ab.
GetPrintQueues()	Ruft die Auflistung der Druckwarteschlangen ab, die vom Druckerserver verwaltet werden.
GetPrintQueues(EnumeratedPrintQueueTypes[])	Ruft eine Auflistung der Druckwarteschlangen ab, die vom Druckerserver verwaltet werden und einen der in EnumeratedPrintQueueTypes angegebenen Typen aufweisen.
GetPrintQueues(PrintQueueIndexedProperty[])	Ruft eine Auflistung der Druckwarteschlangen ab, die vom Druckerserver verwaltet werden und bei denen nur die im PrintQueueIndexedProperty-Array angegebenen Eigenschaften initialisiert wurden.
GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[])	Ruft eine Auflistung der Druckwarteschlangen mit den angegebenen Typen ab. Bei diesen Druckwarteschlangen sind nur die im PrintQueueIndexedProperty-Array angegebenen Eigenschaften initialisiert.
GetPrintQueues(String[])	Ruft eine Auflistung von Druckwarteschlangen ab, die vom Druckerserver verwaltet werden und bei denen nur die angegebenen Eigenschaften initialisiert werden.
GetPrintQueues(String[], EnumeratedPrintQueueTypes[])	Ruft eine Auflistung der Druckwarteschlangen ab, die einem der in EnumeratedPrintQueueTypes angegebenen Typen entsprechen und bei denen nur die angegebenen Eigenschaften initialisiert werden.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Initialize()	Initialisiert die Eigenschaften des PrintSystemObject. (Geerbt von PrintSystemObject)
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)	Installiert auf dem Druckerserver eine Druckwarteschlange und den zugehörigen Druckertreiber.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)	Installiert auf dem Druckerserver eine Druckwarteschlange und den zugehörigen Druckertreiber.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)	Installiert auf dem Druckerserver eine priorisierte Druckwarteschlange und den zugehörigen Druckertreiber.
InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, String, String, String, String, Int32, Int32)	Installiert auf dem Druckerserver eine freigegebene, priorisierte Druckwarteschlange und den zugehörigen Druckertreiber.
InternalDispose(Boolean)	Gibt die von PrintServer verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Refresh()	Aktualisiert die Eigenschaften des PrintServer-Objekts, sodass jeder Eigenschaftswert dem zugehörigen Attributwert des Druckerservers entspricht, den das Objekt darstellt.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für