改ページ対応レポート内の Parameters コレクション参照 (Report Builder)

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

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

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

パラメーター参照を式に含めるには、パラメーター参照に適切な構文を指定する方法を理解する必要があります。 構文は、パラメーターが単一値パラメーターか複数値パラメーターかによって異なります。

Note

ページ分割されたレポートの定義ファイル (.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	パラメーターと同じ名前のフィールドの値が返されます。

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

式で複数値パラメーターを使用する

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

例	説明
=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 番目のパラメーターでは、任意の区切り記号を使用できます。

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

関連するコンテンツ

式 (Report Builder)
一般的に使用されるフィルター (Report Builder)
レポート パラメーターを追加、変更、または削除する (Report Builder)
チュートリアル: レポートへのパラメータの追加 (レポート ビルダー)
レポート ビルダー チュートリアル
式のビルトイン コレクション (Report Builder)