DialogContext.ReplaceDialogAsync(String, Object, CancellationToken) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicia um novo diálogo e substitui na pilha o diálogo atualmente ativo pelo novo. Isso é particularmente útil para criar loops ou redirecionar para outra caixa de diálogo.
public System.Threading.Tasks.Task<Microsoft.Bot.Builder.Dialogs.DialogTurnResult> ReplaceDialogAsync(string dialogId, object options = default, System.Threading.CancellationToken cancellationToken = default);member this.ReplaceDialogAsync : string * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Builder.Dialogs.DialogTurnResult>Public Function ReplaceDialogAsync (dialogId As String, Optional options As Object = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DialogTurnResult)Parâmetros
- dialogId
- String
ID do novo diálogo para começar.
- options
- Object
Opcional, informação para passar ao diálogo que está a ser iniciado.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.
Devoluções
Uma tarefa que representa o trabalho enfileirado para ser executado.
Observações
Se a tarefa for bem-sucedida, o resultado indica se a caixa de diálogo ainda está ativa após o turno ter sido processado pela caixa de diálogo.