System.Drawing.Imaging Przestrzeń nazw

Udostępnia zaawansowane funkcje tworzenia obrazów GDI+. Podstawowa funkcjonalność grafiki jest dostarczana przez System.Drawing przestrzeń nazw.

Klasy

BitmapData	Określa atrybuty obrazu mapy bitowej. Klasa BitmapData jest używana przez LockBits metody Bitmap i UnlockBits(BitmapData) klasy . Nie można dziedziczyć.
CachedBitmap	Reprezentuje kopię zależną od urządzenia zgodną Bitmap z bieżącymi ustawieniami określonego Graphics obiektu (wyświetlanie). Unika ponownego formatowania kroku podczas renderowania, co może znacznie poprawić wydajność.
ColorMap	Definiuje mapę do konwertowania kolorów. Kilka metod ImageAttributes klasy dostosowuje kolory obrazu przy użyciu tabeli color-remap, która jest tablicą ColorMap struktur. Nie można dziedziczyć.
ColorMatrix	Definiuje macierz 5 x 5 zawierającą współrzędne przestrzeni RGBAW. Kilka metod ImageAttributes klasy dostosowuje kolory obrazu przy użyciu macierzy kolorów. Klasa ta nie może być dziedziczona.
ColorPalette	Definiuje tablicę kolorów tworzących paletę kolorów. Kolory są 32-bitowe kolory ARGB. Nie można dziedziczyć.
Encoder	Encoder Obiekt hermetyzuje globalnie unikatowy identyfikator (GUID), który identyfikuje kategorię parametru kodera obrazu.
EncoderParameter	Służy do przekazywania wartości lub tablicy wartości do kodera obrazu.
EncoderParameters	Hermetyzuje tablicę EncoderParameter obiektów.
FrameDimension	Udostępnia właściwości, które pobierają wymiary ramki obrazu. Nie można dziedziczyć.
ImageAttributes	Zawiera informacje o sposobie manipulowania kolorami mapy bitowej i metapliku podczas renderowania.
ImageCodecInfo	Klasa ImageCodecInfo udostępnia niezbędne elementy członkowskie magazynu i metody pobierania wszystkich istotnych informacji na temat zainstalowanych koderów obrazów i dekodatorów (nazywanych koderami). Nie można dziedziczyć.
ImageFormat	Określa format pliku obrazu. Nie można dziedziczyć.
Metafile	Definiuje metaplik graficzny. Metaplik zawiera rekordy opisujące sekwencję operacji graficznych, które można rejestrować (konstruować) i odtwarzać (wyświetlane). Ta klasa nie jest dziedziczona.
MetafileHeader	Zawiera atrybuty skojarzonego elementu Metafile. Nie można dziedziczyć.
MetaHeader	Zawiera informacje o metapliku w formacie systemu Windows (WMF).
PropertyItem	Hermetyzuje właściwość metadanych, która ma zostać uwzględniona w pliku obrazu. Nie można dziedziczyć.
WmfPlaceableFileHeader	Definiuje metaplik z możliwością umieszczenia. Nie można dziedziczyć.

Wyliczenia

ColorAdjustType	Określa, które obiekty GDI+ używają informacji o dostosowaniu kolorów.
ColorChannelFlag	Określa poszczególne kanały w przestrzeni kolorów CMYK (cyjan, magenta, żółty, czarny). Ta wyliczenie jest używana przez SetOutputChannel metody.
ColorMapType	Określa typy map kolorów.
ColorMatrixFlag	Określa typy obrazów i kolorów, które będą miały wpływ na ustawienia dopasowania koloru i skali szarości.ImageAttributes
ColorMode	Określa dwa tryby dla wartości składników kolorów.
EmfPlusRecordType	Określa metody dostępne do użycia z metaplikiem do odczytywania i zapisywania poleceń graficznych.
EmfType	Określa charakter rekordów, które są umieszczane w pliku rozszerzonego metapliku (EMF). To wyliczenie jest używane przez kilka konstruktorów w Metafile klasie.
EncoderParameterValueType	Określa typ danych używany z EncoderParameterSave metodą lub SaveAdd obrazu.
EncoderValue	Służy do określania wartości parametru przekazanej do kodera obrazów JPEG lub TIFF podczas korzystania z Save(String, ImageCodecInfo, EncoderParameters) metod lub SaveAdd(EncoderParameters) .
ImageCodecFlags	Udostępnia atrybuty kodera/dekodera obrazu (codec).
ImageFlags	Określa atrybuty danych pikseli zawartych w Image obiekcie. Właściwość Flags zwraca element członkowski tego wyliczenia.
ImageLockMode	Określa flagi przekazywane do parametru LockBits flag metody . Metoda LockBits blokuje część obrazu, aby można było odczytywać lub zapisywać dane pikseli.
MetafileFrameUnit	Określa jednostkę miary dla prostokąta używanego do rozmiaru i umieszczania metapliku. Jest to określone podczas tworzenia Metafile obiektu.
MetafileType	Określa typy metaplików. Właściwość Type zwraca element członkowski tego wyliczenia.
PaletteFlags	Określa typ danych kolorów w palecie systemu. Dane mogą być kolorami danych tylko z danymi alfa, szarymi lub półtonowymi.
PixelFormat	Określa format danych kolorów dla każdego piksela na obrazie.

Delegaci

PlayRecordCallback

Ten delegat nie jest używany. Przykład wyliczania rekordów metapliku można znaleźć w temacie EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc).

Uwagi

Przestroga

System.Drawing Przestrzeń nazw ma pewne ograniczenia dotyczące niektórych systemów operacyjnych i typów aplikacji.

• W systemie Windows System.Drawing zależy od biblioteki natywnej GDI+ dostarczanej w ramach systemu operacyjnego. Niektóre jednostki SKU systemu Windows, takie jak Windows Server Core lub Windows Nano, nie zawierają tej biblioteki natywnej w ramach systemu operacyjnego. Jeśli używasz tej przestrzeni nazw i nie można załadować biblioteki, wyjątki zostaną zgłoszone w czasie wykonywania.

• Niektóre typy w przestrzeni nazw korzystają z interfejsu System.DrawingGDI+, który nie jest obsługiwany w usługach systemu Windows i aplikacjach ASP.NET Core i ASP.NET. Te typy znajdują się w pakiecie NuGet System.Drawing.Common i zawierają System.Drawing.Bitmap i System.Drawing.Font. Jednak typy pierwotne w przestrzeni nazw, takie jak System.Drawing.Color, System.Drawing.Size, System.Drawing.Pointi System.Drawing.Rectangle, mogą być używane w dowolnej aplikacji.

• W programach .NET 5 i poprzednich wersjach pakiet NuGet System.Drawing.Common działa w systemach Windows, Linux i macOS. Istnieją jednak pewne różnice między platformami. W systemach Linux i macOS funkcja GDI+ jest implementowana przez bibliotekę libgdiplus . Ta biblioteka nie jest domyślnie zainstalowana w większości dystrybucji systemu Linux i nie obsługuje wszystkich funkcji GDI+ w systemach Windows i macOS. Istnieją również platformy, na których biblioteka libgdiplus nie jest w ogóle dostępna. Aby używać typów z pakietu System.Drawing.Common w systemach Linux i macOS, należy zainstalować bibliotekę libgdiplus oddzielnie. Aby uzyskać więcej informacji, zobacz Instalowanie platformy .NET w systemie Linux lub Instalowanie platformy .NET w systemie macOS.

• W programach .NET 6 i nowszych pakiet NuGet System.Drawing.Common jest obsługiwany tylko w systemach operacyjnych Windows. Aby uzyskać więcej informacji, zobacz System.Drawing.Common only supported on Windows (Obsługiwane tylko w systemie Windows).

Jeśli nie możesz używać System.Drawing z aplikacją, zalecane alternatywy to ImageSharp, SkiaSharp, Windows Imaging Components i Microsoft.Maui.Graphics.

Klasa Metafile udostępnia metody rejestrowania i zapisywania metadanych. Klasa Encoder umożliwia użytkownikom rozszerzanie interfejsu GDI+ na obsługę dowolnego formatu obrazu. Klasa PropertyItem udostępnia metody przechowywania i pobierania metadanych w plikach obrazów.

Przestroga

Klasy w System.Drawing.Imaging przestrzeni nazw nie są obsługiwane do użycia w usłudze systemu Windows lub ASP.NET. Próba użycia tych klas z jednego z tych typów aplikacji może powodować nieoczekiwane problemy, takie jak zmniejszona wydajność usługi i wyjątki czasu wykonywania.

Zobacz też

• Grafika i rysowanie w formularzach systemu Windows
• Obrazy, mapy bitowe i metapliki
• Praca z obrazami, mapami bitowymi, ikonami i metaplikami
• Używanie kodeków obrazu w zarządzanym GDI+
• Ponowne kolorowanie obrazów