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, andere stellen jedoch Features oder Zustände des Druckers selbst dar. Beispielsweise NumberOfJobs ist ein Merkmal der Druckwarteschlange, aber Location eine Eigenschaft des Druckers. Viele der Eigenschaften des Druckers, z. B. ob der Benutzer aufmerksamkeit 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. Entsprechend muss die Änderung, wenn Ihr Programm die Werte einer oder mehrerer Eigenschaften eines PrintQueue Objekts ändert, in das eigentliche Hilfsprogramm für die Druckwarteschlange auf dem Computer geschrieben werden. Führen Sie dazu die Commit Methode aus.

Vorsicht

Klassen im Namespace System.Printing werden nicht für die Verwendung in einem Windows-Dienst oder einer ASP.NET-Anwendung oder einem Dienst unterstützt. Wenn Sie versuchen, diese Klassen aus einem 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

Name	Beschreibung
PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der Klasse mithilfe des PrintQueue angegebenen PrintServerWarteschlangennamens, der Druckschemaversion und des gewünschten Zugriffs.
PrintQueue(PrintServer, String, Int32)	Initialisiert eine neue Instanz der Klasse mithilfe des PrintQueue angegebenen PrintServerWarteschlangennamens und der Druckschemaversion.
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der PrintQueue Klasse mit dem angegebenen PrintServerWarteschlangennamen, dem Zu initialisierenden PrintQueueIndexedProperty Wertearray und dem gewünschten Zugriff.
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])	Initialisiert eine neue Instanz der Klasse mithilfe des PrintQueue angegebenen PrintServerWarteschlangennamens und des Arrays von PrintQueueIndexedProperty Werten, die initialisiert werden sollen.
PrintQueue(PrintServer, String, PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der Klasse mithilfe des PrintQueue angegebenen PrintServerWarteschlangennamens und des gewünschten Zugriffs.
PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess)	Initialisiert eine neue Instanz der Klasse mithilfe des PrintQueue angegebenen PrintServerWarteschlangennamens, des Eigenschaftenfilters und des gewünschten Zugriffs.
PrintQueue(PrintServer, String, String[])	Initialisiert eine neue Instanz der Klasse mithilfe des PrintQueue angegebenen PrintServerWarteschlangennamens und des Arrays von Eigenschaftsnamen, die initialisiert werden sollen.
PrintQueue(PrintServer, String)	Initialisiert eine neue Instanz der Klasse mithilfe des PrintQueue angegebenen PrintServer Und Warteschlangennamens.

Eigenschaften

Name	Beschreibung
AveragePagesPerMinute	Ruft die Geschwindigkeit des Druckers in Seiten pro Minute ab.
ClientPrintSchemaVersion	Ruft die Version des Druckschemas ab.
Comment	Ruft einen Kommentar zum Drucker ab oder legt einen Kommentar fest.
CurrentJobSettings	Ruft ein Objekt ab, das die Konfigurationseinstellungen für den aktuellen Druckauftrag enthält.
DefaultPrintTicket	Dient zum Abrufen oder Festlegen der Standarddruckeroptionen, die diesem PrintQueuezugeordnet sind.
DefaultPriority	Dient zum Abrufen oder Festlegen der Standardpriorität, die jedem neuen Druckauftrag zugewiesen wird, der der Warteschlange hinzugefügt wird.
Description	Ruft eine Beschreibung der Druckwarteschlange ab.
FullName	Ruft den vollständigen Namen der Warteschlange ab.
HasPaperProblem	Ruft einen Wert ab, der angibt, ob der Drucker ein nicht angegebenes Papierproblem aufweist.
HasToner	Ruft einen Wert ab, der angibt, ob der Drucker toner hat.
HostingPrintServer	Dient zum Abrufen oder Festlegen (geschützt) des Druckservers, der die Druckwarteschlange steuert.
InPartialTrust	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Warteschlange in einem teilweise vertrauenswürdigen Modus ausgeführt wird, eine höhere Vertrauensebene.
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 Warteschlange Dokumente enthält, wenn Dokument- und Druckerkonfigurationen nicht übereinstimmen.
IsDirect	Ruft einen Wert ab, der angibt, ob die Warteschlange zuerst direkt auf den Drucker oder Spools-Dokumente gedruckt und dann gedruckt wird.
IsDisposed	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Objekt verworfen wurde. (Geerbt von PrintSystemObject)
IsDoorOpened	Ruft einen Wert ab, der angibt, ob eine Tür auf dem Drucker geöffnet ist.
IsHidden	Ruft einen Wert ab, der angibt, ob die Druckwarteschlange in der Benutzeroberfläche Ihrer Anwendung ausgeblendet ist.
IsInError	Ruft einen Wert ab, der angibt, ob sich der Drucker oder das Gerät in einer Fehlerbedingung befindet.
IsInitializing	Ruft einen Wert ab, der angibt, ob der Drucker sich selbst initialisiert.
IsIOActive	Ruft einen Wert ab, der angibt, ob der Drucker Daten oder Signale empfängt oder sendet.
IsManualFeedRequired	Ruft einen Wert ab, der angibt, ob der Drucker manuell Papier für den aktuellen Druckauftrag eingespeist 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 Drucker nicht genügend Arbeitsspeicher hat.
IsOutOfPaper	Ruft einen Wert ab, der angibt, ob der Drucker mit Papier der für den aktuellen Auftrag erforderlichen Größe neu geladen werden muss.
IsOutputBinFull	Ruft einen Wert ab, der angibt, ob der Ausgabebereich des Druckers zu überlaufen ist.
IsPaperJammed	Ruft einen Wert ab, der angibt, ob das aktuelle Blatt Papier im Drucker hängen bleibt.
IsPaused	Ruft einen Wert ab, der angibt, ob die Druckwarteschlange angehalten wurde.
IsPendingDeletion	Ruft einen Wert ab, der angibt, ob sich der Drucker im Prozess des Löschens eines Druckauftrags befindet.
IsPowerSaveOn	Ruft einen Wert ab, der angibt, ob sich der Drucker im Energiesparmodus befindet.
IsPrinting	Ruft einen Wert ab, der angibt, ob ein Auftrag gedruckt wird.
IsProcessing	Ruft einen Wert ab, der angibt, ob der Drucker 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 eine Warteschlange mit mehreren Druckaufträgen gleichzeitig unterstützen kann.
IsRawOnlyEnabled	Ruft einen Wert ab, der angibt, ob die Druckwarteschlange EMF (Erweiterte Metadatei) verwenden kann, die einen schnelleren Datenfluss von einer Druckanwendung zum Windows-Spooler ermöglicht.
IsServerUnknown	Ruft einen Wert ab, der angibt, ob sich der Drucker in einem Fehlerzustand befindet.
IsShared	Ruft einen Wert ab, der angibt, ob der Drucker für die Verwendung durch andere Computer im Netzwerk verfügbar ist.
IsTonerLow	Ruft einen Wert ab, der angibt, ob der Drucker kurz vor dem Toner ausgeführt wird.
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 aufwärmt.
IsXpsDevice	Ruft einen Wert ab, der angibt, ob der Druckertreiber auf dem XPSDrv-Modell basiert, sodass xml Paper Specification (XPS) als Seitenbeschreibungssprache verwendet wird.
KeepPrintedJobs	Ruft einen Wert ab, der angibt, ob die Warteschlange die Druckersprachendatei speichert, anstatt sie nach dem Drucken zu löschen.
Location	Ruft den physischen Standort des Druckers ab oder legt sie fest.
MaxPrintSchemaVersion	Ruft die neueste mögliche Versionsnummer des Druckschemas ab, das die Warteschlange verwenden kann.
Name	Ruft den Namen der Druckwarteschlange ab oder legt den Namen fest.
NeedUserIntervention	Ruft einen Wert ab, der angibt, ob der Drucker die Aufmerksamkeit eines Menschen benötigt.
NumberOfJobs	Ruft die Gesamtzahl der Aufträge in der Druckwarteschlange ab.
PagePunt	Ruft einen Wert ab, der angibt, ob der Drucker die aktuelle Seite nicht drucken kann.
Parent	Ruft das übergeordnete Objekt des Objekts ab. (Geerbt von PrintSystemObject)
PrintingIsCancelled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der aktuelle Druckauftrag abgebrochen wird.
Priority	Ruft die Priorität der Druckwarteschlange relativ zu anderen Druckwarteschlangen ab, die vomselben Druckserver gehostet werden und denselben physischen Drucker verwenden, oder legt sie fest.
PropertiesCollection	Ruft eine Auflistung von Attribut- und Wertpaaren ab. (Geerbt von PrintSystemObject)
QueueAttributes	Ruft die Eigenschaften der Druckwarteschlange ab.
QueueDriver	Dient zum Abrufen oder Festlegen des Druckertreibers für die Warteschlange.
QueuePort	Ruft den port ab, den die Warteschlange verwendet, oder legt diesen fest.
QueuePrintProcessor	Ruft den Druckprozessor ab, den die Warteschlange verwendet, oder legt diesen fest.
QueueStatus	Ruft einen Wert ab, der den Status des Druckers darstellt. Dazu gehören "Aufwärmen", "Initialisieren", "Drucken" und andere.
ScheduleCompletedJobsFirst	Ruft einen Wert ab, der angibt, ob der Drucker Aufträge druckt, die den Spoolingprozess abgeschlossen haben, bevor Aufträge, die nicht vollständig gepoolt wurden, auch wenn letztere zuerst in die Warteschlange eingegeben wurden oder eine höhere Priorität haben.
SeparatorFile	Ruft den Pfad und Dateinamen einer Datei ab, die am Anfang jedes Druckauftrags eingefügt wird, oder legt diesen fest.
ShareName	Ruft einen Namen für den Drucker ab, der von Benutzern im Netzwerk angezeigt wird, wenn er freigegeben wird, oder legt diesen fest.
StartTimeOfDay	Ruft die früheste Tageszeit ab, ausgedrückt als die Anzahl der Minuten nach Mitternacht Koordinierte Weltzeit (UTC) (auch Als Greenwich Mean Time [GMT]bezeichnet), dass der Drucker einen Auftrag druckt.
UntilTimeOfDay	Ruft die neueste Uhrzeit ab, ausgedrückt als die Anzahl der Minuten nach Mitternacht Koordinierte Weltzeit (UTC) (auch Als Greenwich Mean Time [GMT]bezeichnet), dass der Drucker einen Auftrag druckt.
UserPrintTicket	Dient zum Abrufen oder Festlegen des Standardobjekts PrintTicket des aktuellen Benutzers, das detaillierte Informationen zum Druckauftrag enthält.

Methoden

Name	Beschreibung
AddJob()	Fügt einen neuen (generischen) Druckauftrag ein, dessen Inhalt ein Byte Array ist, in die Warteschlange.
AddJob(String, PrintTicket)	Fügt einen neuen Druckauftrag für ein XML Paper Specification (XPS)-Dokument in die Warteschlange ein und gibt es den angegebenen Namen und einstellungen.
AddJob(String, String, Boolean, PrintTicket)	Fügt einen neuen Druckauftrag für ein XML Paper Specification (XPS)-Dokument in die Warteschlange ein, gibt es den angegebenen Namen und einstellungen und gibt an, ob er überprüft werden soll.
AddJob(String, String, Boolean)	Fügt einen neuen Druckauftrag für ein XML Paper Specification (XPS)-Dokument in die Warteschlange ein, gibt es den angegebenen Namen und gibt an, ob er überprüft werden soll.
AddJob(String)	Fügt einen neuen Druckauftrag ein, dessen Inhalt ein Byte Array ist, in die Warteschlange.
Commit()	Schreibt die aktuellen Eigenschaften des PrintQueue Objekts in die tatsächliche Druckwarteschlange auf dem Druckserver.
CreateXpsDocumentWriter(Double, Double)	Erstellt ein XpsDocumentWriter Objekt mit den angegebenen Dimensionen.
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld, stellt das Dialogfeld mit einem Seitenbereich und einer Beschreibung des Druckauftrags bereit und gibt einen ref (ByRef in Visual Basic)-Parameter zurück, der Informationen zum bildbaren Bereich und den Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld und gibt einen ref (ByRef in Visual Basic)-Parameter zurück, der Informationen zum bildbaren Bereich und den Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(PrintQueue)	Erstellt ein XpsDocumentWriter Objekt und ordnet es der angegebenen Druckwarteschlange zu.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld, stellt das Dialogfeld mit einem Seitenbereich bereit und gibt einen ref (ByRef in Visual Basic)-Parameter zurück, der Informationen über den bildbaren Bereich und die Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld (und stellt es eine Auftragsbeschreibung bereit) und gibt einen ref (ByRef in Visual Basic)-Parameter zurück, der Informationen über den bildbaren Bereich und die Abmessungen des Mediums darstellt.
Dispose()	Veröffentlicht alle ressourcen, die von der PrintSystemObject. (Geerbt von PrintSystemObject)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den PrintSystemObject verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von PrintSystemObject)
GetJob(Int32)	Ruft den Druckauftrag mit der angegebenen ID-Nummer ab.
GetPrintCapabilities()	Ruft ein PrintCapabilities Objekt ab, das die Funktionen des Druckers identifiziert.
GetPrintCapabilities(PrintTicket)	Ruft ein PrintCapabilities Objekt ab, das die Funktionen des Druckers identifiziert.
GetPrintCapabilitiesAsXml()	Ruft ein MemoryStream Objekt ab, das die Funktionen des Druckers als XML-Datenstrom angibt, der dem Druckschema entspricht.
GetPrintCapabilitiesAsXml(PrintTicket)	Ruft ein MemoryStream Objekt ab, das die Funktionen des Druckers in einem XML-Format angibt, das dem Print-Schema entspricht.
GetPrintJobInfoCollection()	Erstellt eine Auflistung, die ein PrintSystemJobInfo Objekt für jeden Auftrag in der Warteschlange enthält.
Initialize()	Initialisiert die Eigenschaften der PrintSystemObject. (Geerbt von PrintSystemObject)
InternalDispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den PrintQueue verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.
MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)	Führt zwei PrintTickets zusammen und garantiert, dass das Ergebnis PrintTicket gültig ist, fordert keine Druckfunktionen auf, die der Drucker nicht unterstützt, und ist auf den angegebenen Bereich beschränkt.
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)	Führt zwei PrintTickets zusammen und garantiert, dass das Ergebnis PrintTicket gültig ist, und fordert keine Druckfunktionen auf, die der Drucker nicht unterstützt.
Pause()	Hält die Druckwarteschlange an. Sie bleibt angehalten, bis Resume() sie ausgeführt wird.
Purge()	Entfernt alle Aufträge in der Druckwarteschlange.
Refresh()	Aktualisiert die Eigenschaften des PrintQueue Objekts mit Werten vom Drucker und dem Hilfsprogramm für die Druckwarteschlange, das auf dem Computer ausgeführt wird.
Resume()	Startet eine Druckwarteschlange neu, die angehalten wurde.

Weitere Informationen

• PrintServer