Dialog Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Basisklasse für alle Dialogfelder.
public abstract class Dialog
type Dialog = class
Public MustInherit Class Dialog
- Vererbung
-
Dialog
- Abgeleitet
Konstruktoren
| Name | Beschreibung |
|---|---|
| Dialog(String) |
Initialisiert eine neue Instanz der Dialog-Klasse. Wird von Konstruktoren in abgeleiteten Klassen aufgerufen, um die Dialog Klasse zu initialisieren. |
Felder
| Name | Beschreibung |
|---|---|
| EndOfTurn |
Ein DialogTurnResult, der angibt, dass das aktuelle Dialogfeld noch aktiv ist und auf Eingaben des Benutzers wartet. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Id |
Erhält oder setzt eine ID für den Dialog. |
| Source |
Erhält die Information des Cref="SourceRange"/>. |
| TelemetryClient |
Es bekommt oder setzt die Nutzung IBotTelemetryClient , um sie für das Protokollieren zu verwenden. |
Methoden
| Name | Beschreibung |
|---|---|
| BeginDialogAsync(DialogContext, Object, CancellationToken) |
Wird aufgerufen, wenn das Dialogfeld gestartet und in den Dialogstapel verschoben wird. |
| ContinueDialogAsync(DialogContext, CancellationToken) |
Wird aufgerufen, wenn das Dialogfeld fortgesetzt, wobei es sich um das aktive Dialogfeld handelt und der Benutzer mit einer neuen Aktivität antwortet. |
| EndDialogAsync(ITurnContext, DialogInstance, DialogReason, CancellationToken) |
Wird aufgerufen, wenn das Dialogfeld beendet wird. |
| GetVersion() |
Erhält eine eindeutige Zeichenkette, die die Version dieses Dialogs darstellt. Wenn sich die Version ändert, gibt das Dialogfeldsystem ein DialogChanged-Ereignis aus. |
| OnComputeId() |
Erstellt die Compute-ID für den Dialog. |
| OnDialogEventAsync(DialogContext, DialogEvent, CancellationToken) |
Wird aufgerufen, wenn ein Ereignis mit |
| OnPostBubbleEventAsync(DialogContext, DialogEvent, CancellationToken) |
Wird aufgerufen, nachdem ein Ereignis für alle übergeordneten Eltern eingeblasen wurde und nicht behandelt wurde. |
| OnPreBubbleEventAsync(DialogContext, DialogEvent, CancellationToken) |
Wird aufgerufen, bevor ein Ereignis in das übergeordnete Element eingeblasen wird. |
| RegisterSourceLocation(String, Int32) |
Registriert ein Cref="SourceRange"/> an der angegebenen Stelle. |
| RepromptDialogAsync(ITurnContext, DialogInstance, CancellationToken) |
Wird aufgerufen, wenn das Dialogfeld den Benutzer zur Eingabe erneut auffordert. |
| ResumeDialogAsync(DialogContext, DialogReason, Object, CancellationToken) |
Wird aufgerufen, wenn ein untergeordnetes Dialogfeld diesen Vorgang abgeschlossen hat, und gibt das Steuerelement zu diesem Dialogfeld zurück. |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| RunAsync(Dialog, ITurnContext, IStatePropertyAccessor<DialogState>, CancellationToken) |
Erstellt einen Dialogstapel und startet ein Dialogfeld, indem es auf den Stapel verschoben wird. |