IDialogService

この IDialogService は、確認プロンプト、エラーメッセージ、情報通知、成功通知、警告など、モーダルダイアログを表示する方法を提供します。

サービスの注入

任意のコンポーネントからダイアログサービスにアクセスできます。Reactでは、フレームワークダイアログプロバイダーによってラップされた木の内部から useDialogService() を呼び出します。Blazorではプロパティ注入によってサービスに注入します。PowerPortalsProのダイアログサービスは、基盤となるFluentUIダイアログサービスとは異なることに注意してください。

React

Blazor

確認ダイアログ

ShowConfirmationAsyncを使ってユーザーにはい/いいえの質問を促します。ユーザーが二次(ネガティブ)オプションを選択すると、返DialogResult.Cancelledプロパティがtrueされます。

React

Blazor

メッセージダイアログ

以下の方法で、異なるビジュアルスタイルでシングルボタンのメッセージダイアログを表示します:

ShowInfoAsync — 中立アイコン付きの情報メッセージ。
ShowSuccessAsync — 緑色のチェックマークアイコン付きの成功メッセージ。
ShowWarningAsync — 黄色の警告アイコン付きの警告メッセージ。
ShowErrorAsync — 赤いエラーアイコン付きのエラーメッセージ。

React

Blazor

一般的なパラメータ

すべてのダイアログメソッドはオプションの title および primaryText パラメータを受け付けています。省略する場合は、ローカライズされたデフォルト値が使われます。確認ダイアログではキャンセルボタンラベルの secondaryText パラメータも受け入れられます。

ダイアログ結果

すべてのメソッドは DialogResult オブジェクトを返します。確認ダイアログについては、 Cancelled プロパティを確認してユーザーの選択を決定してください。メッセージのダイアログでは、結果がダイアログが終了したことを示します。

インタラクティブデモ

以下の操作でダイアログのタイトルとメッセージをカスタマイズし、任意のボタンをクリックすると対応するダイアログタイプが表示されます。

Reactの例

ブレイザーの例

セリフタイトル

対話メッセージ

確認ダイアログを表示する

エラーダイアログ表示

情報表示ダイアログ

ショー成功ダイアログ

警告ダイアログを表示する

React TypeScript

Razor

反応してください

ブレイザー

IDialogService Interface

方法

名称	パラメータ	種類	概要
`ShowConfirmationAsync`	string message string title string primaryText string secondaryText	Task<DialogResult>	提供された `message` と2つのアクションボタンで確認ダイアログが表示され、その後ユーザーが一つ選ぶことができます。返 `Services.DialogResult` は `DialogResult.Cancelled` ユーザーが二次(マイナス)オプションを選択すると真となります。
`ShowErrorAsync`	string message string title string primaryText	Task<DialogResult>	提供された `message` とのエラーダイアログが表示され、ユーザーがそれを終了するのを待ちます。
`ShowInfoAsync`	string message string title string primaryText	Task<DialogResult>	提供された `message` に関する情報ダイアログが表示され、ユーザーが終了するのを待ちます。
`ShowSuccessAsync`	string message string title string primaryText	Task<DialogResult>	提供された `message` との成功ダイアログが表示され、ユーザーが終了するのを待ちます。
`ShowWarningAsync`	string message string title string primaryText	Task<DialogResult>	提供された `message` で警告ダイアログが表示され、ユーザーがそれを終了するのを待ちます。

名称: ShowConfirmationAsync

パラメータ: string message
string title
string primaryText
string secondaryText

種類: Task<DialogResult>

概要: 提供された message と2つのアクションボタンで確認ダイアログが表示され、その後ユーザーが一つ選ぶことができます。返 Services.DialogResult は DialogResult.Cancelled ユーザーが二次(マイナス)オプションを選択すると真となります。

名称: ShowErrorAsync

パラメータ: string message
string title
string primaryText

種類: Task<DialogResult>

概要: 提供された message とのエラーダイアログが表示され、ユーザーがそれを終了するのを待ちます。

名称: ShowInfoAsync

パラメータ: string message
string title
string primaryText

種類: Task<DialogResult>

概要: 提供された message に関する情報ダイアログが表示され、ユーザーが終了するのを待ちます。

名称: ShowSuccessAsync

パラメータ: string message
string title
string primaryText

種類: Task<DialogResult>

概要: 提供された message との成功ダイアログが表示され、ユーザーが終了するのを待ちます。

名称: ShowWarningAsync

パラメータ: string message
string title
string primaryText

種類: Task<DialogResult>

概要: 提供された message で警告ダイアログが表示され、ユーザーがそれを終了するのを待ちます。

反応してください

ブレイザー

DialogResult クラス

性質

名称	種類	デフォルト	概要
`Cancelled`	bool	False	ダイアログがキャンセルされたかどうか(例:ユーザーが確認せずに終了した)を示す値が付与されます。
`Data`	Object?		ダイアログが閉じたときに返されるオプションのデータペイロード。

名称: Cancelled

種類: bool

デフォルト: False

概要: ダイアログがキャンセルされたかどうか(例:ユーザーが確認せずに終了した)を示す値が付与されます。

名称: Data

種類: Object?

概要: ダイアログが閉じたときに返されるオプションのデータペイロード。

方法

名称	パラメータ	種類	概要
`Cancel`	Object data	DialogResult	キャンセルされた結果を表す `Services.DialogResult` を作成し、オプションでデータペイロードを搭載します。
`Ok<T>`	T result	DialogResult	`result`をデータペイロードとして運ぶ、確認された結果を表す`Services.DialogResult`を作成します。

名称: Cancel

パラメータ: Object data

種類: DialogResult

概要: キャンセルされた結果を表す Services.DialogResult を作成し、オプションでデータペイロードを搭載します。

名称: Ok<T>

パラメータ: T result

種類: DialogResult

概要: resultをデータペイロードとして運ぶ、確認された結果を表すServices.DialogResultを作成します。