System.Printing Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Klassen bereit, mit denen Sie die Verwaltung von Druckservern, Druckwarteschlangen und Druckaufträgen automatisieren können.
Klassen
LocalPrintServer |
Stellt den lokalen Druckerserver dar (der Computer, auf dem die Anwendung ausgeführt wird) und ermöglicht die Verwaltung der zugehörigen Druckwarteschlangen. |
PageImageableArea |
Stellt den Bereich einer Seite dar, auf dem gedruckt werden kann. |
PageMediaSize |
Beschreibt die Seitengröße für Papier oder andere Medien. |
PageResolution |
Definiert die Seitenauflösung der Druckerausgabe durch einen qualitativen Wert, durch einen DPI-Wert (Dots per Inch, Punkte pro Zoll) oder durch beide Angaben. |
PageScalingFactorRange |
Gibt einen Bereich mit Prozentwerten an, um die ein Drucker das Druckbild auf einer Seite vergrößern oder verkleinern kann. |
PrintCapabilities |
Definiert die Fähigkeiten eines Druckers. |
PrintCommitAttributesException |
Die Ausnahme, die ausgelöst wird, wenn ein Fehlerzustand die Übermittlung einiger Attribute von einem PrintSystemObject an den eigentlichen Computer, den Drucker oder das Gerät verhindert, das durch das Objekt dargestellt wird. |
PrintDocumentImageableArea |
Gibt die Größe des Papiers (oder anderen Mediums), die Größe des Druckbereichs sowie die Position des Druckbereichs an. |
PrintDriver |
Stellt einen Drucktreiber dar. |
PrintFilter |
Definiert das gemeinsame Dispose-Verhalten für die PrintDriver-Klasse und die PrintProcessor-Klasse. PrintFilter unterstützt die Windows Presentation Foundation-Infrastruktur (WFP) und ist nicht für die direkte Verwendung im Code vorgesehen. |
PrintingCanceledException |
Diese Ausnahme wird ausgelöst, wenn im Code versucht wird, auf einen abgebrochenen Druckauftrag zuzugreifen. |
PrintingNotSupportedException |
Die Ausnahme, die ausgelöst wird, wenn ein Druckvorgang nicht unterstützt wird. |
PrintJobException |
Diese Ausnahme wird ausgelöst, wenn der Druckauftrag nicht ordnungsgemäß ausgeführt werden kann. |
PrintJobInfoCollection |
Stellt eines oder mehrere PrintSystemJobInfo-Objekte dar. |
PrintJobSettings |
Beschreibt einen Druckauftrag. |
PrintPort |
Stellt einen Druckeranschluss auf einem Druckerserver dar. Jeder Druckwarteschlange ist ein Druckanschluss zugewiesen. |
PrintProcessor |
Stellt einen Druckprozessor auf einem Druckerserver dar. |
PrintQueue |
Verwaltet Drucker und Druckaufträge. |
PrintQueueCollection |
Stellt eine Auflistung vonPrintQueue-Objekten dar. |
PrintQueueException |
Diese Ausnahme wird ausgelöst, wenn ein Fehlerzustand das Erstellen oder den Zugriff auf eine PrintQueue verhindert. |
PrintQueueStream |
Ein Stream, der einen Spoolerdruckauftrag in einer Druckwarteschlange darstellt. |
PrintQueueStringProperty |
Stellt lediglich eine von drei möglichen Eigenschaften einer Druckwarteschlange dar: Location, Comment oder ShareName. |
PrintServer |
Verwaltet die Druckwarteschlangen auf einem Druckerserver. Hierbei kann es sich um einen Computer oder um ein dediziertes als Druckerserver fungierendes Hardwaregerät handeln. |
PrintServerException |
Diese Ausnahme wird ausgelöst, wenn ein Fehlerzustand das Erstellen oder den Zugriff auf einen PrintServer verhindert. |
PrintSystemException |
Diese Ausnahme wird ausgelöst, wenn ein Fehlerzustand das Erstellen oder den Zugriff auf ein PrintSystemObject verhindert. |
PrintSystemJobInfo |
Definiert detailliert die Eigenschaften eines Druckauftrags. |
PrintSystemObject |
Definiert grundlegende Eigenschaften und Methoden für alle Objekte des Drucksystems. Klassen, die von dieser Klasse abgeleitet werden, stellen beispielsweise Druckwarteschlangen, Druckerserver oder Druckaufträge dar. |
PrintSystemObjectPropertiesChangedEventArgs |
Stellt Daten für ein PropertiesChanged-Ereignis bereit, das Sie erstellen müssen. |
PrintSystemObjectPropertyChangedEventArgs |
Stellt Daten für ein PropertyChanged-Ereignis bereit, das Sie erstellen müssen. |
PrintSystemObjects |
Stellt eine Auflistung von Drucksystemobjekten dar. |
PrintTicket |
Definiert die Einstellungen eines Druckauftrags. |
Strukturen
ValidationResult |
Stellt ein zusammengeführtes PrintTicket dar, dessen Anwendbarkeit gewährleistet ist. Zusätzlich wird ein Bericht zu allen Einstellungen bereitgestellt, die geändert werden mussten, um die Anwendbarkeit sicherzustellen. |
Enumerationen
Collation |
Gibt an, ob ein Drucker die Ausgabe sortiert, wenn mehrere Exemplare eines mehrseitigen Druckauftrags gedruckt werden. |
ConflictStatus |
Gibt an, ob Änderungen an einem zusammengeführten PrintTicket vorgenommen wurden, um ein gültiges PrintTicket sicherzustellen. |
DeviceFontSubstitution |
Gibt an, ob die Geräteschriftartersetzung für einen Drucker aktiviert ist. |
Duplexing |
Gibt an, ob ein Drucker einseitigen Druck oder einen zweiseitigen Drucktyp (Duplexdruck) verwendet. |
EnumeratedPrintQueueTypes |
Gibt die Attribute von Druckwarteschlangen an. |
InputBin |
Gibt den Eingabeschacht an, der als Quelle für leeres Papier oder andere Druckmedien verwendet wird. |
LocalPrintServerIndexedProperty |
Gibt die Eigenschaften eines LocalPrintServer-Objekts an, die beim Erstellen des Objekts initialisiert werden sollen. |
OutputColor |
Gibt an, wie Inhalte gedruckt werden, die Farben oder Graustufen enthalten. |
OutputQuality |
Gibt die Ausgabequalitäten für ein Druckgerät an. |
PageBorderless |
Gibt an, ob ein Druckgerät bis zum Rand des Druckmediums druckt oder ob ein nicht bedruckbarer Rand freigelassen wird. |
PageMediaSizeName |
Gibt die Größe der Seite oder die Rollenbreite des Papiers oder einem anderen Printmedium an. |
PageMediaType |
Gibt Papier- oder andere Medientypen für den Druck an. |
PageOrder |
Gibt an, ob ein Drucker mehrseitige Dokumente mit normaler oder umgekehrter Seitenreihenfolge druckt. |
PageOrientation |
Gibt an, wie Seiteninhalte auf dem Druckmedium ausgerichtet werden. |
PageQualitativeResolution |
Gibt die Seitenauflösung als qualitativen, nicht numerischen Wert an. |
PagesPerSheetDirection |
Gibt die Anordnung der Seiten an, wenn mehrere Inhaltsseiten auf einer Seite des Druckmediums gedruckt werden. |
PhotoPrintingIntent |
Gibt die Ausgabequalität für das Drucken eines Fotos an. Der Druckertreiber übersetzt PhotoPrintingIntent in quantitative Werte für Auflösung und andere Qualitätsfaktoren. |
PrintJobPriority |
Gibt eine nicht numerische Priorität für einen Druckauftrag relativ zu anderen Druckaufträgen in der Druckwarteschlange an. |
PrintJobStatus |
Gibt den aktuellen Status eines Druckauftrags in einer Druckwarteschlange an. |
PrintJobType |
Gibt an, ob der Druckauftrag XML Paper Specification (CPS) verwendet. |
PrintQueueAttributes |
Gibt die Attribute einer Druckwarteschlange oder des zugeordneten Druckers an. |
PrintQueueIndexedProperty |
Gibt die Eigenschaften an, die beim Erstellen eines PrintQueue-Objekts initialisiert werden. |
PrintQueueStatus |
Gibt den Status einer Druckwarteschlange oder des zugeordneten Druckers an. |
PrintQueueStringPropertyType |
Gibt die beabsichtigte Verwendung einer PrintQueueStringProperty an. |
PrintServerEventLoggingTypes |
Gibt die Typen von Ereignissen an, die von einem PrintServer protokolliert werden können. |
PrintServerIndexedProperty |
Gibt die Eigenschaften eines PrintServer-Objekts an, die beim Erstellen des Objekts initialisiert werden sollen. |
PrintSystemDesiredAccess |
Gibt die unterschiedlichen Zugriffsrechte (bzw. Zugriffsebenen) für Druckobjekte an. |
PrintSystemObjectLoadMode |
Gibt an, ob die Eigenschaften eines Objekts initialisiert werden, wenn das Objekt geladen wird. |
PrintTicketScope |
Gibt an, ob ein PrintTicket für den gesamten Druckauftrag, für ein Dokument des Druckauftrags oder nur für eine Seite des Druckauftrags gilt. |
Stapling |
Gibt an, ob und an welcher Position ein Drucker ein mehrseitiges Dokument heftet. |
TrueTypeFontMode |
Gibt an, wie ein Drucker Text verarbeitet, der mit einer TrueType-Schriftart formatiert ist. |
Hinweise
Dieser Namespace enthält die folgenden Kernklassen:
Die- PrintSystemObject Klasse, die die Basisklasse für die anderen Kern Druckklassen ist.
Die- PrintServer Klasse, die einen tatsächlichen Druckserver darstellt, normalerweise ein Computer.
Die PrintQueue -Klasse, die eine tatsächliche Druck Warteschlange und Ihren Drucker darstellt.
Die- PrintSystemJobInfo Klasse, die einen bestimmten Druckauftrag darstellt.
Die- PrintTicket Klasse, die den Drucker anweist, wie ein Druckauftrag verarbeitet wird.
Von der-Klasse abgeleitete Klassen PrintSystemObject verfügen jeweils über eine Commit -Methode und eine- Refresh Methode. Sie müssen diese Methoden verwenden, um sicherzustellen, dass Instanzen der Klassen mit den von Ihnen dargestellten Hardware-oder Softwarekomponenten synchronisiert werden.
Der- System.Printing Namespace enthält auch viele Enumerationen, die Druckerfunktionen beschreiben, z. b. ob ein Drucker eine sortierte Ausgabe erzeugt und Anweisungen für Drucker angeben, wie z. b. das Papierformat, das für einen Druckauftrag verwendet werden soll.
Dieser Namespace ist Teil der erweiterten Druckdienste, die mit Windows Presentation Foundation bereitgestellt werden. Entwickler von verwaltetem Code, die Windows Forms verwenden, müssen die APIs im- System.Drawing.Printing Namespace verwenden.
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. 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.