System.Drawing.Imaging Namnområde
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.Drawingpå 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.Drawingfö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.