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 uma nova caixa de diálogo e substitui na pilha a caixa de diálogo atualmente ativa pela nova. Isto é particularmente útil para criar ciclos 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 da nova caixa de diálogo a iniciar.
- options
- Object
Opcional, as informações a transmitir para a caixa de diálogo que está a ser iniciada.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser utilizado por outros objetos ou threads para receber aviso de cancelamento.
Devoluções
Uma tarefa que representa o trabalho em fila para executar.
Observações
Se a tarefa for bem-sucedida, o resultado indica se a caixa de diálogo ainda está ativa depois de a vez ter sido processada pela caixa de diálogo.