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.Manages the print queues on a print server, which is usually a computer, but can be a dedicated hardware print server appliance.

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

Im folgenden Beispiel wird gezeigt, wie eine Instanz von PrintServererstellt wird.The following example shows how to create an instance of 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 das Programm einen Wert in eine Eigenschaft von PrintServerschreibt, hat diese Änderung keine Auswirkungen, bis Sie an den Computer weitergegeben wird, der durch das PrintServer -Objekt dargestellt wird.When your program writes a value to a property of PrintServer, that change has no effect until it is passed on to the computer that is represented by the PrintServer object. Um Änderungen zu übertragen, Commit verwenden Sie die-Methode für das-Objekt.To commit changes, use the Commit method for the object.

Ebenso können andere Anwendungen die tatsächlichen Druckdienst Eigenschaften des Computers ändern.Similarly, other applications may change the actual print service properties of the computer. Um sicherzustellen, dass PrintServer das-Objekt für das Programm über die neuesten Werte verfügt Refresh , verwenden Sie die-Methode für das-Objekt.To make sure that the PrintServer object for your program has the latest values, use the Refresh method for the object.

Achtung

Klassen im- System.Printing Namespace werden nicht für die Verwendung in einem Windows-Dienst oder einer ASP.NET-Anwendung oder einem-Dienst unterstützt.Classes within the System.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Der Versuch, diese Klassen innerhalb eines dieser Anwendungs Typen zu verwenden, kann zu unerwarteten Problemen führen, wie z. b. verminderter Dienstleistung und Lauf Zeit Ausnahmen.Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Wenn Sie aus einer Windows Forms Anwendung drucken möchten, finden Sie weitere System.Drawing.Printing Informationen unter dem-Namespace.If you want to print from a Windows Forms application, see the System.Drawing.Printing namespace.

Konstruktoren

PrintServer()

Initialisiert eine neue Instanz der PrintServer-Klasse.Initializes a new instance of the PrintServer class.

PrintServer(PrintSystemDesiredAccess)

Initialisiert eine neue Instanz der PrintServer-Klasse, die den lokalen Druckerserver darstellt, und weist der Instanz den angegebenen PrintSystemDesiredAccess zu.Initializes a new instance of the PrintServer class that represents the local print server and assigns it the specified PrintSystemDesiredAccess.

PrintServer(String)

Initialisiert eine neue Instanz der PrintServer-Klasse mit dem angegebenen Pfad.Initializes a new instance of the PrintServer class that has the specified path.

PrintServer(String, PrintServerIndexedProperty[])

Initialisiert eine neue Instanz der PrintServer-Klasse. Anhand des übergebenen PrintServerIndexedProperty-Arrays wird ermittelt, welche Eigenschaften initialisiert werden sollen.Initializes a new instance of the PrintServer class by using the specified PrintServerIndexedProperty array to determine which properties will be initialized.

PrintServer(String, PrintServerIndexedProperty[], PrintSystemDesiredAccess)

Initialisiert eine neue Instanz der PrintServer-Klasse unter Angabe eines Pfades, eines PrintServerIndexedProperty-Arrays und des benötigten Zugriffs.Initializes a new instance of the PrintServer class and provides the specified path, the PrintServerIndexedProperty array, and the needed access.

PrintServer(String, PrintSystemDesiredAccess)

Initialisiert eine neue Instanz der PrintServer-Klasse mit dem angegebenen Pfad und dem erforderlichen Zugriff.Initializes a new instance of the PrintServer class that has the specified path and the needed access.

PrintServer(String, String[])

Initialisiert eine neue Instanz der PrintServer-Klasse mit dem angegebenen Pfad und Eigenschaftenfilter.Initializes a new instance of the PrintServer class that has the specified path and properties filter.

PrintServer(String, String[], PrintSystemDesiredAccess)

Initialisiert eine neue Instanz der PrintServer-Klasse mit dem angegebenen Pfad und Eigenschaftenfilter sowie dem benötigten Zugriff.Initializes a new instance of the PrintServer class that has the specified path, properties filter, and the needed access.

Eigenschaften

BeepEnabled

Ruft einen Wert ab, der angibt, ob der Druckerserver beim Auftreten eines Fehlers im Drucker einen Signalton ausgibt, oder legt diesen Wert festGets or sets a value that indicates whether the print server beeps in response to an error condition in the printer.

DefaultPortThreadPriority

Nicht verwenden.Do not use.

DefaultSchedulerPriority

Nicht verwenden.Do not use.

DefaultSpoolDirectory

Ruft den Pfad der Spooldateien des Druckerservers ab, oder legt diesen Wert fest.Gets or sets the path where the print server's spool files are located.

EventLog

Ruft den Ereignistyp für die Ereignisprotokollierung des Druckerservers ab, oder legt diesen Wert fest.Gets or sets the type of events that the print server logs.

IsDelayInitialized

Ruft einen Wert ab, der angibt, ob die Initialisierung der PrintServer-Eigenschaften zurückgestellt wurde, oder legt diesen Wert fest.Gets or sets a value that indicates whether initialization of the PrintServer properties has been postponed.

IsDisposed

Ruft einen Wert ab, mit dem angegeben wird, ob das Objekt freigegeben wurde, oder legt diesen Wert fest.Gets or sets a value that indicates whether the object has been disposed.

(Geerbt von PrintSystemObject)
MajorVersion

Ruft die Hauptversion des Betriebssystems ab.Gets the major version of the operating system.

MinorVersion

Ruft die Nebenversionsnummer aus der Hauptversionsnummer des Betriebssystems ab.Gets the minor version within the major version of the operating system.

Name

Ruft den Namen des Druckerservers ab.Gets the name of the print server.

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.Gets or sets a value that indicates whether notifications that a print job has finished are sent to either the print server or the client computer.

Parent

Ruft das übergeordnete Element des Objekts ab.Gets the parent of the object.

(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.Gets or sets the thread priority for the process that manages I/O through the printer ports.

PropertiesCollection

Ruft eine Auflistung mit Attribut-Wert-Paaren ab.Gets a collection of attribute and value pairs.

(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.Gets or sets a value that indicates whether users can restart jobs after an error occurs if printer pooling is enabled.

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.Gets or sets a value that indicates the wait time before a job can be restarted, if an error occurs when printer pooling is also enabled.

SchedulerPriority

Ruft die Threadpriorität des Prozesses ab, der Druckaufträge von Anwendungen an die Druckwarteschlangen weiterleitet, oder legt diesen Wert fest.Gets or sets the thread priority for the process that routes print jobs from applications to print queues.

SubSystemVersion

Ruft die Version des Druckerspoolersystems ab.Gets the version of the print spooler system.

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.Commits any changes that your program made to the properties of the print server object by writing them to the print server that the object represents.

DeletePrintQueue(PrintQueue)

Entfernt die angegebene PrintQueue vom Druckerserver.Removes the specified PrintQueue from the print server.

DeletePrintQueue(String)

Entfernt die Druckwarteschlange mit dem angegebenen Namen vom Druckerserver.Removes the print queue with the specified name from the print server.

Dispose()

Gibt alle vom PrintSystemObject verwendeten Ressourcen frei.Releases all resources used by the PrintSystemObject.

(Geerbt von PrintSystemObject)
Dispose(Boolean)

Gibt die von PrintSystemObject verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the PrintSystemObject and optionally releases the managed resources.

(Geerbt von PrintSystemObject)
Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetPrintQueue(String)

Erstellt einen Verweis auf die genannte Druckwarteschlange auf dem Druckerserver.Obtains a reference to the named print queue from the print server.

GetPrintQueue(String, String[])

Ruft eine angegebene Druckwarteschlange vom Druckerserver ab.Gets a specified print queue from the print server.

GetPrintQueues()

Ruft die Auflistung der Druckwarteschlangen ab, die vom Druckerserver verwaltet werden.Gets the collection of print queues that the print server hosts.

GetPrintQueues(EnumeratedPrintQueueTypes[])

Ruft eine Auflistung der Druckwarteschlangen ab, die vom Druckerserver verwaltet werden und einen der in EnumeratedPrintQueueTypes angegebenen Typen aufweisen.Gets the collection of print queues of the specified types that are named in EnumeratedPrintQueueTypes and hosted by the print server.

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.Gets a collection of print queues that are hosted by the print server and initialized only in the properties that are specified in the PrintQueueIndexedProperty array.

GetPrintQueues(PrintQueueIndexedProperty[], EnumeratedPrintQueueTypes[])

Ruft eine Auflistung der Druckwarteschlangen mit den angegebenen Typen ab.Gets a collection of print queues of the specified types. Bei diesen Druckwarteschlangen sind nur die im PrintQueueIndexedProperty-Array angegebenen Eigenschaften initialisiert.These print queues are only initialized in the properties that are specified in the PrintQueueIndexedProperty array.

GetPrintQueues(String[])

Ruft eine Auflistung von Druckwarteschlangen ab, die vom Druckerserver verwaltet werden und bei denen nur die angegebenen Eigenschaften initialisiert werden.Gets a collection of print queues that are hosted by the print server and that are initialized only in the specified properties.

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.Gets the collection of print queues, which are of the specified EnumeratedPrintQueueTypes and are initialized only in the specified properties.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
Initialize()

Initialisiert die Eigenschaften des PrintSystemObject.Initializes the properties of the PrintSystemObject.

(Geerbt von PrintSystemObject)
InstallPrintQueue(String, String, String[], String, PrintPropertyDictionary)

Installiert auf dem Druckerserver eine Druckwarteschlange und den zugehörigen Druckertreiber.Installs a print queue, and associated printer driver, on the print server.

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes)

Installiert auf dem Druckerserver eine Druckwarteschlange und den zugehörigen Druckertreiber.Installs a print queue, and associated printer driver, on the print server.

InstallPrintQueue(String, String, String[], String, PrintQueueAttributes, PrintQueueStringProperty, Int32, Int32)

Installiert auf dem Druckerserver eine priorisierte Druckwarteschlange und den zugehörigen Druckertreiber.Installs a prioritized print queue, and associated printer driver, on the print server.

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.Installs a shared, prioritized print queue, and associated printer driver, on the print server.

InternalDispose(Boolean)

Gibt die von PrintServer verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei.Releases the unmanaged resources that are used by the PrintServer and optionally releases the managed resources.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current 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.Updates the properties of the PrintServer object so that each property value matches the corresponding attribute value of the print server that the object represents.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch