BotFrameworkAdapter.CreateConversationAsync 方法

定義

命名空間:: Microsoft.Bot.Builder

組件:: Microsoft.Bot.Builder.dll

套件:: Microsoft.Bot.Builder v4.22.7

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
CreateConversationAsync(String, String, MicrosoftAppCredentials, ConversationParameters, BotCallbackHandler, ConversationReference, CancellationToken)	已淘汰. 在指定的通道上建立交談。 Overload 會收到包含租戶的 ConversationReference。
CreateConversationAsync(String, String, AppCredentials, ConversationParameters, BotCallbackHandler, ConversationReference, CancellationToken)	已淘汰. 在指定的通道上建立交談。 Overload 會收到包含租戶的 ConversationReference。
CreateConversationAsync(String, String, MicrosoftAppCredentials, ConversationParameters, BotCallbackHandler, CancellationToken)	在指定的通道上建立交談。
CreateConversationAsync(String, String, AppCredentials, ConversationParameters, BotCallbackHandler, CancellationToken)	在指定的通道上建立交談。

CreateConversationAsync(String, String, MicrosoftAppCredentials, ConversationParameters, BotCallbackHandler, ConversationReference, CancellationToken)

警告

This method is now obsolete because the ConversationReference argument is now redundant. Use the overload without this argument.

在指定的通道上建立交談。 Overload 會收到包含租戶的 ConversationReference。

[System.Obsolete("This method is now obsolete because the ConversationReference argument is now redundant. Use the overload without this argument.")]
public virtual System.Threading.Tasks.Task CreateConversationAsync(string channelId, string serviceUrl, Microsoft.Bot.Connector.Authentication.MicrosoftAppCredentials credentials, Microsoft.Bot.Schema.ConversationParameters conversationParameters, Microsoft.Bot.Builder.BotCallbackHandler callback, Microsoft.Bot.Schema.ConversationReference reference, System.Threading.CancellationToken cancellationToken);

[<System.Obsolete("This method is now obsolete because the ConversationReference argument is now redundant. Use the overload without this argument.")>]
override this.CreateConversationAsync : string * string * Microsoft.Bot.Connector.Authentication.MicrosoftAppCredentials * Microsoft.Bot.Schema.ConversationParameters * Microsoft.Bot.Builder.BotCallbackHandler * Microsoft.Bot.Schema.ConversationReference * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function CreateConversationAsync (channelId As String, serviceUrl As String, credentials As MicrosoftAppCredentials, conversationParameters As ConversationParameters, callback As BotCallbackHandler, reference As ConversationReference, cancellationToken As CancellationToken) As Task

參數

channelId: String

通道的標識碼。

serviceUrl: String

通道的服務 URL 端點。

credentials: MicrosoftAppCredentials

Bot 的應用程式認證。

conversationParameters: ConversationParameters

用來建立交談的交談資訊。

callback: BotCallbackHandler

要呼叫所產生 Bot 回合的方法。

reference: ConversationReference

包含租使用者的交談參考。

cancellationToken: CancellationToken

一種可被其他物件或執行緒用來接收取消通知的取消標記。

傳回

Task

工作，表示要執行的工作佇列。

屬性: ObsoleteAttribute

備註

若要開始交談，您的 Bot 必須知道其帳戶資訊和該通道上的用戶帳戶資訊。大部分_channels只支援起始直接訊息（非群組）交談。

配接器會嘗試在通道上建立新的交談，然後透過中間件管線將 conversationUpdate 活動傳送至 callback 方法。

如果與指定的使用者建立對話，活動的 Conversation 標識碼將會包含新交談的標識碼。

適用於

CreateConversationAsync(String, String, AppCredentials, ConversationParameters, BotCallbackHandler, ConversationReference, CancellationToken)

警告

This method is now obsolete because the ConversationReference argument is now redundant. Use the overload without this argument.

在指定的通道上建立交談。 Overload 會收到包含租戶的 ConversationReference。

[System.Obsolete("This method is now obsolete because the ConversationReference argument is now redundant. Use the overload without this argument.")]
public virtual System.Threading.Tasks.Task CreateConversationAsync(string channelId, string serviceUrl, Microsoft.Bot.Connector.Authentication.AppCredentials credentials, Microsoft.Bot.Schema.ConversationParameters conversationParameters, Microsoft.Bot.Builder.BotCallbackHandler callback, Microsoft.Bot.Schema.ConversationReference reference, System.Threading.CancellationToken cancellationToken);

[<System.Obsolete("This method is now obsolete because the ConversationReference argument is now redundant. Use the overload without this argument.")>]
override this.CreateConversationAsync : string * string * Microsoft.Bot.Connector.Authentication.AppCredentials * Microsoft.Bot.Schema.ConversationParameters * Microsoft.Bot.Builder.BotCallbackHandler * Microsoft.Bot.Schema.ConversationReference * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function CreateConversationAsync (channelId As String, serviceUrl As String, credentials As AppCredentials, conversationParameters As ConversationParameters, callback As BotCallbackHandler, reference As ConversationReference, cancellationToken As CancellationToken) As Task

參數

channelId: String

通道的標識碼。

serviceUrl: String

通道的服務 URL 端點。

credentials: AppCredentials

Bot 的應用程式認證。

conversationParameters: ConversationParameters

用來建立交談的交談資訊。

callback: BotCallbackHandler

要呼叫所產生 Bot 回合的方法。

reference: ConversationReference

包含租使用者的交談參考。

cancellationToken: CancellationToken

一種可被其他物件或執行緒用來接收取消通知的取消標記。

傳回

Task

工作，表示要執行的工作佇列。

屬性: ObsoleteAttribute

備註

若要開始交談，您的 Bot 必須知道其帳戶資訊和該通道上的用戶帳戶資訊。大部分_channels只支援起始直接訊息（非群組）交談。

配接器會嘗試在通道上建立新的交談，然後透過中間件管線將 conversationUpdate 活動傳送至 callback 方法。

如果與指定的使用者建立對話，活動的 Conversation 標識碼將會包含新交談的標識碼。

適用於

CreateConversationAsync(String, String, MicrosoftAppCredentials, ConversationParameters, BotCallbackHandler, CancellationToken)

在指定的通道上建立交談。

public virtual System.Threading.Tasks.Task CreateConversationAsync(string channelId, string serviceUrl, Microsoft.Bot.Connector.Authentication.MicrosoftAppCredentials credentials, Microsoft.Bot.Schema.ConversationParameters conversationParameters, Microsoft.Bot.Builder.BotCallbackHandler callback, System.Threading.CancellationToken cancellationToken);

override this.CreateConversationAsync : string * string * Microsoft.Bot.Connector.Authentication.MicrosoftAppCredentials * Microsoft.Bot.Schema.ConversationParameters * Microsoft.Bot.Builder.BotCallbackHandler * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function CreateConversationAsync (channelId As String, serviceUrl As String, credentials As MicrosoftAppCredentials, conversationParameters As ConversationParameters, callback As BotCallbackHandler, cancellationToken As CancellationToken) As Task

參數

channelId: String

通道的標識碼。

serviceUrl: String

通道的服務 URL 端點。

credentials: MicrosoftAppCredentials

Bot 的應用程式認證。

conversationParameters: ConversationParameters

用來建立交談的交談資訊。

callback: BotCallbackHandler

要呼叫所產生 Bot 回合的方法。

cancellationToken: CancellationToken

一種可被其他物件或執行緒用來接收取消通知的取消標記。

傳回

Task

工作，表示要執行的工作佇列。

備註

若要開始交談，您的 Bot 必須知道其帳戶資訊和該通道上的用戶帳戶資訊。大部分_channels只支援起始直接訊息（非群組）交談。

配接器會嘗試在通道上建立新的交談，然後透過中間件管線將 conversationUpdate 活動傳送至 callback 方法。

如果與指定的使用者建立對話，活動的 Conversation 標識碼將會包含新交談的標識碼。

適用於

CreateConversationAsync(String, String, AppCredentials, ConversationParameters, BotCallbackHandler, CancellationToken)

在指定的通道上建立交談。

public virtual System.Threading.Tasks.Task CreateConversationAsync(string channelId, string serviceUrl, Microsoft.Bot.Connector.Authentication.AppCredentials credentials, Microsoft.Bot.Schema.ConversationParameters conversationParameters, Microsoft.Bot.Builder.BotCallbackHandler callback, System.Threading.CancellationToken cancellationToken);

override this.CreateConversationAsync : string * string * Microsoft.Bot.Connector.Authentication.AppCredentials * Microsoft.Bot.Schema.ConversationParameters * Microsoft.Bot.Builder.BotCallbackHandler * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function CreateConversationAsync (channelId As String, serviceUrl As String, credentials As AppCredentials, conversationParameters As ConversationParameters, callback As BotCallbackHandler, cancellationToken As CancellationToken) As Task

參數

channelId: String

通道的標識碼。

serviceUrl: String

通道的服務 URL 端點。

credentials: AppCredentials

Bot 的應用程式認證。

conversationParameters: ConversationParameters

用來建立交談的交談資訊。

callback: BotCallbackHandler

要呼叫所產生 Bot 回合的方法。

cancellationToken: CancellationToken

一種可被其他物件或執行緒用來接收取消通知的取消標記。

傳回

Task

工作，表示要執行的工作佇列。

備註

若要開始交談，您的 Bot 必須知道其帳戶資訊和該通道上的用戶帳戶資訊。大部分_channels只支援起始直接訊息（非群組）交談。

配接器會嘗試在通道上建立新的交談，然後透過中間件管線將 conversationUpdate 活動傳送至 callback 方法。

如果與指定的使用者建立對話，活動的 Conversation 標識碼將會包含新交談的標識碼。

適用於