PrintServer Klasse

Definition

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
Abgeleitet

Beispiele

Das folgende Beispiel zeigt, wie Sie eine instance von PrintServererstellen.


// 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 von PrintServerschreibt, hat diese Änderung keine Auswirkungen, bis sie an den Computer übergeben wird, der durch das PrintServer -Objekt dargestellt wird. Verwenden Sie zum Committen von Änderungen 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 nicht für die System.Printing Verwendung innerhalb eines Windows-Diensts oder ASP.NET-Anwendung oder -Diensts unterstützt. Der Versuch, diese Klassen aus einem dieser Anwendungstypen zu verwenden, kann zu unerwarteten Problemen führen, z. B. verminderte Dienstleistung und Laufzeitausnahmen.

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

Nicht verwenden.

DefaultSchedulerPriority

Nicht verwenden.

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:

Weitere Informationen