画像編集
ImageEditコンポーネントはDataverse画像カラムの画像アップロード機能を提供します。現在の画像のプレビューを表示でき、ドラッグ&ドロップのファイル選択もサポートしています。
画像の表示
アップロードした画像のプレビューを表示するように設定 DisplayImage="true" 。無効にすると、ファイル名とアップロードコントロールのみが表示されます。
最大ファイルサイズ
MaxFileSizeを使って最大許容ファイルサイズ(バイト)を設定します。
例
画像列にバインドされた基本的な ImageEdit 。
設定オプション
以下のコントロールを使って利用可能な物件を探りましょう。
ファイルアップロード前処理
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
概要:
ファイルのサイズ(バイト単位)です。
ImageEdit クラス
パラメータ
名称 | 種類 | デフォルト | 概要 |
|---|---|---|---|
ChildContent | RenderFragment? | コンポーネントの子コンテンツ | |
ColumnName* | string | テーブルレコードからエディタをバインドするための論理カラム名。 | |
Description | string? | 説明はツールチップに表示されます。 | |
Disabled | bool? | エディターを無効にすべきか。 | |
DisplayImage | bool | False | |
DisplayLabelWhenAvailable | bool | True | ラベルが可能であれば表示するかどうかを明記しています。 |
DisplayTooltipWhenAvailable | bool | True | ツールチップが表示されるかどうかを指定します。 |
DisplayValidationErrorMessage | bool | True | コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか? |
IsVisible | bool | True | エディターは見えますか? |
Label | string? | 編集者用のラベルとして表示されるテキスト。 | |
MaxFileSizeInBytes | long? | アップロードするファイルの最大サイズ(バイト単位)を取得したり設定したりします。 デフォルト値は10MBまたは列メタデータで指定された値です。 | |
OutputFormat | ImageOutputFormat | Auto | 編集をバウンドカラムに戻す際に使われる出力形式。 デフォルトは ImageOutputFormat.Auto — JPEG入力はそのままです JPEGで、それ以外はすべてPNGを出力します。ピンで ImageOutputFormat.Png 損失なし書き込みにはどうしても対応します 出所、あるいは大きさの ImageOutputFormat.Jpeg ― 繊細な写真コラム。埋め込み者に転送 ImageViewer.OutputFormat。 |
OutputQuality | double | 0.9 | [ ImageEdit.OutputFormat PNGに解決されます。デフォルトは ImageViewer.OutputQuality。 |
ReadOnly | bool? | エディターは読み取り専用であるべきです。 | |
Required | bool? | 価値が求められるかどうか。 | |
Value | FileValue? | 列の値。 |
名称:
ChildContent種類:
RenderFragment?
概要:
コンポーネントの子コンテンツ
名称:
ColumnName*種類:
string
概要:
テーブルレコードからエディタをバインドするための論理カラム名。
名称:
Description種類:
string?
概要:
説明はツールチップに表示されます。
名称:
Disabled種類:
bool?
概要:
エディターを無効にすべきか。
名称:
DisplayImage種類:
bool
デフォルト:
False
概要:
もし真の場合 、画像バイナリはDataverseからダウンロードされ、インラインでレンダリングされます。
名称:
DisplayLabelWhenAvailable種類:
bool
デフォルト:
True
概要:
ラベルが可能であれば表示するかどうかを明記しています。
名称:
DisplayTooltipWhenAvailable種類:
bool
デフォルト:
True
概要:
ツールチップが表示されるかどうかを指定します。
名称:
DisplayValidationErrorMessage種類:
bool
デフォルト:
True
概要:
コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか?
名称:
IsVisible種類:
bool
デフォルト:
True
概要:
エディターは見えますか?
名称:
Label種類:
string?
概要:
編集者用のラベルとして表示されるテキスト。
名称:
MaxFileSizeInBytes種類:
long?
概要:
アップロードするファイルの最大サイズ(バイト単位)を取得したり設定したりします。 デフォルト値は10MBまたは列メタデータで指定された値です。
名称:
OutputFormat種類:
ImageOutputFormat
デフォルト:
Auto
概要:
編集をバウンドカラムに戻す際に使われる出力形式。 デフォルトは
ImageOutputFormat.Auto — JPEG入力はそのままです JPEGで、それ以外はすべてPNGを出力します。ピンで ImageOutputFormat.Png 損失なし書き込みにはどうしても対応します 出所、あるいは大きさの ImageOutputFormat.Jpeg ― 繊細な写真コラム。埋め込み者に転送 ImageViewer.OutputFormat。名称:
OutputQuality種類:
double
デフォルト:
0.9
概要:
[ 0, 1] のJPEG品質。無視される 0.9 です。転送先へ
ImageEdit.OutputFormat PNGに解決されます。デフォルトは ImageViewer.OutputQuality。名称:
ReadOnly種類:
bool?
概要:
エディターは読み取り専用であるべきです。
名称:
Required種類:
bool?
概要:
価値が求められるかどうか。
名称:
Value種類:
FileValue?
概要:
列の値。
イベント
名称 | 種類 | 概要 |
|---|---|---|
ValueChanged | EventCallback<ColumnValueBase> | バウンド値を更新するコールバックを取得または設定します。 |
名称:
ValueChanged種類:
EventCallback<ColumnValueBase>
概要:
バウンド値を更新するコールバックを取得または設定します。
方法
名称 | パラメータ | 種類 | 概要 |
|---|---|---|---|
GetValidationErrors | List<string> | 現在の検証エラーの集合を返します。 |
名称:
GetValidationErrors種類:
List<string>
概要:
現在の検証エラーの集合を返します。