Concat および Concatenate 関数
適用対象: キャンバス アプリ Dataverse 数式列 デスクトップ フロー モデル駆動型アプリ Power Pages Power Platform CLI
テキストの個々の文字列とテーブル 内の文字列を連結します。
内容
Concatenate 関数は、個々の文字列の組み合わせおよび文字列の単一列テーブルを連結します。 個々の文字列を用いてこの関数を使用する場合、&演算子 を使用するのと同等になります。
Concat 関数は、テーブルのすべてのレコード にまたがって適用される数式の結果を連結し、単一の文字列にします。 この関数は、Sum 関数が数値に対して行うのと同じように、テーブルの文字列を要約するために使用します。
現在処理されているレコードのフィールドは、この数式内で使用できます。 ThisRecord 演算子を使用するか、他の値を参照するのと同様に名前でフィールドを参照します。 As 演算子を使用して処理対象のレコードを指定することもできます。そうすると数式がわかりやすくなり、入れ子になったレコードにアクセスしやすくなります。 詳細については、以下の例と「レコードのスコープに関する作業」を参照してください。
文字列を部分文字列テーブルに分割するには、Split または MatchAll 関数を使用します。
構文
連結( 表、 数式、 区切り文字)
- 表 - 必須。 操作の対象となるテーブル。
- 式 - 必須。 テーブルのレコードにまたがって適用する数式。
- セパレータ - オプション。 テーブルの連結された行の間に挿入されるテキスト値です。
連結( 文字列1 [, 文字列2, ...] )
- 文字列 - 必須。 個々の文字列の組み合わせまたは文字列の単一列テーブル。
例
このセクションの例は、次のグローバル変数を使用します:
- ファーストネーム = "ジェーン"
- LastName = "Doe"
- 製品 =
アプリでこれらのグローバル変数を作成するには、Button コントロールを挿入し、OnSelect プロパティを次の数式に設定します:
Set( FirstName, "Jane" ); Set( LastName, "Doe" );
Set( Products,
Table(
{ Name: "Violin", Type: "String" },
{ Name: "Cello", Type: "String" },
{ Name: "Trumpet", Type: "Wind" }
)
)
(Alt キーを押しながらクリックして) ボタンを選択します。
Concatenate 関数および & 演算子
これらの例では、Label コントロールの Text プロパティを、次のテーブルの最初の列の数式に設定します。
計算式 | 内容 | 結果 |
---|---|---|
連結(姓, ", ", 名) | LastName の値、文字列である ", " (コンマの後にスペースが続く)、および FirstName の値を連結します。 | "Doe 、Jane" |
姓 & ", " & 名 | 関数の代わりに & 演算子を使用していることを除き、前の例と同じです。 | "Doe 、Jane" |
連結(名、" "、姓) | FirstName の値、文字列である " " (単一のスペース)、および LastName の値を連結します。 | "Jane Doe" |
名 & " " & 姓 | 前の例と同じですが、関数の代わりに & 演算子を使用しています。 | "Jane Doe" |
単一列テーブルと連結
この例では、空白で、垂直の Gallery コントロールを追加し、その Items プロパティを次のテーブルの数式に設定し、次にギャラリー テンプレートにラベルを追加します。
計算式 | 内容 | 結果 |
---|---|---|
連結します ( "名前: ", Products.Name, ", タイプ: ", Products.Type ) | 製品テーブルの各レコードで、文字列である Name、製品の名前、文字列である Type および製品の種類を連結します。 | 次の値を含む Value 列を持つ単一列テーブル: "Name: Violin, Type: String", "Name: "Cello, Type: String", "Name: Trumpet, Type: Wind" |
Concat 関数
これらの例では、ラベルの Text プロパティを次のテーブルの最初の列の数式に設定します。
式 | Description | Result |
---|---|---|
Concat(製品, 名前, ", ") | 製品の各レコードに対して式である 名前 が評価され、結果を ", " で分割して単一の文字列に連結します。 | "'Violin', 'Cello', 'Trumpet'" |
Concat(製品、"'" & 名前 & "'", ", ") | 製品の各レコードに対して式である "'" & Name & "'" が評価され、結果を ", " で分割して単一の文字列に連結します。 | "'Violin', 'Cello', 'Trumpet'" |
Concat( フィルター( 製品、タイプ = "文字列" )、名前、"、" ) | フィルターである Type = "String" を満たす 製品 の各レコードに対して式である 名前 が評価され、結果を ", " で分割して単一の文字列に連結します。 | "Violin, Cello" |
Split および MatchAll
区切り記号で Concat を使用した場合、Split 関数を使うことで操作を逆にできます。
これらの例では、空白で、垂直のギャラリーを追加し、その Items プロパティを次のテーブルの数式に設定し、次にギャラリー テンプレートにラベルを追加します。
式 | Description | Result |
---|---|---|
Split( Concat( 製品、名前、"、" )、"、" ) | 区切り記号 ", " でテキスト文字列を分割します。 | 次の値を含む Value 列を持つ単一列テーブル: "Violin", "Cello", "Trumpet" |