System.Drawing.Imaging 名前空間
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
高度な GDI+ イメージング機能を提供します。 基本のグラフィックス機能は、System.Drawing 名前空間に用意されています。
クラス
BitmapData |
ビットマップ イメージの属性を指定します。 BitmapData クラスは、Bitmap クラスの LockBits メソッドおよび UnlockBits(BitmapData) メソッドで使用されます。 継承はできません。 |
CachedBitmap |
指定したGraphicsオブジェクトの現在のデバイス (表示) 設定にBitmap一致するデバイス依存のコピーを表します。 レンダリング時の再フォーマットステップを回避し、パフォーマンスを大幅に向上させることができます。 |
ColorMap |
色を変換するためのマップを定義します。 ImageAttributes クラスのいくつかのメソッドは、ColorMap 構造体の配列であるカラー リマップ テーブルを使用することにより、イメージの色を調整します。 継承はできません。 |
ColorMatrix |
RGBAW 空間の座標を含む 5 x 5 の行列を定義します。 ImageAttributes クラスのいくつかのメソッドは、カラー行列を使用してイメージの色を調整します。 このクラスは継承できません。 |
ColorPalette |
カラー パレットを構成する色の配列を定義します。 色は 32 ビット ARGB 色です。 継承はできません。 |
Encoder |
Encoder オブジェクトは、イメージ エンコーダー パラメーター カテゴリを識別するグローバル一意識別子 (GUID) をカプセル化します。 |
EncoderParameter |
値、または値の配列をイメージ エンコーダーに渡すのに使用されます。 |
EncoderParameters |
EncoderParameter オブジェクトの配列をカプセル化します。 |
FrameDimension |
イメージのフレーム ディメンションを取得するプロパティを提供します。 継承はできません。 |
ImageAttributes |
レンダリング時のビットマップとメタファイルの色の操作方法に関する情報を格納します。 |
ImageCodecInfo |
ImageCodecInfo クラスには、インストールされたイメージ エンコーダーとデコーダー (コーデックと呼ばれます) に関するすべての関連情報を検索するための必要なストレージ メンバーおよびメソッドが用意されています。 継承はできません。 |
ImageFormat |
イメージのファイル形式を指定します。 継承はできません。 |
Metafile |
グラフィック メタファイルを定義します。 メタファイルには、記録 (構築) して再生 (表示) できる一連のグラフィックス操作を記述するレコードが格納されています。 このクラスは継承できません。 |
MetafileHeader |
関連付けられた Metafile の属性が格納されています。 継承はできません。 |
MetaHeader |
Windows メタファイル形式 (WMF) に関する情報が格納されています。 |
PropertyItem |
メタデータ プロパティがイメージ ファイルに含まれるようにカプセル化します。 継承はできません。 |
WmfPlaceableFileHeader |
配置可能メタファイルを定義します。 継承はできません。 |
列挙型
ColorAdjustType |
色の調整情報を使用する GDI+ オブジェクトを指定します。 |
ColorChannelFlag |
CMYK (シアン、マゼンタ、黄、黒) 色空間の個々のチャネルを指定します。 この列挙体は SetOutputChannel メソッドで使用されます。 |
ColorMapType |
カラー マップの種類を指定します。 |
ColorMatrixFlag |
ImageAttributes の色およびグレースケールの調整設定値の影響を受ける、イメージおよび色の種類を指定します。 |
ColorMode |
色要素値の 2 つのモードを指定します。 |
DitherType |
高度な GDI+ イメージング機能を提供します。 基本のグラフィックス機能は、System.Drawing 名前空間に用意されています。 |
EmfPlusRecordType |
グラフィック コマンドの読み取り/書き込みのためにメタファイルで使用できるメソッドを指定します。 |
EmfType |
拡張メタファイル (EMF) ファイルに格納されているレコードの性質を指定します。 この列挙体は、Metafile クラスのいくつかのコンストラクターで使用されます。 |
EncoderParameterValueType |
イメージの Save メソッドまたは SaveAdd メソッドで使用される EncoderParameter のデータ型を指定します。 |
EncoderValue |
Save(String, ImageCodecInfo, EncoderParameters) メソッドまたは SaveAdd(EncoderParameters) メソッドを使用するときに JPEG または TIFF のイメージ エンコーダーに渡すパラメーター値を指定するのに使用されます。 |
ImageCodecFlags |
イメージ エンコーダー/デコーダー (コーデック) の属性を提供します。 |
ImageFlags |
Image オブジェクトに格納されているピクセル データの属性を指定します。 Flags プロパティは、この列挙体のメンバーを返します。 |
ImageLockMode |
LockBits メソッドのフラグ パラメーターに渡すフラグを指定します。 LockBits メソッドは、ピクセル データの読み取りや書き込みができるように、イメージの一部をロックします。 |
MetafileFrameUnit |
メタファイルのサイズおよび位置を設定するために使用する、四角形の測定単位を指定します。 この値は Metafile オブジェクトの作成時に指定されます。 |
MetafileType |
メタファイルの種類を指定します。 Type プロパティは、この列挙体のメンバーを返します。 |
PaletteFlags |
システム パレット内のカラー データの種類を指定します。 データはアルファを含む色データとなるか、グレースケール データだけとなるか、またはハーフトーン データとなります。 |
PaletteType |
高度な GDI+ イメージング機能を提供します。 基本のグラフィックス機能は、System.Drawing 名前空間に用意されています。 |
PixelFormat |
イメージ内の各ピクセルについて、カラー データの形式を指定します。 |
代理人
PlayRecordCallback |
このデリゲートは使用されません。 メタファイルのレコードの列挙の例については、EnumerateMetafile(Metafile, Point, Graphics+EnumerateMetafileProc) のトピックを参照してください。 |
注釈
注意事項
System.Drawing
名前空間には、特定のオペレーティング システムとアプリケーションの種類に関するいくつかの制限があります。
Windows では、
System.Drawing
は、OS の一部として出荷される GDI+ ネイティブ ライブラリに依存します。 Windows Server Core や Windows Nano などの一部の Windows SKU には、OS の一部としてこのネイティブ ライブラリが含まれていません。 この名前空間を使用し、ライブラリを読み込めなかった場合、実行時に例外がスローされます。名前空間の一部の
System.Drawing
型は GDI+ に依存しています。これは Windows サービスおよび ASP.NET Coreおよび ASP.NET アプリではサポートされていません。 これらの型は System.Drawing.Common NuGet パッケージにあり、 と System.Drawing.Fontが含まれますSystem.Drawing.Bitmap。 ただし、、、、、 などのSystem.Drawing.ColorSystem.Drawing.SizeSystem.Drawing.PointSystem.Drawing.Rectangle名前空間のプリミティブ型は、任意のアプリケーションで使用できます。.NET 5 以前のバージョンでは、 System.Drawing.Common NuGet パッケージは Windows、Linux、macOS で動作します。 ただし、プラットフォームの違いがいくつかあります。 Linux および macOS では、GDI+ 機能は libgdiplus) ライブラリによって実装されます。 このライブラリは、ほとんどの Linux ディストリビューションでは既定ではインストールされず、Windows および macOS 上の GDI+ のすべての機能をサポートしているわけではありません。 libgdiplus がまったく利用できないプラットフォームもあります。 Linux および macOS で System.Drawing.Common パッケージの型を使用するには、libgdiplus を個別にインストールする必要があります。 詳細については、「 Linux に .NET をインストールする 」または「 macOS に .NET をインストールする」を参照してください。
.NET 6 以降のバージョンでは、 System.Drawing.Common NuGet パッケージは Windows オペレーティング システムでのみサポートされています。 詳細については、「 Windows でのみサポートされる System.Drawing.Common」を参照してください。
アプリケーションでを使用 System.Drawing
できない場合は、 ImageSharp、 SkiaSharp、 Windows Imaging Components、 Microsoft.Maui.Graphics などの代替手段をお勧めします。
クラスには Metafile 、メタファイルを記録および保存するためのメソッドが用意されています。 クラスを使用すると、ユーザーは Encoder GDI+ を拡張して任意のイメージ形式をサポートできます。 クラスには PropertyItem 、イメージ ファイルにメタデータを格納および取得するためのメソッドが用意されています。
注意事項
名前空間内の System.Drawing.Imaging クラスは、Windows または ASP.NET サービス内での使用はサポートされていません。 これらのアプリケーションの種類の 1 つからこれらのクラスを使用しようとすると、サービスのパフォーマンスの低下や実行時の例外など、予期しない問題が発生する可能性があります。
こちらもご覧ください
.NET