サンプル: エンティティ イメージを設定および取得する

このサンプルでは、エンティティ イメージのデータを設定および取得する方法を示しています。 サンプルは ここ からダウンロードできます。

このサンプルを実行する方法

1. サンプル リポジトリをダウンロードまたは複製して、ローカル コピーを用意します。
2. (オプション) cds/App.config ファイルを編集して、接続先の Microsoft Dataverse インスタンスを指定した接続文字列を定義します。
3. サンプル ソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 cds/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。

cds/App.config ファイル内に接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先の Dataverse インスタンスについての情報と、使用する資格情報についての情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。

このリポジトリにあるサンプルのうち、Dataverse インスタンスに接続する必要があるものには、cds/App.config ファイルを参照するリンクが含まれます。

このサンプルの概要

このサンプルは、組織サービス SDK アセンブリを使用してエンティティ イメージを設定および取得する方法を示します。

このサンプルがどのように動作するか

このサンプルは何をするか で説明されているシナリオをシミュレートするために、サンプルは次のことを行います:

セットアップ

組織の現在のバージョンをチェックします。

実際にやってみます

1. CreateImageAttributeDemoEntity メソッドを使用して、スキーマ名 sample_ImageAttributeDemo のカスタム テーブルと、スキーマ名 sample_Name のプライマリ列を作成します。

2. スキーマ名 EntityImage を持つイメージの列を作成します。 すべてのイメージ列は、この名前を使用します。

3. sample_ImageAttributeDemo テーブルのメイン フォームを取得して更新し、 showImage 列を true に設定して、画像がフォームに表示されるようにします。

4. sample_ImageAttributeDemo テーブルを公開します。

5. ここに示すように、イメージ フォルダにある 5 つの異なるサイズの画像を使用して、sample_ImageAttributeDemo テーブルの新しいレコードを 5 つ作成します。各レコードが作成された後、ShowEntityFormInBrowser メソッドを使用して Web ブラウザアのプリケーションでレコードを表示する機会があり、ソース画像がフォーム内のスペースに合わせてどのようにリサイズされるかを確認できます。

6. entityimage 列のレコードを取得し、サイズ変更されたファイルを保存します。 サンプルを実行した後で、\bin\Debug フォルダーに保存されたファイルを表示できます。

7. entityimage_url 列のレコードを取得し、画像にアクセスするアプリケーションに含まれる相対的な URL 値が表示されます。 転送されるデータの量が少ないため、このクエリの反応は速くなります。

クリーンアップ

セットアップ でレコードを削除するためのオプションを表示します。 サンプルによって作成されたテーブルとデータを調べる場合、削除はオプションです。 手動でレコードを削除することで同じ結果を得られます。

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。