DataSourceInfo 関数

適用対象: キャンバス アプリ モデル駆動型アプリ

データ ソース に関する情報を提供します。

概要

データ ソースは、ユーザー エクスペリエンスを最適化するために貴重な情報を提供できます。

Patch 関数を使用する前に、列 レベルの情報を使用して、ユーザー入力を検証し、ユーザーに即時フィードバックを提供することができます。 Validate 関数はこの同じ情報を使用します。

データ ソース レベルで情報を使用して、たとえば、レコード を編集および作成するためのアクセス許可を持たないユーザーに対して、編集および新規作成ボタンを無効または非表示にすることができます。

データ ソースは提供する情報の量によって異なり、まったく提供しないものもあります。 コレクション は情報を提供しません。 情報が提供されない場合は、既定が使用されるか、もしくは空白が返されます。

説明

列情報

DataSourceInfoを使用して、データ ソースの特定の列に関する情報を取得できます。

3 番目の引数は、文字列としての列の名前です。 たとえば、人物コレクションの 電話の列は、二重引用符を含む "Phone" として渡されます。

データ ソースの情報

DataSourceInfoを使用して、データ ソース全体に関する情報を取得することもできます。

構文

DataSourceInfo( DataSource, Information [, ColumnName] )

• DataSource – 必須。 使用するデータ ソース。
• 情報 – 必須。 取得する情報の種類。
• ColumnName – オプション。 列レベルの情報を取得するための列名。 データ ソース レベルの情報に関しては、ColumnName 引数を使用することはできません。

使用例

このセクションの例は、IceCream という名前のデータ ソースを使用します。

このデータ ソースは、次の情報も提供します。

• 数量の表示名は "手持ち在庫数量" です。
• Flavor の最大長は 30 文字です。
• Flavor 列には値を含める必要があります。 数量 列は必須ではありません。
• 最小数量は 0 です。
• 最大数量は 100 です。
• 現在のユーザーは、IceCream データ ソースのレコードの読み取りおよび編集を行うことができますが、レコードを作成および削除することはできません。