System.Drawing.Imaging Namnområde

Tillhandahåller avancerade GDI+-avbildningsfunktioner. Grundläggande grafikfunktioner tillhandahålls av System.Drawing namnområdet.

Klasser

Name Description
BitmapData

Anger attributen för en bitmappsbild. Klassen BitmapData används av klassens LockBits metoder Bitmap och UnlockBits(BitmapData) . Inte ärverbar.

ColorMap

Definierar en karta för att konvertera färger. Flera metoder för ImageAttributes klassen justerar bildfärger med hjälp av en färgommappningstabell, som är en matris med ColorMap strukturer. Inte ärverbar.

ColorMatrix

Definierar en matris på 5 x 5 som innehåller koordinaterna för RGBAW-utrymmet. Flera metoder för klassen ImageAttributes justerar bildfärger med hjälp av en färgmatris. Det går inte att ärva den här klassen.

ColorPalette

Definierar en matris med färger som utgör en färgpalett. Färgerna är 32-bitars ARGB-färger. Inte ärverbar.

Encoder

Ett Encoder objekt kapslar in en globalt unik identifierare (GUID) som identifierar kategorin för en bildkodarparameter.

EncoderParameter

Används för att skicka ett värde, eller en matris med värden, till en bildkodare.

EncoderParameters

Kapslar in en matris med EncoderParameter objekt.

FrameDimension

Innehåller egenskaper som hämtar ramdimensionerna för en bild. Inte ärverbar.

ImageAttributes

Innehåller information om hur bitmapps- och metafilfärger manipuleras under återgivningen.

ImageCodecInfo

Klassen ImageCodecInfo tillhandahåller nödvändiga lagringsmedlemmar och metoder för att hämta all relevant information om installerade avbildningskodare och avkodare (kallas codecs). Inte ärverbar.

ImageFormat

Anger bildens filformat. Inte ärverbar.

Metafile

Definierar en grafisk metafil. En metafil innehåller poster som beskriver en sekvens med grafikåtgärder som kan spelas in (konstrueras) och spelas upp (visas). Den här klassen är inte ärverbar.

MetafileHeader

Innehåller attribut för en associerad Metafile. Inte ärverbar.

MetaHeader

Innehåller information om ett WMF-metafil (Windows-format).

PropertyItem

Kapslar in en metadataegenskap som ska ingå i en bildfil. Inte ärverbar.

WmfPlaceableFileHeader

Definierar en platsbar metafil. Inte ärverbar.

Uppräkningar

Name Description
ColorAdjustType

Anger vilka GDI+-objekt som använder färgjusteringsinformation.

ColorChannelFlag

Anger enskilda kanaler i färgrymden CMYK (cyan, magenta, gul, svart). Den här uppräkningen används av SetOutputChannel metoderna.

ColorMapType

Anger typerna av färgkartor.

ColorMatrixFlag

Anger vilka typer av bilder och färger som påverkas av justeringsinställningarna för färg och gråskala för en ImageAttributes.

ColorMode

Anger två lägen för färgkomponentvärden.

EmfPlusRecordType

Anger de metoder som är tillgängliga för användning med en metafil för att läsa och skriva grafiska kommandon.

EmfType

Anger typen av poster som placeras i en EMF-fil (Enhanced Metafile). Den här uppräkningen används av flera konstruktorer i Metafile klassen.

EncoderParameterValueType

Anger datatypen för den EncoderParameter som används med SaveSaveAdd eller-metoden för en bild.

EncoderValue

Används för att ange parametervärdet som skickas till en JPEG- eller TIFF-bildkodare när du använder Save(String, ImageCodecInfo, EncoderParameters) metoderna eller SaveAdd(EncoderParameters) .

ImageCodecFlags

Tillhandahåller attribut för en bildkodare/avkodare (codec).

ImageFlags

Anger attributen för pixeldata som finns i ett Image objekt. Egenskapen Flags returnerar en medlem i den här uppräkningen.

ImageLockMode

Anger flaggor som skickas till parametern flags för LockBits metoden. Metoden LockBits låser en del av en bild så att du kan läsa eller skriva pixeldata.

MetafileFrameUnit

Anger måttenheten för den rektangel som används för att storleksanpassa och placera en metafil. Detta anges när objektet skapas Metafile .

MetafileType

Anger typer av metafiler. Egenskapen Type returnerar en medlem i den här uppräkningen.

PaletteFlags

Anger typen av färgdata i systempaletten. Data kan vara färgdata med alfa-, gråskaledata eller halvtonsdata.

PixelFormat

Anger formatet på färgdata för varje bildpunkt i bilden.

Delegeringar

Name Description
PlayRecordCallback

Det här ombudet används inte. Ett exempel på hur du räknar upp poster i en metafil finns i EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc).

Kommentarer

Caution

Namnområdet System.Drawing har vissa begränsningar för vissa operativsystem och programtyper.

  • På Windows beror System.Drawing på det inbyggda GDI+-biblioteket, som levereras som en del av operativsystemet. Vissa Windows SKU:er, till exempel Windows Server Core eller Windows Nano, inkluderar inte det här interna biblioteket som en del av operativsystemet. Om du använder det här namnområdet och biblioteket inte kan läsas in genereras undantag vid körning.

  • Vissa typer i namnområdet System.Drawing förlitar sig på GDI+ som inte stöds i Windows tjänster och ASP.NET Core och ASP.NET appar. Dessa typer finns i NuGet-paketet System.Drawing.Common och inkluderar System.Drawing.Bitmap och System.Drawing.Font. Primitiva typer i namnområdet, till exempel System.Drawing.Color, System.Drawing.Size, System.Drawing.Pointoch System.Drawing.Rectangle, kan dock användas i alla program.

  • I .NET 5 och tidigare versioner fungerar nuGet-paketet System.Drawing.Common på Windows, Linux och macOS. Det finns dock vissa plattformsskillnader. I Linux och macOS implementeras GDI+-funktionen av biblioteket libgdiplus ). Det här biblioteket installeras inte som standard i de flesta Linux-distributioner och stöder inte alla funktioner i GDI+ på Windows och macOS. Det finns också plattformar där libgdiplus inte är tillgängligt alls. Om du vill använda typer från System.Drawing.Common-paketet i Linux och macOS måste du installera libgdiplus separat. Mer information finns i Installera .NET på Linux eller Installera .NET på macOS.

  • I .NET 6 och senare versioner stöds nuGet-paketet System.Drawing.Common endast på Windows operativsystem. Mer information finns i System.Drawing.Common som endast stöds i Windows.

Om du inte kan använda System.Drawing med ditt program, Rekommenderade alternativ är ImageSharp, SkiaSharp, Windows Imaging Components och Microsoft. Maui.Graphics.

Klassen Metafile innehåller metoder för att registrera och spara metafiler. Klassen Encoder gör det möjligt för användare att utöka GDI+ för att stödja alla bildformat. Klassen PropertyItem innehåller metoder för att lagra och hämta metadata i bildfiler.

Caution

Klasser inom namnområdet System.Drawing.Imaging stöds inte för användning inom en Windows- eller ASP.NET-tjänst. Om du försöker använda dessa klasser inifrån någon av dessa programtyper kan det uppstå oväntade problem, till exempel sämre tjänstprestanda och körningsfel.

Se även