Concat および Concatenate 関数

  • [アーティクル]

適用先 : キャンバス アプリ Dataverse 数式列 デスクトップ フロー モデル駆動型アプリ Power Platform CLI

テキストの個々の文字列とテーブル 内の文字列を連結します。

内容

Concatenate 関数は、個々の文字列の組み合わせおよび文字列の単一列テーブルを連結します。 個々の文字列を用いてこの関数を使用する場合、&演算子 を使用するのと同等になります。

Concat 関数は、テーブルのすべてのレコード にまたがって適用される数式の結果を連結し、単一の文字列にします。 この関数は、Sum 関数が数値に対して行うのと同じように、テーブルの文字列を要約するために使用します。

現在処理されているレコードのフィールドは、この数式内で使用できます。 ThisRecord 演算子を使用するか、他の値を参照するのと同様に名前でフィールドを参照します。 As 演算子を使用して処理対象のレコードを指定することもできます。そうすると数式がわかりやすくなり、入れ子になったレコードにアクセスしやすくなります。 詳細については、以下の例と「レコードのスコープに関する作業」を参照してください。

文字列を部分文字列テーブルに分割するには、Split または MatchAll 関数を使用します。

構文

Concat (テーブル、数式、区切り記号)

  • Table - 必須。 操作の対象となるテーブル。
  • Formula - 必須。 テーブルのレコードにまたがって適用する数式。
  • Separator - オプション。 テーブルの連結された行の間に挿入されるテキスト値です。

Concatenate( String1 [, String2, ...] )

  • String(s) - 必須。 個々の文字列の組み合わせまたは文字列の単一列テーブル。

例

このセクションの例は、次のグローバル変数を使用します:

  • FirstName = "Jane"
  • LastName = "Doe"
  • 製品 = 2 つの列および 4 つの行のテーブル。

アプリでこれらのグローバル変数を作成するには、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"