System.Drawing.Imaging Naamruimte
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt geavanceerde GDI+ imaging-functionaliteit. De basisfunctionaliteit voor grafische afbeeldingen wordt geleverd door de System.Drawing naamruimte.
Klassen
| Name | Description |
|---|---|
| BitmapData |
Hiermee geeft u de kenmerken van een bitmapafbeelding. De BitmapData klasse wordt gebruikt door de LockBits en UnlockBits(BitmapData) methoden van de Bitmap klasse. Kan niet overnemen. |
| ColorMap |
Hiermee definieert u een kaart voor het converteren van kleuren. Verschillende methoden van de ImageAttributes klasse passen afbeeldingskleuren aan met behulp van een tabel met kleuren opnieuw toewijzen, een matrix met ColorMap structuren. Kan niet overnemen. |
| ColorMatrix |
Definieert een matrix van 5 x 5 die de coördinaten voor de RGBAW-ruimte bevat. Verschillende methoden van de ImageAttributes klasse passen afbeeldingskleuren aan met behulp van een kleurenmatrix. Deze klasse kan niet worden overgenomen. |
| ColorPalette |
Hiermee definieert u een matrix met kleuren waaruit een kleurenpalet bestaat. De kleuren zijn 32-bits ARGB-kleuren. Kan niet overnemen. |
| Encoder |
Een Encoder object bevat een GUID (Globally Unique Identifier) die de categorie van een parameter voor het encoderen van afbeeldingen identificeert. |
| EncoderParameter |
Wordt gebruikt om een waarde of een matrix met waarden door te geven aan een afbeeldingscoderingsprogramma. |
| EncoderParameters |
Een matrix met EncoderParameter objecten inkapselen. |
| FrameDimension |
Biedt eigenschappen waarmee de framedimensies van een afbeelding worden opgehaald. Kan niet overnemen. |
| ImageAttributes |
Bevat informatie over hoe bitmap- en metabestandkleuren tijdens het weergeven worden bewerkt. |
| ImageCodecInfo |
De ImageCodecInfo klasse biedt de benodigde opslagleden en methoden voor het ophalen van alle relevante informatie over de geïnstalleerde installatiekopieën en decoders (codecs genoemd). Kan niet overnemen. |
| ImageFormat |
Hiermee geeft u de bestandsindeling van de afbeelding. Kan niet overnemen. |
| Metafile |
Hiermee definieert u een afbeeldingsmetabestand. Een metabestand bevat records die een reeks grafische bewerkingen beschrijven die kunnen worden vastgelegd (samengesteld) en worden afgespeeld (weergegeven). Deze klasse kan niet worden overgenomen. |
| MetafileHeader |
Bevat kenmerken van een gekoppelde Metafile. Kan niet overnemen. |
| MetaHeader |
Bevat informatie over een WMF-metabestand (Windows Format). |
| PropertyItem |
Een metagegevenseigenschap inkapselen die moet worden opgenomen in een afbeeldingsbestand. Kan niet overnemen. |
| WmfPlaceableFileHeader |
Hiermee definieert u een tijdelijke metabestand. Kan niet overnemen. |
Enums
| Name | Description |
|---|---|
| ColorAdjustType |
Hiermee geeft u op welke GDI+ objecten kleuraanpassingsgegevens gebruiken. |
| ColorChannelFlag |
Hiermee geeft u afzonderlijke kanalen op in de CMYK-kleurruimte (cyaan, magenta, geel, zwart). Deze opsomming wordt gebruikt door de SetOutputChannel methoden. |
| ColorMapType |
Hiermee geeft u de typen kleurenkaarten. |
| ColorMatrixFlag |
Hiermee geeft u de typen afbeeldingen en kleuren die worden beïnvloed door de instellingen voor kleur- en grijswaarden van een ImageAttributes. |
| ColorMode |
Hiermee geeft u twee modi voor kleurcomponentwaarden. |
| EmfPlusRecordType |
Hiermee geeft u de methoden die beschikbaar zijn voor gebruik met een metabestand voor het lezen en schrijven van grafische opdrachten. |
| EmfType |
Hiermee geeft u de aard op van de records die in een EMF-bestand (Enhanced Metafile) worden geplaatst. Deze opsomming wordt gebruikt door verschillende constructors in de Metafile klasse. |
| EncoderParameterValueType |
Hiermee geeft u het gegevenstype op van het EncoderParameter gebruikte type met de Save of SaveAdd methode van een afbeelding. |
| EncoderValue |
Wordt gebruikt om de parameterwaarde op te geven die wordt doorgegeven aan een JPEG- of TIFF-afbeeldingscoderingsprogramma bij gebruik van de Save(String, ImageCodecInfo, EncoderParameters) of SaveAdd(EncoderParameters) methoden. |
| ImageCodecFlags |
Biedt kenmerken van een image encoder/decoder (codec). |
| ImageFlags |
Hiermee geeft u de kenmerken van de pixelgegevens in een Image object. De Flags eigenschap retourneert een lid van deze opsomming. |
| ImageLockMode |
Hiermee geeft u vlaggen op die worden doorgegeven aan de parameter vlaggen van de LockBits methode. Met LockBits de methode wordt een deel van een afbeelding vergrendeld, zodat u de pixelgegevens kunt lezen of schrijven. |
| MetafileFrameUnit |
Hiermee geeft u de maateenheid op voor de rechthoek die wordt gebruikt om een metabestand te vergroten en te positioneren. Dit wordt opgegeven tijdens het maken van het Metafile object. |
| MetafileType |
Hiermee geeft u typen metabestanden. De Type eigenschap retourneert een lid van deze opsomming. |
| PaletteFlags |
Hiermee geeft u het type kleurgegevens in het systeempalet. De gegevens kunnen kleurgegevens zijn met alleen alfa-, grijswaardengegevens of halftoongegevens. |
| PixelFormat |
Hiermee geeft u de indeling van de kleurgegevens voor elke pixel in de afbeelding. |
Gedelegeerden
| Name | Description |
|---|---|
| PlayRecordCallback |
Deze gemachtigde wordt niet gebruikt. Zie voor een voorbeeld van het inventariseren van de records van een metabestand EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc). |
Opmerkingen
Caution
De System.Drawing naamruimte heeft enkele beperkingen voor bepaalde besturingssystemen en toepassingstypen.
Op Windows is
System.Drawingafhankelijk van de systeemeigen GDI+-bibliotheek, die wordt verzonden als onderdeel van het besturingssysteem. Sommige Windows SKU's, zoals Windows Server Core of Windows Nano, bevatten deze systeemeigen bibliotheek niet als onderdeel van het besturingssysteem. Als u deze naamruimte gebruikt en de bibliotheek niet kan worden geladen, worden er uitzonderingen gegenereerd tijdens runtime.Sommige typen in de naamruimte
System.Drawingzijn afhankelijk van GDI+, die niet wordt ondersteund in Windows services en ASP.NET Core- en ASP.NET-apps. Deze typen bevinden zich in het NuGet-pakket System.Drawing.Common en bevatten System.Drawing.Bitmap en System.Drawing.Font. Primitieve typen in de naamruimte, zoals System.Drawing.Color, System.Drawing.Sizeen System.Drawing.Point, System.Drawing.Rectanglekunnen echter in elke toepassing worden gebruikt.In .NET 5 en vorige versies werkt het NuGet-pakket System.Drawing.Common NuGet-pakket op Windows, Linux en macOS. Er zijn echter enkele platformverschillen. In Linux en macOS wordt de GDI+-functionaliteit geïmplementeerd door de bibliotheek van de azure-bibliotheek. Deze bibliotheek is niet standaard geïnstalleerd in de meeste Linux-distributies en biedt geen ondersteuning voor alle functionaliteit van GDI+ op Windows en macOS. Er zijn ook platformen waar de platforms waarop deplus helemaal niet beschikbaar is. Als u typen uit het pakket System.Drawing.Common in Linux en macOS wilt gebruiken, moet u de installatie van het hulpprogramma Voor linux en macOS afzonderlijk installeren. Zie Install .NET on Linux or Install .NET on macOS voor meer informatie.
In .NET 6- en latere versies wordt het NuGet-pakket System.Drawing.Common alleen ondersteund op Windows besturingssystemen. Zie System.Drawing.Common alleen ondersteund in Windows voor meer informatie.
Als u System.Drawing niet kunt gebruiken met uw toepassing, aanbevolen alternatieven zijn ImageSharp, SkiaSharp, Windows Imaging Components en Microsoft. Maui.Graphics.
De Metafile klasse biedt methoden voor het opnemen en opslaan van metabestanden. Met de Encoder klasse kunnen gebruikers GDI+ uitbreiden om elke afbeeldingsindeling te ondersteunen. De PropertyItem klasse biedt methoden voor het opslaan en ophalen van metagegevens in afbeeldingsbestanden.
Caution
Klassen binnen de naamruimte System.Drawing.Imaging worden niet ondersteund voor gebruik binnen een Windows- of ASP.NET-service. Als u deze klassen probeert te gebruiken vanuit een van deze toepassingstypen, kunnen er onverwachte problemen optreden, zoals verminderde serviceprestaties en runtime-uitzonderingen.