PrintQueue Klasse

Definition

Namespace:

System.Printing

Assembly:

System.Printing.dll

Verwaltet Drucker und Druckaufträge.

public ref class PrintQueue : System::Printing::PrintSystemObject

public class PrintQueue : System.Printing.PrintSystemObject

type PrintQueue = class
    inherit PrintSystemObject

Public Class PrintQueue
Inherits PrintSystemObject

Vererbung

Object

PrintSystemObject

PrintQueue

Hinweise

Einige Eigenschaften des PrintQueue -Objekts stellen Merkmale des Hilfsprogramms für die Druckwarteschlange dar, das auf dem Computer ausgeführt wird, während andere Features oder Zustände des Druckers selbst darstellen. Beispielsweise NumberOfJobs ist ein Merkmal der Druckwarteschlange, aber Location eine Eigenschaft des Druckers. Viele der Eigenschaften des Druckers, z. B. ob er die Aufmerksamkeit des Benutzers benötigt, müssen mithilfe der Refresh -Methode vom Drucker selbst an das PrintQueue Objekt übergeben werden. Dies sollte erfolgen, bevor die entsprechende Eigenschaft (NeedUserIntervention) von Ihrem Programm gelesen wird. Wenn Das Programm die Werte einer oder mehrerer Eigenschaften eines PrintQueue Objekts ändert, muss die Änderung in das eigentliche Hilfsprogramm für die Druckwarteschlange auf dem Computer geschrieben werden. Führen Sie dies mit der -Methode aus Commit .

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

PrintQueue(PrintServer, String)	Initialisiert eine neue Instanz der PrintQueue-Klasse unter Verwendung des angegebenen PrintServer und Warteschlangennamens.
PrintQueue(PrintServer, String, Int32)	Initialisiert eine neue Instanz der PrintQueue-Klasse unter Angabe des PrintServer, des Warteschlangennamens und der Druckschemaversion.
PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der PrintQueue-Klasse unter Angabe des PrintServer, des Warteschlangennamens, der Druckschemaversion und des gewünschten Zugriffs.
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])	Initialisiert eine neue Instanz der PrintQueue-Klasse unter Angabe des PrintServer, des Warteschlangennamens und eines Arrays mit PrintQueueIndexedProperty-Werten, die initialisiert werden sollen.
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der PrintQueue-Klasse unter Angabe des PrintServer, des Warteschlangennamens, eines Arrays mit zu initialisierenden PrintQueueIndexedProperty-Werten und des gewünschten Zugriffs.
PrintQueue(PrintServer, String, PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der PrintQueue-Klasse unter Angabe des PrintServer, des Warteschlangennamens und des gewünschten Zugriffs.
PrintQueue(PrintServer, String, String[])	Initialisiert eine neue Instanz der PrintQueue-Klasse unter Angabe des PrintServer, des Warteschlangennamens und eines Arrays mit den Namen der Eigenschaften, die initialisiert werden sollen.
PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der PrintQueue-Klasse unter Angabe des PrintServer, des Warteschlangennamens, des Eigenschaftenfilters und des gewünschten Zugriffs.

Eigenschaften

AveragePagesPerMinute	Gibt die Geschwindigkeit des Druckers in Seiten pro Minute an.
ClientPrintSchemaVersion	Ruft die Version des Druckschemas ab.
Comment	Ruft den Kommentar zum Drucker ab oder legt diesen Wert fest.
CurrentJobSettings	Ruft ein Objekt ab, das die Konfigurationseinstellungen für den aktuellen Druckauftrag enthält.
DefaultPrintTicket	Ruft die Standarddruckeroptionen ab, die dieser PrintQueue zugeordnet sind, oder legt diese Optionen fest.
DefaultPriority	Ruft die Standardpriorität ab, die einem neu zur Warteschlange hinzugefügten Druckauftrag zugewiesen wird, oder legt diesen Wert fest.
Description	Ruft die Beschreibung der Druckwarteschlange ab.
FullName	Ruft den vollständigen Namen der Warteschlange ab.
HasPaperProblem	Ruft einen Wert ab, der angibt, ob beim Drucker ein nicht näher spezifiziertes Papierproblem aufgetreten ist.
HasToner	Ruft einen Wert ab, der angibt, ob Toner im Drucker verfügbar ist.
HostingPrintServer	Ruft den Druckerserver ab, von dem die Druckwarteschlange kontrolliert wird, oder legt diesen Wert fest (geschützt).
InPartialTrust	Ruft einen Wert ab, der angibt, ob die Warteschlange in einem teilweise vertrauenswürdigen Modus ausgeführt wird, der eine höhere Vertrauensebene darstellt, oder legt diesen Wert fest.
IsBidiEnabled	Ruft einen Wert ab, der angibt, ob die bidirektionale Kommunikation mit dem Drucker aktiviert ist.
IsBusy	Ruft einen Wert ab, der angibt, ob das Druckgerät ausgelastet ist.
IsDevQueryEnabled	Ruft einen Wert ab, der angibt, ob die Druckwarteschlange Dokumente speichert, wenn Dokument- und Druckerkonfiguration nicht übereinstimmen.
IsDirect	Ruft einen Wert ab, der angibt, ob die Druckwarteschlange Dokumente direkt an den Drucker sendet oder diese erst in die Warteschlange stellt.
IsDisposed	Ruft einen Wert ab, mit dem angegeben wird, ob das Objekt freigegeben wurde, oder legt diesen Wert fest. (Geerbt von PrintSystemObject)
IsDoorOpened	Ruft einen Wert ab, der angibt, ob eine Tür am Drucker geöffnet ist.
IsHidden	Ruft einen Wert ab, der angibt, ob die Druckwarteschlange in der Benutzeroberfläche der Anwendung ausgeblendet wird.
IsInError	Ruft einen Wert ab, der angibt, ob der Drucker oder das Gerät ein Fehlerzustand aufweist.
IsInitializing	Ruft einen Wert ab, der angibt, ob der Drucker zurzeit eine Initialisierung durchführt.
IsIOActive	Ruft einen Wert ab, der angibt, ob der Drucker gerade Daten oder Signale empfängt oder sendet.
IsManualFeedRequired	Ruft einen Wert ab, der angibt, ob für den aktuellen Druckauftrag manuell Papier im Drucker eingelegt werden muss.
IsNotAvailable	Ruft einen Wert ab, der angibt, ob der Drucker verfügbar ist.
IsOffline	Ruft einen Wert ab, der angibt, ob der Drucker offline ist.
IsOutOfMemory	Ruft einen Wert ab, der angibt, ob der Arbeitsspeicher des Druckers ausgelastet ist.
IsOutOfPaper	Ruft einen Wert ab, der angibt, ob für den aktuellen Druckauftrag neues Papier mit der entsprechenden Größe im Drucker eingelegt werden muss.
IsOutputBinFull	Ruft einen Wert ab, der angibt, ob das Ausgabefach des Druckers voll ist.
IsPaperJammed	Ruft einen Wert ab, der angibt, ob ein Papierstau im Drucker vorliegt.
IsPaused	Ruft einen Wert ab, der angibt, ob die Druckwarteschlange angehalten wurde.
IsPendingDeletion	Ruft einen Wert ab, der angibt, ob der Drucker gerade einen Druckauftrag löscht.
IsPowerSaveOn	Ruft einen Wert ab, der angibt, ob sich der Drucker gegenwärtig im Energiesparmodus befindet.
IsPrinting	Ruft einen Wert ab, der angibt, ob zurzeit ein Auftrag gedruckt wird.
IsProcessing	Ruft einen Wert ab, der angibt, ob der Drucker gerade einen Druckauftrag verarbeitet.
IsPublished	Ruft einen Wert ab, der angibt, ob der Drucker für andere Netzwerkbenutzer sichtbar ist.
IsQueued	Ruft einen Wert ab, der angibt, ob der Drucker Druckwarteschlangen unterstützt, die mehrere Druckaufträge gleichzeitig speichern.
IsRawOnlyEnabled	Ruft einen Wert ab, der angibt, ob die Druckwarteschlange EMF (Enhanced Meta File) für einen schnelleren Datenfluss zwischen druckenden Anwendungen und dem Spooler von Windows verwenden kann.
IsServerUnknown	Ruft einen Wert ab, der angibt, ob der Drucker einen Fehlerzustand aufweist.
IsShared	Ruft einen Wert ab, der angibt, ob der Drucker für andere Computer im Netzwerk verfügbar ist.
IsTonerLow	Ruft einen Wert ab, der angibt, ob der Tonerstand des Druckers niedrig ist.
IsWaiting	Ruft einen Wert ab, der angibt, ob die Warteschlange auf das Hinzufügen eines Auftrags wartet.
IsWarmingUp	Ruft einen Wert ab, der angibt, ob sich der Drucker in der Aufwärmphase befindet.
IsXpsDevice	Ruft einen Wert ab, der angibt, ob der Druckertreiber auf der XPSDrv-Modell basiert und daher XPS (XML Paper Specification) als Seitenbeschreibungssprache verwendet.
KeepPrintedJobs	Ruft einen Wert ab, der angibt, ob die Warteschlange die Druckersprachdatei nach dem Drucken speichert oder löscht.
Location	Ruft den physischen Standort des Druckers ab oder legt diesen fest.
MaxPrintSchemaVersion	Ruft die letzte mögliche Versionsnummer des Druckschemas ab, die die Warteschlange verwenden kann.
Name	Ruft den Namen der Druckwarteschlange ab oder legt diesen fest.
NeedUserIntervention	Ruft einen Wert ab, der angibt, ob beim Drucker ein Benutzereingriff erforderlich ist.
NumberOfJobs	Ruft die Zahl der Aufträge in der Druckwarteschlange ab.
PagePunt	Ruft einen Wert ab, der angibt, ob beim Drucken der aktuellen Seite ein Fehler aufgetreten ist.
Parent	Ruft das übergeordnete Element des Objekts ab. (Geerbt von PrintSystemObject)
PrintingIsCancelled	Ruft einen Wert ab, der angibt, ob der aktuelle Druckauftrag gerade abgebrochen wird, oder legt diesen Wert fest.
Priority	Ruft die Priorität der Druckwarteschlange relativ zu anderen Druckwarteschlangen ab, die von demselben Druckerserver verwaltet werden und denselben physischen Drucker verwenden, oder legt die Priorität fest.
PropertiesCollection	Ruft eine Auflistung mit Attribut-Wert-Paaren ab. (Geerbt von PrintSystemObject)
QueueAttributes	Ruft die Eigenschaften der Druckwarteschlange ab.
QueueDriver	Ruft den Druckertreiber der Warteschlange ab oder legt diesen fest.
QueuePort	Ruft den Anschluss ab, den die Warteschlange verwendet, oder legt diesen fest.
QueuePrintProcessor	Ruft den von der Warteschlange verwendeten Druckprozessor ab oder legt diesen fest.
QueueStatus	Ruft einen Wert ab, der den Druckerstatus angibt. Hierzu gehören Angaben wie "Aufwärmphase", "Initialisierung", "Drucken" usw.
ScheduleCompletedJobsFirst	Ruft einen Wert ab, der angibt, ob der Drucker vollständig an die Warteschlange übertragene Aufträge vor anderen Aufträgen druckt, deren Übertragung noch nicht abgeschlossen ist, auch wenn ein unvollständiger Auftrag früher an die Warteschlange gesendet wurde oder eine höhere Priorität aufweist.
SeparatorFile	Ruft den Pfad und Dateinamen einer Datei ab, die am Anfang jedes Druckauftrags eingefügt wird, oder legt diesen fest.
ShareName	Ruft den Druckernamen ab, der Netwerkbenutzern als Freigabename für den Drucker angezeigt wird, oder legt diesen fest.
StartTimeOfDay	Ruft die früheste Tageszeit ab, zu der der Drucker einen Druckauftrag ausführt, oder legt diese Zeit fest. Die Zeit wird in Minuten nach Mitternacht UTC (Coordinated Universal Time) angegeben (wird auch als "Greenwich Mean Time" bzw. GMT bezeichnet).
UntilTimeOfDay	Ruft die späteste Tageszeit ab, zu der der Drucker einen Druckauftrag ausführt, oder legt diese Zeit fest. Die Zeit wird in Minuten nach Mitternacht UTC (Coordinated Universal Time) angegeben (wird auch als "Greenwich Mean Time" bzw. GMT bezeichnet).
UserPrintTicket	Ruft das Standardobjekt PrintTicket des aktuellen Benutzers ab, das detaillierte Informationen zum Druckauftrag enthält, oder legt es fest.

Methoden

AddJob()	Fügt einen neuen (i. d. R. einen angegebenen) Druckauftrag, dessen Inhalt ein Byte-Array ist, in die Warteschlange ein.
AddJob(String)	Fügt einen neuen Druckauftrag, dessen Inhalt ein Byte-Array ist, in die Warteschlange ein.
AddJob(String, PrintTicket)	Fügt einen neuen Druckauftrag für ein XPS-Dokument (XML Paper Specification) in die Warteschlange ein und gibt ihr den angegebenen Namen und die angegebenen Einstellungen.
AddJob(String, String, Boolean)	Fügt einen neuen Druckauftrag für ein XPS-Dokument (XML Paper Specification) in die Warteschlange ein, gibt den angegebenen Namen an und gibt an, ob er überprüft werden soll.
AddJob(String, String, Boolean, PrintTicket)	Fügt einen neuen Druckauftrag für ein XPS-Dokument (XML Paper Specification) in die Warteschlange ein, gibt den angegebenen Namen und die angegebenen Einstellungen an und gibt an, ob er überprüft werden soll.
Commit()	Schreibt die aktuellen Eigenschaftswerte des PrintQueue-Objekts in die Druckwarteschlange auf dem Druckerserver.
CreateXpsDocumentWriter(Double, Double)	Erstellt ein XpsDocumentWriter-Objekt mit den angegebenen Abmessungen.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog, an den Seitenbereich und Auftragsbeschreibung übergeben werden, und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(PrintQueue)	Erstellt ein XpsDocumentWriter-Objekt und weist es der angegebenen Druckwarteschlange zu.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog (an den die Auftragsbeschreibung übergeben wird) und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog, an den ein Seitenbereich übergeben wird, und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.
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)
GetJob(Int32)	Ruft den Druckauftrag mit der angegebenen ID-Nummer ab.
GetPrintCapabilities()	Ruft ein PrintCapabilities-Objekt ab, das die Fähigkeiten des Druckers angibt.
GetPrintCapabilities(PrintTicket)	Ruft ein PrintCapabilities-Objekt ab, das die Fähigkeiten des Druckers angibt.
GetPrintCapabilitiesAsXml()	Ruft ein MemoryStream-Objekt ab, das die Funktionen des Druckers als XML-Stream angibt, der das Druckschema einhält.
GetPrintCapabilitiesAsXml(PrintTicket)	Ruft ein MemoryStream-Objekt ab, das die Funktionen des Druckers im XML-Format angibt, das dem Druckschema entspricht.
GetPrintJobInfoCollection()	Erstellt eine Auflistung, die ein PrintSystemJobInfo-Objekt für jeden Auftrag in der Warteschlange enthält.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Initialize()	Initialisiert die Eigenschaften des PrintSystemObject. (Geerbt von PrintSystemObject)
InternalDispose(Boolean)	Gibt die von PrintQueue verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)	Führt zwei PrintTickets zusammen und gewährleistet, dass das erstellte PrintTicket gültig ist und keine Druckfunktionen anfordert, die vom Drucker nicht unterstützt werden.
MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)	Führt zwei PrintTickets zusammen und gewährleistet, dass das erstellte PrintTicket gültig ist, keine Druckfunktionen anfordert, die vom Drucker nicht unterstützt werden, und auf den angegebenen Gültigkeitsbereich begrenzt ist.
Pause()	Hält die Druckwarteschlange an. Sie bleibt angehalten, bis Resume() ausgeführt wird.
Purge()	Entfernt alle Aufträge aus der Druckwarteschlange.
Refresh()	Aktualisiert die Eigenschaften des PrintQueue-Objekts mit den Werten des Druckers und des Druckwarteschlangen-Dienstprogramms, das auf dem Computer ausgeführt wird.
Resume()	Startet eine angehaltene Druckwarteschlange neu.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• PrintServer