IDialogService

Sie IDialogService bietet Methoden zur Anzeige modaler Dialoge für den Benutzer, einschließlich Bestätigungshinweise, Fehlermeldungen, Informationshinweise, Erfolgsbenachrichtigungen und Warnungen.

Injektion des Dienstes

Greifen Sie von jeder Komponente aus auf den Dialogdienst zu. In React wird useDialogService() der Baum vom Framework-Dialoganbieter gewrapped; in Blazor wird der Dienst per Property Injection injiziert. Beachten Sie, dass der PowerPortalsPro-Dialogdienst sich vom zugrundeliegenden FluentUI-Dialogdienst unterscheidet.

React

Blazor

Bestätigungsdialoge

Benutze, ShowConfirmationAsync um den Nutzer mit einer Ja/Nein-Frage zu befragen. Die zurückgegebene DialogResult.Cancelled Eigenschaft ist true , wenn der Benutzer die sekundäre (negative) Option auswählt.

React

Blazor

Nachrichtendialoge

Verwenden Sie die folgenden Methoden, um Nachrichtendialoge mit nur einer Taste in unterschiedlichen visuellen Stilen anzuzeigen:

ShowInfoAsync — Informationsnachricht mit neutralem Symbol.
ShowSuccessAsync — Erfolgsmeldung mit grünem Häkchen.
ShowWarningAsync — Warnmeldung mit gelbem Warnsymbol.
ShowErrorAsync — Fehlermeldung mit rotem Fehlersymbol.

React

Blazor

Gemeinsame Parameter

Alle Dialogmethoden akzeptieren optional title und primaryText Parameter. Wenn sie weggelassen werden, werden lokalisierte Standardwerte verwendet. Der Bestätigungsdialog akzeptiert außerdem einen Parameter secondaryText für das Abbrechen-Button-Label.

Dialogergebnis

Alle Methoden geben ein DialogResult Objekt zurück. Für Bestätigungsdialoge überprüfen Sie die Eigenschaft Cancelled , um die Wahl des Nutzers zu bestimmen. Bei Nachrichtendialogen zeigt das Ergebnis an, dass der Dialog geschlossen wurde.

Interaktive Demo

Verwenden Sie die untenstehenden Steuerungen, um den Dialogtitel und die Nachricht anzupassen, und klicken Sie dann auf eine beliebige Taste, um den entsprechenden Dialogtyp zu sehen.

React-Beispiel

Blazor-Beispiel

Dialogtitel

Dialognachricht

Show-Bestätigungsdialog

Fehler-Anzeigen-Dialog

Dialog: Anzeigen-Informationen

Show Success Dialog

Warnungsdialog anzeigen

React TypeScript

Razor

Reagieren

Blazor

IDialogService Interface

Methoden

Name	Parameter	Typ	Beschreibung
`ShowConfirmationAsync`	string message string title string primaryText string secondaryText	Task<DialogResult>	Zeigt einen Bestätigungsdialog mit den bereitgestellten `message` und zwei Aktionstasten an, dann wartet auf Der Nutzer wählt eine aus. Die zurückgegebene Eingabe `Services.DialogResult` ist `DialogResult.Cancelled` gesetzt auf wahr, wenn der Nutzer die sekundäre (negative) Option auswählt.
`ShowErrorAsync`	string message string title string primaryText	Task<DialogResult>	Zeigt ein Fehler-Dialog mit dem angegebenen `message` Symbol an und wartet darauf, dass der Benutzer es schließt.
`ShowInfoAsync`	string message string title string primaryText	Task<DialogResult>	Zeigt einen Informationsdialog mit dem bereitgestellten `message` Dialog und wartet darauf, dass der Nutzer ihn abschließt.
`ShowSuccessAsync`	string message string title string primaryText	Task<DialogResult>	Zeigt einen erfolgreichen Dialog mit dem bereitgestellten `message` Dialog und wartet darauf, dass der Nutzer ihn abschließt.
`ShowWarningAsync`	string message string title string primaryText	Task<DialogResult>	Zeigt einen Warndialog mit dem bereitgestellten `message` Bildschirm an und wartet darauf, dass der Benutzer ihn schließt.

Name: ShowConfirmationAsync

Parameter: string message
string title
string primaryText
string secondaryText

Typ: Task<DialogResult>

Beschreibung: Zeigt einen Bestätigungsdialog mit den bereitgestellten message und zwei Aktionstasten an, dann wartet auf Der Nutzer wählt eine aus. Die zurückgegebene Eingabe Services.DialogResult ist DialogResult.Cancelled gesetzt auf wahr, wenn der Nutzer die sekundäre (negative) Option auswählt.

Name: ShowErrorAsync

Parameter: string message
string title
string primaryText

Typ: Task<DialogResult>

Beschreibung: Zeigt ein Fehler-Dialog mit dem angegebenen message Symbol an und wartet darauf, dass der Benutzer es schließt.

Name: ShowInfoAsync

Parameter: string message
string title
string primaryText

Typ: Task<DialogResult>

Beschreibung: Zeigt einen Informationsdialog mit dem bereitgestellten message Dialog und wartet darauf, dass der Nutzer ihn abschließt.

Name: ShowSuccessAsync

Parameter: string message
string title
string primaryText

Typ: Task<DialogResult>

Beschreibung: Zeigt einen erfolgreichen Dialog mit dem bereitgestellten message Dialog und wartet darauf, dass der Nutzer ihn abschließt.

Name: ShowWarningAsync

Parameter: string message
string title
string primaryText

Typ: Task<DialogResult>

Beschreibung: Zeigt einen Warndialog mit dem bereitgestellten message Bildschirm an und wartet darauf, dass der Benutzer ihn schließt.

Reagieren

Blazor

DialogResult Baureihe

Eigenschaften

Name	Typ	Default	Beschreibung
`Cancelled`	bool	False	Erhält einen Wert, der angibt, ob der Dialog abgebrochen wurde (z. B. hat der Benutzer ihn ohne Bestätigung abgelehnt).
`Data`	Object?		Optionale Datennutzlast, die vom Dialog beim Schließen zurückgegeben wird.

Name: Cancelled

Typ: bool

Default: False

Beschreibung: Erhält einen Wert, der angibt, ob der Dialog abgebrochen wurde (z. B. hat der Benutzer ihn ohne Bestätigung abgelehnt).

Name: Data

Typ: Object?

Beschreibung: Optionale Datennutzlast, die vom Dialog beim Schließen zurückgegeben wird.

Methoden

Name	Parameter	Typ	Beschreibung
`Cancel`	Object data	DialogResult	Erzeugt ein `Services.DialogResult` Ergebnis, das ein abgebrochenes Ergebnis darstellt und optional eine Datennutzlast trägt.
`Ok<T>`	T result	DialogResult	Erzeugt ein `Services.DialogResult` Ergebnis, das ein bestätigtes Ergebnis darstellt und als Datennutzlast transportiert `result` wird.

Name: Cancel

Parameter: Object data

Typ: DialogResult

Beschreibung: Erzeugt ein Services.DialogResult Ergebnis, das ein abgebrochenes Ergebnis darstellt und optional eine Datennutzlast trägt.

Name: Ok<T>

Parameter: T result

Typ: DialogResult

Beschreibung: Erzeugt ein Services.DialogResult Ergebnis, das ein bestätigtes Ergebnis darstellt und als Datennutzlast transportiert result wird.