Freigeben über


PrintQueue Klasse

Definition

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

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 es ü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)

Gilt für:

Weitere Informationen