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