UltraCategoryChart プロパティの包含と除外

このトピックではコード例を使用して、UltraCategoryChart コントロールに表示されるプロパティを構成する方法を説明します。

目的

UltraCategoryChart は、バインドされた ItemsSource コレクションのデータ項目に存在するすべてのプロパティをデフォルトでプロットします。このトピックは、チャートでプロットされるプロパティを選択する方法を説明します。

本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。

トピック	目的
UltraCategoryChart の概要	このトピックは、主要機能、最小要件およびユーザー機能性など、UltraCategoryChart コントロールの概念的な情報を提供します。
データバインド	このトピックでは、データを UltraCategoryChart コントロールにバインドする方法を説明します。

このトピックは、以下のセクションで構成されます。

以下のプロパティを設定すると、UltraCategoryChart にプロパティを含有または除外できます。

プロパティ名	プロパティタイプ	説明
IncludedProperties	`string[]`	チャートに含まれる (その他のパスは除外) プロパティパスのセットを取得または設定します。null の場合、すべてのプロパティが含まれます。
ExcludedProperties	`string[]`	チャートから除外されるプロパティパスのセットを取得または設定します。複雑な式を使用して、サブコレクションのプロパティを除外できます。*.<propertyName> などのワイルドカードを使用して [0].<propertyName>、 [1].<propertyName> などを除外できます。

以下のコード例は、DataSource としてエネルギーデータソースのサンプルコードを使用し、以下のようなチャートになるためにプロパティの包含と除外を紹介します。

C# の場合:

string[] inclusion = { "Country", "Hydro", "Nuclear" };
chart1.IncludedProperties = inclusion;

C# の場合:

string[] exclusion = { "Coal", "Oil", "Gas" };
chart1.ExcludedProperties = exclusion;

Visual Basic の場合:

Dim inclusion As String() = {"Country", "Hydro", "Nuclear"}
chart1.IncludedProperties = inclusion

Visual Basic の場合:

Dim inclusion As String() = {"Coal", "Oil", "Gas"}
chart1.ExcludedProperties = exclusion