データソースからの値は、式の中で使用することができます。データソースからフィールドを参照するには、そのフィールドの文字列表現を提供する必要があります。参照の構文は単純で、データソース名とフィールド名を小数点または全角文字で区切り、中括弧で囲んで指定します。
{DataSource.Column}
例えば、customersテーブルに会社名フィールドが "The Big Company "に設定されたエントリーがあり、次の式を入力したとします。
Company Name: {Customers.CompanyName}
となり、計算後、レポートに表示されます。
Company Name: The Big Company
注：この種の式を手動で作成する必要がないように、データ辞書からレポートのページまたは式エディタ内に直接ドラッグ＆ドロップすると、必要な情報を正しい構文で自動的に挿入することができます。
親リレーションシップ
データソースが他のデータソースと親関係にある場合、親データソースのフィールドを直接参照することができます。データソース名、リレーション名、フィールド名の順に、小数点または全角文字で区切り、全体を中括弧で囲みます。例えば
{Datasource.Relation.Field}
このような情報があると仮定します。
Products は、データソースの名前です。
ParentCategories は、2つのデータ・ソースが関連するリレーションの名前です。この場合、2つのデータソースが関連しています。
Products は製品のリストで、 Categories はこれらの製品のカテゴリのリストである。
CategoryName は、Categories データソースの列名です。
を入力すると、次のような式になります。
{Products.ParentCategories.CategoryName}
と入力すると、計算後、レポートに表示される結果は、製品のカテゴリ名となります。
Stimulsoftレポートで使用できるリレーションシップの数には制限がありません。したがって、1つのカラムは、2つ、3つ、あるいはそれ以上のリレーションシップを通して呼び出すことができます。例えば、次のような情報のセットがあるとします。
OrderDetailsは、データソースの名前です。
ParentProductsは、OrdersDetails と Products データソースの間のリレーションシップの 名前です。
ParentCategoriesは、Products データソースと Categories データソースの間のリレーションの名前です。
CategoryNameは、Categories データソースのフィールドです。
と入力すると、次のような式になります。
{OrderDetails.ParentProducts.ParentCategories.CategoryName}
しかし、CategoryNameフィールドの値は、リレーションシップを使用して取得され、 OrderDetails データソースを迂回して Categories データソースに到達します。Categories データソースへの直接の呼び出しは 使用されていません。
重要： レポート言語がC#の場合、名前の大文字と小文字は区別されます。レポート言語がVB.Net の場合、名前には大文字と小文字が区別されません。
データソースの値はすべて型付けされていることに留意する必要があります。これは、すべてのデータ項目がオプション欄で指定された型に動的に変換されることを意味し、レポートの開発を加速させるのに役立つ。しかし、変換せずに列からデータを取得する必要がある場合は、データソースを直接指定する必要があります。例えば、C#の場合。
{Products["ProductName"]}
この式は 、Products データソースから データを変換せずに「そのまま」返します。以下の例は、VB.Netの同じ式を示しています。
{Products.Item("ProductName")}
