組み込みコレクション - 改ページ対応レポート内の Parameters コレクションの参照 (レポート ビルダー)

  • [アーティクル]

適用対象: Microsoft レポート ビルダー (SSRS) Power BI Report Builder SQL Server Data Tools のレポート デザイナー

改ページ対応レポート パラメーターは、式から参照できる組み込みコレクションの 1 つです。 パラメーターを式に含めると、レポートのデータと外観をユーザーの選択に基づいてカスタマイズできます。 式は、(Fx) または <Expression> オプションを利用できる、すべてのレポート アイテム プロパティやテキスト ボックス プロパティで使用できます。 式は、他の方法でレポートの内容と外観を制御する場合にも使用されます。 詳細については、「式の例 (レポート ビルダーおよび SSRS)」を参照してください。

実行時にパラメーター値をデータセットのフィールド値と比較する場合は、比較する 2 つのアイテムのデータ型が同じである必要があります。 レポート パラメーターに使用できるデータ型は次のいずれかです:Boolean、DateTime、Integer、Float、または Text (これは基になるデータ型 String を表します)。 必要に応じて、パラメーター値のデータ型をデータセットの値に一致するように変換することが必要になる場合もあります。 詳細については、式で使用されるデータ型 (レポート ビルダーおよび SSRS) に関する記事を参照してください。

パラメーター参照を式に含めるには、パラメーター参照に適切な構文を指定する方法を理解する必要があります。これは、パラメーターが単独値パラメーターと複数の値を持つパラメーターのどちらであるかによって異なります。

注意

ページ分割されたレポートの定義ファイル (.rdl) は、Microsoft レポート ビルダー、Power BI レポート ビルダー、または SQL Server Data Tools のレポート デザイナーを使用して作成および変更できます。

式での単独値パラメーターの使用

次の表は、任意のデータ型の単独値パラメーターへの参照を式に含めるときに使用する構文の例を示しています。

例 説明
=Parameters!<ParameterName>.IsMultiValue Falseが返されます。

パラメーターが複数値であるかどうかを確認します。 Trueの場合、パラメーターは複数値でオブジェクトのコレクションです。 Falseの場合、パラメーターは単一値で 1 つのオブジェクトです。
=Parameters!<ParameterName>.Count 整数値 1 が返されます。 単一値パラメーターの場合、カウントは常に 1 です。
=Parameters!<ParameterName>.Label パラメーター ラベルが返されます。パラメーター ラベルは通常、使用可能な値のドロップダウン リストの表示名として使用されます。
=Parameters!<ParameterName>.Value パラメーターの値が返されます。 Label プロパティが設定されていない場合、この値は使用可能な値のボックスの一覧に表示されます。
=CStr(Parameters!<ParameterName>.Value) パラメーターの値が文字列として返されます。
=Fields(Parameters!<ParameterName>.Value).Value パラメーターと同じ名前のフィールドの値が返されます。

フィルターでのパラメーターの使用の詳細については、データセット フィルター、データ領域フィルター、およびグループ フィルターの追加 (レポート ビルダーおよび SSRS) に関する記事を参照してください。

式での複数値パラメーターの使用

次の表は、任意のデータ型の複数の値を持つパラメーターへの参照を式に含めるときに使用する構文の例を示しています。

例 説明
=Parameters!<MultivalueParameterName>.IsMultiValue True または Falseが返されます。

パラメーターが複数値であるかどうかを確認します。 Trueの場合、パラメーターは複数値でオブジェクトのコレクションです。 Falseの場合、パラメーターは単一値で 1 つのオブジェクトです。
=Parameters!<MultivalueParameterName>.Count 整数値が返されます。

値の数を表します。 単一値パラメーターの場合、カウントは常に 1 です。 複数値パラメーターの場合、カウントは 0 以上です。
=Parameters!<MultivalueParameterName>.Value(0) 複数値パラメーターの最初の値が返されます。
=Parameters!<MultivalueParameterName>.Value(Parameters!<MultivalueParameterName>.Count-1) 複数値パラメーターの最後の値が返されます。
=Split("Value1,Value2,Value3",",") 値の配列が返されます。

複数の値を持つ String 型のパラメーターに基づいて、値の配列を作成します。 Split の 2 番目のパラメーターでは、任意の区切り記号を使用できます。 この式は、複数値パラメーターの既定値を設定したり、サブレポートや詳細レポートに送信する複数値パラメーターを作成する場合に使用できます。
=Join(Parameters!<MultivalueParameterName>.Value,", ") 複数の値を持つパラメーターの値をコンマで区切ったリストで構成される String が返されます。 Join の 2 番目のパラメーターでは、任意の区切り記号を使用できます。

フィルターでのパラメーターの使用に関する詳細については、レポート パラメーター (レポート ビルダーおよびレポート デザイナー) に関する記事を参照してください。

参照

式 (レポート ビルダーおよび SSRS)
一般的に使用されるフィルター (レポート ビルダーおよび SSRS)
レポート パラメーターの追加、変更、または削除 (レポート ビルダーおよび SSRS)
チュートリアル:レポートへのパラメーターの追加 (レポート ビルダー)
レポート ビルダー チュートリアル
式で使用される組み込みコレクション (レポート ビルダーおよび SSRS)