ChoiceEdit
ChoiceEditコンポーネントは、Dataverseの選択(オプションセット/ピックリスト)列をドロップダウンまたはラジオボタングループとしてレンダリングし、単一値選択を可能にします。
エディタータイプ
EditorTypeをChoiceEditType.Dropdown(デフォルト)かChoiceEditType.RadioButtonsのどちらかを選べるように設定してください。ラジオボタンを使う際は、RadioButtonOrientationで縦または横のレイアウトを操作します。横のラジオボタンはスペースがなくなると次の行に巻き戻します。スクロールするにはWrapRadioButtonsをfalseに設定してください。
ソート順
オプションの順序をコントロールするために SortOrder を設定してください。オプションには Default (Dataverse順序)、 DisplayName、 DisplayNameDescending、 Value、 ValueDescendingがあります。
例
選択列に割り当てられた基本的な ChoiceEdit 。
設定オプション
以下のコントロールを使って利用可能な物件を探りましょう。
ChoiceEdit クラス
パラメータ
名称 | 種類 | デフォルト | 概要 |
|---|---|---|---|
ChildContent | RenderFragment? | コンポーネントの子コンテンツ | |
ColumnName* | string | テーブルレコードからエディタをバインドするための論理カラム名。 | |
Description | string? | 説明はツールチップに表示されます。 | |
Disabled | bool? | エディターを無効にすべきか。 | |
DisplayChoiceColors | bool | False | |
DisplayLabelWhenAvailable | bool | True | ラベルが可能であれば表示するかどうかを明記しています。 |
DisplayNullChoice | bool? | 「(なし)」の選択肢を表示して列をnullに戻すかどうか。 省略した場合、デフォルトは必須認識(required-aware)で、必須列がそれを隠します (ユーザーは実数を選ばなければなりません);非必須欄が表示します。セット 明示的にどちらのデフォルトを上書きするかも。 | |
DisplayTooltipWhenAvailable | bool | True | ツールチップが表示されるかどうかを指定します。 |
DisplayValidationErrorMessage | bool | True | コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか? |
EditorType | ChoiceEditType | Dropdown | レンダリングするエディタの種類 |
InvalidChoiceValues | IEnumerable<int>? | オプションで無効な値を指定してください。 | |
InvalidValueBehavior | ChoiceInvalidValueBehavior | Remove | 無効な値を挙げる。 BaseChoiceEditCommon.ValidChoiceValues または BaseChoiceEditCommon.InvalidChoiceValues パラメータのいずれかが提供されている場合のみ適用されます。 |
IsVisible | bool | True | エディターは見えますか? |
Label | string? | 編集者用のラベルとして表示されるテキスト。 | |
RadioButtonOrientation | ComponentOrientation | Vertical | ラジオボタンの向き。 BaseChoiceEdit.EditorType が ChoiceEditType.RadioButtonsに設定されている場合にのみ有効です。 |
ReadOnly | bool? | エディターは読み取り専用であるべきです。 | |
Required | bool? | 価値が求められるかどうか。 | |
Sort | ChoiceValueSort | Default | 値のソート方法を決定します。 |
ValidChoiceValues | IEnumerable<int>? | 任意で有効な値を指定してください。 | |
Value | int? | 列の値。 | |
WrapRadioButtons | bool | True |
名称:
ChildContent種類:
RenderFragment?
概要:
コンポーネントの子コンテンツ
名称:
ColumnName*種類:
string
概要:
テーブルレコードからエディタをバインドするための論理カラム名。
名称:
Description種類:
string?
概要:
説明はツールチップに表示されます。
名称:
Disabled種類:
bool?
概要:
エディターを無効にすべきか。
名称:
DisplayChoiceColors種類:
bool
デフォルト:
False
概要:
真の場合 、Dataverseで各選択肢が示されている色の小さなスウォッチが示されます その隣、そして閉じたドロップダウンの選択した値の隣に。色のないオプションは 空白のスペースなので、ラベルはちゃんと合う。デフォルトはfalse です。
名称:
DisplayLabelWhenAvailable種類:
bool
デフォルト:
True
概要:
ラベルが可能であれば表示するかどうかを明記しています。
名称:
DisplayNullChoice種類:
bool?
概要:
「(なし)」の選択肢を表示して列をnullに戻すかどうか。 省略した場合、デフォルトは必須認識(required-aware)で、必須列がそれを隠します (ユーザーは実数を選ばなければなりません);非必須欄が表示します。セット 明示的にどちらのデフォルトを上書きするかも。
名称:
DisplayTooltipWhenAvailable種類:
bool
デフォルト:
True
概要:
ツールチップが表示されるかどうかを指定します。
名称:
DisplayValidationErrorMessage種類:
bool
デフォルト:
True
概要:
コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか?
名称:
EditorType種類:
ChoiceEditType
デフォルト:
Dropdown
概要:
レンダリングするエディタの種類
名称:
InvalidChoiceValues種類:
IEnumerable<int>?
概要:
オプションで無効な値を指定してください。
名称:
InvalidValueBehavior種類:
ChoiceInvalidValueBehavior
デフォルト:
Remove
概要:
無効な値を挙げる。
BaseChoiceEditCommon.ValidChoiceValues または BaseChoiceEditCommon.InvalidChoiceValues パラメータのいずれかが提供されている場合のみ適用されます。名称:
IsVisible種類:
bool
デフォルト:
True
概要:
エディターは見えますか?
名称:
Label種類:
string?
概要:
編集者用のラベルとして表示されるテキスト。
名称:
RadioButtonOrientation種類:
ComponentOrientation
デフォルト:
Vertical
概要:
ラジオボタンの向き。
BaseChoiceEdit.EditorType が ChoiceEditType.RadioButtonsに設定されている場合にのみ有効です。名称:
ReadOnly種類:
bool?
概要:
エディターは読み取り専用であるべきです。
名称:
Required種類:
bool?
概要:
価値が求められるかどうか。
名称:
Sort種類:
ChoiceValueSort
デフォルト:
Default
概要:
値のソート方法を決定します。
名称:
ValidChoiceValues種類:
IEnumerable<int>?
概要:
任意で有効な値を指定してください。
名称:
Value種類:
int?
概要:
列の値。
名称:
WrapRadioButtons種類:
bool
デフォルト:
True
概要:
true (デフォルト)の場合、部屋が尽きた水平のラジオボタンは 次の行;間違 った場合は1行に留まり、スクロールします。縦行には影響しません。
イベント
名称 | 種類 | 概要 |
|---|---|---|
ValueChanged | EventCallback<ColumnValueBase> | バウンド値を更新するコールバックを取得または設定します。 |
名称:
ValueChanged種類:
EventCallback<ColumnValueBase>
概要:
バウンド値を更新するコールバックを取得または設定します。
方法
名称 | パラメータ | 種類 | 概要 |
|---|---|---|---|
GetValidationErrors | List<string> | 現在の検証エラーの集合を返します。 |
名称:
GetValidationErrors種類:
List<string>
概要:
現在の検証エラーの集合を返します。