System.Drawing.Imaging Namespace

Bietet erweiterte GDI+-Imageerstellungsfunktionen. Grundlegende Grafikfunktionen werden vom System.Drawing Namespace bereitgestellt.

Klassen

Name Beschreibung
BitmapData

Gibt die Attribute eines Bitmapbilds an. Die BitmapData Klasse wird von den LockBits Klassen und UnlockBits(BitmapData) Methoden Bitmap verwendet. Nicht vererbbar.

ColorMap

Definiert eine Karte zum Konvertieren von Farben. Verschiedene Methoden der ImageAttributes Klasse passen Bildfarben mithilfe einer Farbzuordnungstabelle an, bei der es sich um ein Array von ColorMap Strukturen handelt. Nicht vererbbar.

ColorMatrix

Definiert eine 5 x 5-Matrix, die die Koordinaten für den RGBAW-Raum enthält. Verschiedene Methoden der ImageAttributes Klasse passen Bildfarben mithilfe einer Farbmatrix an. Diese Klasse kann nicht vererbt werden.

ColorPalette

Definiert ein Array von Farben, aus denen eine Farbpalette besteht. Die Farben sind 32-Bit-ARGB-Farben. Nicht vererbbar.

Encoder

Ein Encoder Objekt kapselt einen global eindeutigen Bezeichner (GUID), der die Kategorie eines Bildgeberparameters identifiziert.

EncoderParameter

Wird verwendet, um einen Wert oder ein Array von Werten an einen Bildgeber zu übergeben.

EncoderParameters

Kapselt ein Array von EncoderParameter Objekten.

FrameDimension

Stellt Eigenschaften bereit, die die Frameabmessungen eines Bilds abrufen. Nicht vererbbar.

ImageAttributes

Enthält Informationen dazu, wie Bitmap- und Metadateifarben während des Renderings bearbeitet werden.

ImageCodecInfo

Die ImageCodecInfo Klasse stellt die erforderlichen Speichermber und Methoden bereit, um alle relevanten Informationen zu den installierten Image-Encodern und Decodern (als Codecs bezeichnet) abzurufen. Nicht vererbbar.

ImageFormat

Gibt das Dateiformat des Bilds an. Nicht vererbbar.

Metafile

Definiert eine Grafikmetadatei. Eine Metadatei enthält Datensätze, die eine Abfolge von Grafikvorgängen beschreiben, die aufgezeichnet (konstruiert) und wiedergegeben werden können (angezeigt). Diese Klasse ist nicht vererbbar.

MetafileHeader

Enthält Attribute einer zugeordneten Metafile. Nicht vererbbar.

MetaHeader

Enthält Informationen zu einer WMF-Metadatei (Windows-Format).

PropertyItem

Kapselt eine Metadateneigenschaft, die in eine Bilddatei eingeschlossen werden soll. Nicht vererbbar.

WmfPlaceableFileHeader

Definiert eine platzierbare Metadatei. Nicht vererbbar.

Enumerationen

Name Beschreibung
ColorAdjustType

Gibt an, welche GDI+-Objekte Farbanpassungsinformationen verwenden.

ColorChannelFlag

Gibt einzelne Kanäle im CMYK -Farbraum (Cyan, Magenta, Gelb, Schwarz) an. Diese Aufzählung wird von den SetOutputChannel Methoden verwendet.

ColorMapType

Gibt die Arten von Farbzuordnungen an.

ColorMatrixFlag

Gibt die Arten von Bildern und Farben an, die von den Einstellungen für die Farb- und Graustufenanpassung eines ImageAttributesbeeinflusst werden.

ColorMode

Gibt zwei Modi für Farbkomponentenwerte an.

EmfPlusRecordType

Gibt die methoden an, die für die Verwendung mit einer Metadatei zum Lesen und Schreiben von Grafikbefehlen verfügbar sind.

EmfType

Gibt die Art der Datensätze an, die in einer EMF-Datei (Enhanced Metafile) abgelegt werden. Diese Aufzählung wird von mehreren Konstruktoren in der Metafile-Klasse verwendet.

EncoderParameterValueType

Gibt den Datentyp der EncoderParameter an, die mit der Save- oder SaveAdd Methode eines Bilds verwendet wird.

EncoderValue

Wird verwendet, um den Parameterwert anzugeben, der bei Verwendung der methoden Save(String, ImageCodecInfo, EncoderParameters) oder SaveAdd(EncoderParameters) an einen JPEG- oder TIFF-Bildgeber übergeben wird.

ImageCodecFlags

Stellt Attribute eines Bild-Encoders/Decoders (Codec) bereit.

ImageFlags

Gibt die Attribute der Pixeldaten an, die in einem Image -Objekt enthalten sind. Die Flags-Eigenschaft gibt ein Element dieser Enumeration zurück.

ImageLockMode

Gibt Flags an, die an den Flags-Parameter der LockBits -Methode übergeben werden. Die LockBits-Methode sperrt einen Teil eines Bilds, sodass Sie die Pixeldaten lesen oder schreiben können.

MetafileFrameUnit

Gibt die Maßeinheit für das Rechteck an, das zum Vergrößern und Positionieren einer Metadatei verwendet wird. Dies wird während der Erstellung des Metafile-Objekts angegeben.

MetafileType

Gibt Typen von Metadateien an. Die Type-Eigenschaft gibt ein Element dieser Enumeration zurück.

PaletteFlags

Gibt den Typ der Farbdaten in der Systempalette an. Die Daten können Farbdaten mit Nur-Alpha-, Graustufen- oder Halbtondaten sein.

PixelFormat

Gibt das Format der Farbdaten für jedes Pixel im Bild an.

Delegaten

Name Beschreibung
PlayRecordCallback

Dieser Delegat wird nicht verwendet. Ein Beispiel zum Aufzählen der Datensätze einer Metadatei finden Sie unter EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc).

Hinweise

Vorsicht

Der System.Drawing Namespace hat einige Einschränkungen für bestimmte Betriebssysteme und Anwendungstypen.

  • Bei Windows hängt System.Drawing von der nativen 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+, die in Windows Diensten und ASP.NET Core und ASP.NET Apps nicht unterstützt wird. Diese Typen sind im Paket "System.Drawing.Common NuGet" enthalten und enthalten und enthalten System.Drawing.Bitmap .System.Drawing.Font Grundtypen im Namespace, z System.Drawing.Color. B. , System.Drawing.Size, System.Drawing.Pointund System.Drawing.Rectangle, können jedoch in jeder beliebigen Anwendung verwendet werden.

  • In .NET 5 und früheren Versionen funktioniert das System.Drawing.Common NuGet-Paket unter Windows, Linux und macOS. Es gibt jedoch einige Plattformunterschiede. Unter Linux und macOS wird die GDI+-Funktionalität von der libgdiplus) -Bibliothek implementiert. Diese Bibliothek ist in den meisten Linux-Distributionen nicht standardmäßig installiert und unterstützt nicht alle Funktionen von GDI+ auf 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 Install .NET unter Linux oder Install .NET unter macOS.

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

Wenn Sie System.Drawing nicht mit Ihrer Anwendung verwenden können, Empfohlene Alternativen sind ImageSharp, SkiaSharp, Windows Imaging Components und Microsoft. Maui.Graphics.

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

Vorsicht

Klassen innerhalb des namespaces System.Drawing.Imaging werden für die Verwendung innerhalb eines Windows- oder ASP.NET-Diensts nicht 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.

Weitere Informationen