System.Drawing.Imaging Namespace

Dieser Namespace stellt erweiterte GDI-Bildfunktionen bereit. Grundlegende Grafikfunktionen werden vom System.Drawing-Namespace bereitgestellt.

Klassen

BitmapData	Gibt die Attribute einer Bitmap an. Die BitmapData-Klasse wird von der LockBits-Methode und der UnlockBits(BitmapData)-Methode der Bitmap-Klasse verwendet. Kann nicht vererbt werden.
CachedBitmap	Stellt eine geräteabhängige Kopie eines Bitmap Übereinstimmens mit den aktuellen Geräteeinstellungen (Anzeige) eines angegebenen Graphics Objekts dar. Vermeidet beim Rendern einen Neuformatierungsschritt, der die Leistung erheblich verbessern kann.
ColorMap	Definiert eine Zuordnung für das Konvertieren von Farben. Einige Methoden der ImageAttributes-Klasse passen Bildfarben mithilfe einer Farbumwandlungstabelle an, die aus einem Array von ColorMap-Strukturen besteht. Kann nicht vererbt werden.
ColorMatrix	Definiert eine 5 x 5-Matrix, die die Koordinaten für den RGBAW-Farbraum enthält. Einige Methoden der ImageAttributes-Klasse passen Bildfarben mithilfe einer Farbmatrix an. Diese Klasse kann nicht vererbt werden.
ColorPalette	Definiert ein Array von Farben, die eine Farbpalette bilden. Bei den Farben handelt es sich um ARGB-Farben im 32-Bit-Format. Kann nicht vererbt werden.
Encoder	Ein Encoder-Objekt kapselt eine GUID (Globally Unique Identifier, global eindeutiger Bezeichner), der die Kategorie eines Bildcodiererparameters angibt.
EncoderParameter	Wird verwendet, um einen Wert oder ein Array von Werten an einen Bildencoder zu übergeben.
EncoderParameters	Kapselt ein Array von EncoderParameter-Objekten.
FrameDimension	Stellt Eigenschaften bereit, die die Rahmenabmessungen eines Bildes abrufen. Kann nicht vererbt werden.
ImageAttributes	Enthält Informationen darüber, wie Bitmap- und Metadateifarben während des Renderns bearbeitet werden.
ImageCodecInfo	Die ImageCodecInfo-Klasse stellt die notwendigen Speichermember und -methoden bereit, um die entsprechenden Informationen über die installierten Bildcodierer und -decodierer (Codecs) abzurufen. Kann nicht vererbt werden.
ImageFormat	Gibt das Dateiformat des Bilds an. Kann nicht vererbt werden.
Metafile	Definiert eine grafische Metadatei. Eine Metadatei enthält Datensätze, die eine Folge von Grafikoperationen beschreiben, die aufgezeichnet (erstellt) und wiedergegeben (angezeigt) werden können. Diese Klasse kann nicht geerbt werden.
MetafileHeader	Enthält Attribute einer zugeordneten Metafile. Kann nicht vererbt werden.
MetaHeader	Enthält Informationen über eine WMF-Datei (Windows Metafile).
PropertyItem	Kapselt eine Metadateneigenschaft, die in eine Bilddatei aufgenommen werden soll. Kann nicht vererbt werden.
WmfPlaceableFileHeader	Definiert eine platzierbare Metadatei. Kann nicht vererbt werden.

Enumerationen

ColorAdjustType	Gibt an, welche GDI+-Objekte Farbanpassungsinformationen verwenden.
ColorChannelFlag	Gibt einzelne Kanäle im CMYK-Farbraum (Cyan, Magenta, Yellow, Black) an. Diese Enumeration wird von den SetOutputChannel-Methoden verwendet.
ColorMapType	Gibt die Farbzuordnungstypen an.
ColorMatrixFlag	Gibt die Typen von Bildern und Farben an, die von den Anpassungseinstellungen für Farben und Graustufen eines ImageAttributes betroffen sind.
ColorMode	Gibt zwei Modi für Farbkomponentenwerte an.
EmfPlusRecordType	Gibt die für die Verwendung mit einer Metadatei verfügbaren Methoden zum Lesen und Schreiben von Grafikbefehlen an.
EmfType	Gibt die Art der in einer EMF-Datei (Enhanced Metafile) vorhandenen Datensätze an. Diese Enumeration wird von mehreren Konstruktoren in der Metafile-Klasse verwendet.
EncoderParameterValueType	Gibt den Datentyps des EncoderParameter an, der mit der Save-Methode oder der SaveAdd-Methode eines Bilds verwendet wird.
EncoderValue	Wird zum Angeben des Parameterwerts verwendet, der unter Verwendung der Save(String, ImageCodecInfo, EncoderParameters)-Methode oder der SaveAdd(EncoderParameters)-Methode an einen JPEG- oder TIFF-Bildcodierer übergeben wird.
ImageCodecFlags	Stellt Attribute eines Bildencoders/-decoders (Codec) bereit.
ImageFlags	Gibt die Attribute für die Pixeldaten in einem Image-Objekt an. Die Flags-Eigenschaft gibt einen Member dieser Enumeration zurück.
ImageLockMode	Gibt Flags an, die an den Flagsparameter der LockBits-Methode übergeben werden. Die LockBits-Methode sperrt einen Bereich eines Bildes, sodass Pixeldaten gelesen oder geschrieben werden können.
MetafileFrameUnit	Gibt die Maßeinheit für das Rechteck an, mit dem die Größe und Position einer Metadatei festgelegt wird. Diese Angabe erfolgt beim Erstellen des Metafile-Objekts.
MetafileType	Gibt Metadateitypen an. Die Type-Eigenschaft gibt einen Member dieser Enumeration zurück.
PaletteFlags	Gibt den Typ der Farbdaten in der Systempalette an. Bei den Daten kann es sich um Farbdaten mit Alpha-, Graustufen- oder Halbtondaten handeln.
PixelFormat	Gibt das Farbdatenformat für jedes Pixel des Bildes an.

Delegaten

PlayRecordCallback

Dieser Delegat wird nicht verwendet. Ein Beispiel für die Enumeration der Datensätze einer Metadatei finden Sie unter EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc).

Hinweise

Achtung

Für den System.Drawing Namespace gelten einige Einschränkungen für bestimmte Betriebssysteme und Anwendungstypen.

• Für Windows hängt von der nativen System.Drawing GDI+-Bibliothek ab, die als Teil des Betriebssystems ausgeliefert wird. Einige Windows-SKUs, z. B. Windows Server Core oder Windows Nano, enthalten diese native Bibliothek nicht als Teil des Betriebssystems. Wenn Sie diesen Namespace verwenden und die Bibliothek nicht geladen werden kann, werden Ausnahmen zur Laufzeit ausgelöst.

• Einige Typen im System.Drawing Namespace basieren auf GDI+, das in Windows-Diensten und ASP.NET Core- und ASP.NET-Apps nicht unterstützt wird. Diese Typen befinden sich im NuGet-Paket System.Drawing.Common und umfassen System.Drawing.Bitmap und System.Drawing.Font. Primitive Typen im Namespace wie System.Drawing.Color, System.Drawing.Size, System.Drawing.Pointund System.Drawing.Rectanglekönnen jedoch in jeder Anwendung verwendet werden.

• In .NET 5 und früheren Versionen funktioniert das NuGet-Paket System.Drawing.Common unter Windows, Linux und macOS. Es gibt jedoch einige Plattformunterschiede. Unter Linux und macOS wird die GDI+-Funktionalität von der Bibliothek libgdiplus) implementiert. Diese Bibliothek ist in den meisten Linux-Distributionen nicht standardmäßig installiert und unterstützt nicht alle Funktionen von GDI+ unter Windows und macOS. Es gibt auch Plattformen, auf denen libgdiplus überhaupt nicht verfügbar ist. Um Typen aus dem System.Drawing.Common-Paket unter Linux und macOS zu verwenden, müssen Sie libgdiplus separat installieren. Weitere Informationen finden Sie unter Installieren von .NET unter Linux oder Installieren von .NET unter macOS.

• In .NET 6 und höheren Versionen wird das NuGet-Paket System.Drawing.Common nur unter Windows-Betriebssystemen unterstützt. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Wenn Sie die Anwendung nicht verwenden System.Drawing können, werden ImageSharp, SkiaSharp, Windows Imaging Components und Microsoft.Maui.Graphics empfohlen.

Die Metafile -Klasse bietet Methoden zum Aufzeichnen und Speichern von Metadateien. Mit Encoder der -Klasse können Benutzer GDI+ erweitern, um jedes Bildformat zu unterstützen. Die PropertyItem -Klasse bietet Methoden zum Speichern und Abrufen von Metadaten in Bilddateien.

Achtung

Klassen innerhalb des Namespace werden nicht für die System.Drawing.Imaging Verwendung innerhalb eines Windows- oder ASP.NET-Diensts unterstützt. Der Versuch, diese Klassen aus einem dieser Anwendungstypen zu verwenden, kann zu unerwarteten Problemen führen, z. B. zu leistungseinbußen und Laufzeitausnahmen.

Weitere Informationen

• Grafik und Zeichnen in Windows Forms
• Bilder, Bitmaps und Metadateien
• Arbeiten mit Bildern, Bitmaps, Symbolen und Metadateien
• Verwenden von Bildencodern und -decodern in Managed GDI+
• Neueinfärben von Bildern