ファイル編集
FileEditコンポーネントはDataverseのファイルカラムのアップロードおよびダウンロード機能を提供します。ドラッグ&ドロップに対応し、ファイルが接続されると現在のファイル名が表示されます。
最大ファイルサイズ
MaxFileSizeを使って最大許容ファイルサイズ(バイト)を設定します。この制限を超えるファイルはアップロード前に拒否されます。
例
ファイルカラムにバインドされた基本的な FileEdit です。
設定オプション
以下のコントロールを使って利用可能な物件を探りましょう。
ファイルアップロード前処理
Dataverseに保存する前にファイルを事前処理する必要がある場合は、 OnFileUploaded コールバックを使ってアップロードプロセスにフックし、カスタム処理を適用してください。
FileSaveOptions クラス
性質
名称 | 種類 | デフォルト | 概要 |
|---|---|---|---|
OnFileUploaded | Func<ColumnFileInfo, Task<FileInfo>>? | ファイルがアップロードされた後、Dataverseに保存される前に呼び出すオプションのコールバックです。 ファイルデータとターゲットテーブル/カラムを含む Models.ColumnFileInfo を受け取ります。 そして(修正された可能性のある)ファイルを含む Models.FileInfo を返して保存します。 これを使って画像のサイズ変更、ファイル形式の変換、ウイルススキャン、その他の変換が可能です。 | |
SaveMode | FileSaveMode | SaveToTemporaryFolder | アップロード中にファイルを一時的に保存するためのモードです。 FileSaveMode.SaveToTemporaryFolder ファイルをサーバー上の一時フォルダに書き込みます Dataverseに保存する前に。 FileSaveMode.Stream ファイルを直接Dataverseにストリーミングします 中間ストレージなしで。デフォルトは FileSaveMode.SaveToTemporaryFolderです。 |
名称:
OnFileUploaded種類:
Func<ColumnFileInfo, Task<FileInfo>>?
概要:
ファイルがアップロードされた後、Dataverseに保存される前に呼び出すオプションのコールバックです。 ファイルデータとターゲットテーブル/カラムを含む
Models.ColumnFileInfo を受け取ります。 そして(修正された可能性のある)ファイルを含む Models.FileInfo を返して保存します。 これを使って画像のサイズ変更、ファイル形式の変換、ウイルススキャン、その他の変換が可能です。名称:
SaveMode種類:
FileSaveMode
デフォルト:
SaveToTemporaryFolder
概要:
アップロード中にファイルを一時的に保存するためのモードです。
FileSaveMode.SaveToTemporaryFolder ファイルをサーバー上の一時フォルダに書き込みます Dataverseに保存する前に。 FileSaveMode.Stream ファイルを直接Dataverseにストリーミングします 中間ストレージなしで。デフォルトは FileSaveMode.SaveToTemporaryFolderです。ColumnFileInfo クラス
性質
名称 | 種類 | デフォルト | 概要 |
|---|---|---|---|
ColumnName | string | ファイルがアップロードされるファイルの論理名や画像列の名前です。 | |
FileInfo | FileInfo | アップロードされたファイル名、サイズ、バイナリコンテンツなどの情報。 | |
TableName | string | ファイルがアップロードされるDataverseテーブルの論理名。 |
名称:
ColumnName種類:
string
概要:
ファイルがアップロードされるファイルの論理名や画像列の名前です。
名称:
FileInfo種類:
FileInfo
概要:
アップロードされたファイル名、サイズ、バイナリコンテンツなどの情報。
名称:
TableName種類:
string
概要:
ファイルがアップロードされるDataverseテーブルの論理名。
FileInfo クラス
性質
名称 | 種類 | デフォルト | 概要 |
|---|---|---|---|
FileData | byte[]? | ファイルの生のバイナリ内容です。ファイルがまだメモリに読み込まれていない場合は、nullになることがあります。 | |
FileName | string | 拡張子を含む元のファイル名(例:「document.pdf」)。 | |
FileSizeInBytes | long | 0 | ファイルのサイズ(バイト単位)です。 |
名称:
FileData種類:
byte[]?
概要:
ファイルの生のバイナリ内容です。ファイルがまだメモリに読み込まれていない場合は、nullになることがあります。
名称:
FileName種類:
string
概要:
拡張子を含む元のファイル名(例:「document.pdf」)。
名称:
FileSizeInBytes種類:
long
デフォルト:
0
概要:
ファイルのサイズ(バイト単位)です。
FileEdit クラス
パラメータ
名称 | 種類 | デフォルト | 概要 |
|---|---|---|---|
ChildContent | RenderFragment? | コンポーネントの子コンテンツ | |
ColumnName* | string | テーブルレコードからエディタをバインドするための論理カラム名。 | |
Description | string? | 説明はツールチップに表示されます。 | |
Disabled | bool? | エディターを無効にすべきか。 | |
DisplayLabelWhenAvailable | bool | True | ラベルが可能であれば表示するかどうかを明記しています。 |
DisplayTooltipWhenAvailable | bool | True | ツールチップが表示されるかどうかを指定します。 |
DisplayValidationErrorMessage | bool | True | コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか? |
IsVisible | bool | True | エディターは見えますか? |
Label | string? | 編集者用のラベルとして表示されるテキスト。 | |
MaxFileSizeInBytes | long? | アップロードするファイルの最大サイズ(バイト単位)を取得したり設定したりします。 デフォルト値は10MBまたは列メタデータで指定された値です。 | |
ReadOnly | bool? | エディターは読み取り専用であるべきです。 | |
Required | bool? | 価値が求められるかどうか。 | |
Value | FileValue? | 列の値。 |
名称:
ChildContent種類:
RenderFragment?
概要:
コンポーネントの子コンテンツ
名称:
ColumnName*種類:
string
概要:
テーブルレコードからエディタをバインドするための論理カラム名。
名称:
Description種類:
string?
概要:
説明はツールチップに表示されます。
名称:
Disabled種類:
bool?
概要:
エディターを無効にすべきか。
名称:
DisplayLabelWhenAvailable種類:
bool
デフォルト:
True
概要:
ラベルが可能であれば表示するかどうかを明記しています。
名称:
DisplayTooltipWhenAvailable種類:
bool
デフォルト:
True
概要:
ツールチップが表示されるかどうかを指定します。
名称:
DisplayValidationErrorMessage種類:
bool
デフォルト:
True
概要:
コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか?
名称:
IsVisible種類:
bool
デフォルト:
True
概要:
エディターは見えますか?
名称:
Label種類:
string?
概要:
編集者用のラベルとして表示されるテキスト。
名称:
MaxFileSizeInBytes種類:
long?
概要:
アップロードするファイルの最大サイズ(バイト単位)を取得したり設定したりします。 デフォルト値は10MBまたは列メタデータで指定された値です。
名称:
ReadOnly種類:
bool?
概要:
エディターは読み取り専用であるべきです。
名称:
Required種類:
bool?
概要:
価値が求められるかどうか。
名称:
Value種類:
FileValue?
概要:
列の値。
イベント
名称 | 種類 | 概要 |
|---|---|---|
ValueChanged | EventCallback<ColumnValueBase> | バウンド値を更新するコールバックを取得または設定します。 |
名称:
ValueChanged種類:
EventCallback<ColumnValueBase>
概要:
バウンド値を更新するコールバックを取得または設定します。
方法
名称 | パラメータ | 種類 | 概要 |
|---|---|---|---|
GetValidationErrors | List<string> | 現在の検証エラーの集合を返します。 |
名称:
GetValidationErrors種類:
List<string>
概要:
現在の検証エラーの集合を返します。