チャート データ要件の概要

チャートに独自のカスタム データを指定するのは簡単ですが、各チャートの種類に対応した適切なデータ量とデータ型を確実に指定するのは容易ではありません。

ランタイムで受け取る各データのチャート タイプおよび要件のリストが含まれるトピックについては、以下のリンクをクリックしてください。データがこれらの最小要件を満たさないと、エラーが発生します。

要件を簡単に理解するには、デモ データを使用し、デザインタイムにチャートのデータ項目をどのようにラベル付けしているかを見ます。各チャート項目（棒、円グラフの各スライス、点など）は、列または行番号でラベル付けして、各データ値の使用場所と方法を示します。単純なレベルでは、各データセットは最低いくつかのデータ行と列を持っている必要があります（少なくとも 1 つの文字列タイプの列を持っているのが通常ですが、厳密には必要ではありません）。数値列タイプは全部同じである必要はありません（整数、浮動小数点など）。ただし、同じ一般的なデータ範囲内（-10～150.0 など）にある必要があります。供給したデータの行と列が設定と逆になっている場合、 SwapRowsAndColumns プロパティの使用が必要となります。トラブル回避のため、データを Chart コントロールに渡す前に、これらの要件を満たすようにデータの調整を行うことをお勧めします。

数値データのみが予想される多くの場合、単純な 1 次元配列へのデータ バインドを実行できます。複数行、複数列を要求するグラフ（散布図、レーダー チャ－トなど）、または非数値データ（ローソク足チャートで必須の DateTime）は、非常に定型化されたデータソース（DataTable、DataView、スキーマを持つ XML ドキュメントなど）を必要とします。開発者がグラフ化するデータ列を指定する必要がある場合、そのグラフの ChartAppearance の適切なプロパティ（PieChartAppearance の PieChart プロパティなど）への参照が与えられます。これらのプロパティに提供する必要のある任意の列インデックスは、ゼロから始まります（すなわち、データ テーブルの最初の列は順序数 0 で識別されます）。

Chart コントロールはデータセットから行ラベルに使用するデータを自動的に選択しますが、 SetRowLabels と SetColumnLabels を使用すると、デフォルトの選択を簡単に変更できます。文字列の配列でこれらのメソッドを呼び出し、カスタムのチャート ラベルを設定します。SetRowLabels プロパティの設定についての詳細は、 「行ラベルの指定」を参照してください。

チャート ラベルに使用する行を手動で設定するには、 RowLabelsColumn プロパティから（UseRowLabelsColumn のブール フラグと組み合わせて）デフォルトのフィルタ設定を変更します。指定した列が数値列の場合、数値データを文字列に変換してチャート ラベルに使用します。ただし、列内のデータは、明示的に削除しないかぎり、チャート上にプロットされたまま残ります。行（または列）ラベルが指定されていない場合、接頭辞 Row#（または Col#）とデータ値のインデックスを付けて生成します。

Chart コントロールは、DataSource に指定した DataTable または DataView オブジェクトからに限って ColumnChangingEvent を取得することもできます。これにより、Chart コントロールが自動的に再描画され、チャートに対する変更が重大であると判断した場合は何らかのフィルタリセットが起こる可能性があります。その他のすべてのデータソース（単純な配列など）は、データを変更するたびに BindDataSource メソッドを呼び出し、データが更新されたことをチャートに直接伝える必要があります。

チャートにバインドしたデータがチャートの種類の要件を一部でも満たさない場合、チャートを描画しないでエラー メッセージを表示します。たとえば、散布図を選択し、渡したデータに 2 つ以上の数値列がない場合、「散布図エラー:」というメッセージが、通常はチャートが描画される個所に表示されます。行と列をスワップし、散布図に数値データを含む 2 つ以上の行がない場合も、同じメッセージが表示されます。