BotFrameworkHttpAdapter 類別

定義

命名空間:: Microsoft.Bot.Builder.Integration.AspNet.Core

組件:: Microsoft.Bot.Builder.Integration.AspNet.Core.dll

套件:: Microsoft.Bot.Builder.Integration.AspNet.Core v4.22.7

重要

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

警告

BotFrameworkHttpAdapter is still supported in v4 but the recommended adapter is CloudAdapter

用來處理 Bot Framework HTTP 要求的 Bot Builder 配接器實作。

[System.Obsolete("BotFrameworkHttpAdapter is still supported in v4 but the recommended adapter is `CloudAdapter`", false)]
public class BotFrameworkHttpAdapter : Microsoft.Bot.Builder.Streaming.BotFrameworkHttpAdapterBase, Microsoft.Bot.Builder.Integration.AspNet.Core.IBotFrameworkHttpAdapter

[<System.Obsolete("BotFrameworkHttpAdapter is still supported in v4 but the recommended adapter is `CloudAdapter`", false)>]
type BotFrameworkHttpAdapter = class
    inherit BotFrameworkHttpAdapterBase
    interface IBotFrameworkHttpAdapter

Public Class BotFrameworkHttpAdapter
Inherits BotFrameworkHttpAdapterBase
Implements IBotFrameworkHttpAdapter

繼承: Object

BotAdapter

BotFrameworkAdapter

BotFrameworkHttpAdapterBase
BotFrameworkHttpAdapter

屬性: ObsoleteAttribute

實作: IBotFrameworkHttpAdapter

備註

BotFrameworkHttpAdapter 仍然支援，但推薦的轉接器是 CloudAdapter。

建構函式

名稱	Description
BotFrameworkHttpAdapter(IConfiguration, ICredentialProvider, AuthenticationConfiguration, IChannelProvider, RetryPolicy, HttpClient, IMiddleware, ILogger)	已淘汰. 初始化 BotFrameworkHttpAdapter 類別的新執行個體。
BotFrameworkHttpAdapter(IConfiguration, ILogger<BotFrameworkHttpAdapter>)	已淘汰. 初始化 BotFrameworkHttpAdapter 類別的新執行個體。
BotFrameworkHttpAdapter(ICredentialProvider, AuthenticationConfiguration, IChannelProvider, RetryPolicy, HttpClient, IMiddleware, ILogger)	已淘汰. 使用認證提供者，初始化 BotFrameworkHttpAdapter 類別的新實例。
BotFrameworkHttpAdapter(ICredentialProvider, IChannelProvider, HttpClient, ILogger<BotFrameworkHttpAdapter>)	已淘汰. 使用認證提供者，初始化 BotFrameworkHttpAdapter 類別的新實例。
BotFrameworkHttpAdapter(ICredentialProvider, IChannelProvider, ILogger<BotFrameworkHttpAdapter>)	已淘汰. 使用認證提供者，初始化 BotFrameworkHttpAdapter 類別的新實例。

欄位

名稱	Description
BotIdentityKey	已淘汰. Bot 識別金鑰的字串值。 (繼承來源 BotAdapter)
InvokeResponseKey	已淘汰. 任何位於 TurnState 上的 InvokeResponseActivity 索引鍵值。 (繼承來源 BotAdapter)
OAuthScopeKey	已淘汰. OAuth 範圍密鑰的字串值。 (繼承來源 BotAdapter)

屬性

名稱	Description
AppCredentialMap	已淘汰. 它會取得這個轉接器應用程式的 AppCredentials 映射。 (繼承來源 BotFrameworkAdapter)
ChannelProvider	已淘汰. 取得這個配接器的通道提供者。 (繼承來源 BotFrameworkAdapter)
ClaimsIdentity	已淘汰. 取得或設定這個配接器的宣告識別。 (繼承來源 BotFrameworkHttpAdapterBase)
ConnectedBot	已淘汰. 取得或設定連線至這個配接器的 Bot。 (繼承來源 BotFrameworkHttpAdapterBase)
CredentialProvider	已淘汰. 取得這個配接器的認證提供者。 (繼承來源 BotFrameworkAdapter)
HttpClient	已淘汰. 如果有指定，我會取得這個轉接器的客製化 HttpClient 版本。 (繼承來源 BotFrameworkAdapter)
Logger	已淘汰. 取得這個配接器的記錄器。 (繼承來源 BotFrameworkAdapter)
MiddlewareSet	已淘汰. 取得配接器管線中的中間件集合。 (繼承來源 BotAdapter)
OnTurnError	已淘汰. 取得或設定錯誤處理程式，這個處理程式可以攔截中間件或應用程式中的例外狀況。 (繼承來源 BotAdapter)
RequestHandlers	已淘汰. 取得或設定這個配接器的要求處理程式。 (繼承來源 BotFrameworkHttpAdapterBase)

方法

名稱	Description
BuildCredentialsAsync(String, String)	已淘汰. 邏輯用來建立 AppCredentials 一個物件，用於取得此 HttpClient 的標記。 (繼承來源 BotFrameworkAdapter)
CanProcessOutgoingActivity(Activity)	已淘汰. 評估是否可能處理傳出活動。 (繼承來源 BotFrameworkHttpAdapterBase)
ConnectNamedPipeAsync(String, IBot, String)	已淘汰. 建立新的 StreamingRequestHandler 以接聽指定的命名管道，並將要求傳遞至此配接器。 (繼承來源 BotFrameworkHttpAdapterBase)
ContinueConversationAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)	已淘汰. 將主動式訊息傳送至交談。 (繼承來源 BotAdapter)
ContinueConversationAsync(ClaimsIdentity, Activity, String, BotCallbackHandler, CancellationToken)	已淘汰. 將主動式訊息傳送至交談。 (繼承來源 BotAdapter)
ContinueConversationAsync(ClaimsIdentity, ConversationReference, BotCallbackHandler, CancellationToken)	已淘汰. 將主動式訊息從 Bot 傳送至交談。 (繼承來源 BotFrameworkAdapter)
ContinueConversationAsync(ClaimsIdentity, ConversationReference, String, BotCallbackHandler, CancellationToken)	已淘汰. 將主動式訊息從 Bot 傳送至交談。 (繼承來源 BotFrameworkAdapter)
ContinueConversationAsync(String, Activity, BotCallbackHandler, CancellationToken)	已淘汰. 將主動式訊息傳送至交談。 (繼承來源 BotAdapter)
ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken)	已淘汰. 將主動式訊息從 Bot 傳送至交談。 (繼承來源 BotFrameworkAdapter)
CreateConversationAsync(String, String, AppCredentials, ConversationParameters, BotCallbackHandler, CancellationToken)	已淘汰. 在指定的通道上建立交談。 (繼承來源 BotFrameworkAdapter)
CreateConversationAsync(String, String, AppCredentials, ConversationParameters, BotCallbackHandler, ConversationReference, CancellationToken)	已淘汰. 在指定的通道上建立交談。多載會接收 ConversationReference，包括租使用者。 (繼承來源 BotFrameworkAdapter)
CreateConversationAsync(String, String, MicrosoftAppCredentials, ConversationParameters, BotCallbackHandler, CancellationToken)	已淘汰. 在指定的通道上建立交談。 (繼承來源 BotFrameworkAdapter)
CreateConversationAsync(String, String, MicrosoftAppCredentials, ConversationParameters, BotCallbackHandler, ConversationReference, CancellationToken)	已淘汰. 在指定的通道上建立交談。多載會接收 ConversationReference，包括租使用者。 (繼承來源 BotFrameworkAdapter)
CreateConversationAsync(String, String, String, String, ConversationParameters, BotCallbackHandler, CancellationToken)	已淘汰. 在指定的通道上建立交談。 (繼承來源 BotAdapter)
CreateOAuthApiClientAsync(ITurnContext, AppCredentials)	已淘汰. 使用認證建立 Bot 的 OAuth 用戶端。 (繼承來源 BotFrameworkAdapter)
CreateOAuthApiClientAsync(ITurnContext)	已淘汰. 建立 Bot 的 OAuth 用戶端。 (繼承來源 BotFrameworkAdapter)
CreateStreamingRequestHandler(IBot, WebSocket, String)	已淘汰. 建立 StreamingRequestHandler 一個新的 Web Socket 連線請求的處理。
DeleteActivityAsync(ITurnContext, ConversationReference, CancellationToken)	已淘汰. 刪除交談中的現有活動。 (繼承來源 BotFrameworkAdapter)
DeleteConversationMemberAsync(ITurnContext, String, CancellationToken)	已淘汰. 從目前的交談中移除成員。 (繼承來源 BotFrameworkAdapter)
Dispose()	已淘汰. 用來處理 Bot Framework HTTP 要求的 Bot Builder 配接器實作。 (繼承來源 BotFrameworkHttpAdapterBase)
Dispose(Boolean)	已淘汰. 分配資源 StreamingRequestHandler。 (繼承來源 BotFrameworkHttpAdapterBase)
ExchangeTokenAsync(ITurnContext, AppCredentials, String, String, TokenExchangeRequest, CancellationToken)	已淘汰. 執行令牌交換作業，例如單一登錄。 (繼承來源 BotFrameworkAdapter)
ExchangeTokenAsync(ITurnContext, String, String, TokenExchangeRequest, CancellationToken)	已淘汰. 執行令牌交換作業，例如單一登錄。 (繼承來源 BotFrameworkAdapter)
GetAadTokensAsync(ITurnContext, AppCredentials, String, String[], String, CancellationToken)	已淘汰. 使用自定義的 AppCredentials，擷取已設定連線上特定資源的 Azure Active Directory 令牌。 (繼承來源 BotFrameworkAdapter)
GetAadTokensAsync(ITurnContext, String, String[], String, CancellationToken)	已淘汰. 使用 Bot 的 AppCredentials，擷取已設定連線上特定資源的 Azure Active Directory 令牌。 (繼承來源 BotFrameworkAdapter)
GetActivityMembersAsync(ITurnContext, String, CancellationToken)	已淘汰. 列出指定活動的成員。 (繼承來源 BotFrameworkAdapter)
GetConversationMembersAsync(ITurnContext, CancellationToken)	已淘汰. 列出目前交談的成員。 (繼承來源 BotFrameworkAdapter)
GetConversationsAsync(ITurnContext, String, CancellationToken)	已淘汰. 列出此 Bot 參與指定通道伺服器的交談。通道伺服器以頁面形式回傳結果，每個頁面都會包含 `continuationToken` 可用來從伺服器取得下一頁結果的 (繼承來源 BotFrameworkAdapter)
GetConversationsAsync(String, MicrosoftAppCredentials, String, CancellationToken)	已淘汰. 列出此 Bot 參與指定通道伺服器的交談。通道伺服器以頁面形式回傳結果，每個頁面都會包含 `continuationToken` 可用來從伺服器取得下一頁結果的 (繼承來源 BotFrameworkAdapter)
GetOauthSignInLinkAsync(ITurnContext, AppCredentials, String, CancellationToken)	已淘汰. 使用自定義的 AppCredentials，取得要傳送給使用者以登入連線名稱的原始登入連結。 (繼承來源 BotFrameworkAdapter)
GetOauthSignInLinkAsync(ITurnContext, AppCredentials, String, String, String, CancellationToken)	已淘汰. 使用自定義的 AppCredentials，取得要傳送給使用者以登入連線名稱的原始登入連結。 (繼承來源 BotFrameworkAdapter)
GetOauthSignInLinkAsync(ITurnContext, String, CancellationToken)	已淘汰. 使用 Bot 的 AppCredentials，取得要傳送給使用者以登入連線名稱的原始登入連結。 (繼承來源 BotFrameworkAdapter)
GetOauthSignInLinkAsync(ITurnContext, String, String, String, CancellationToken)	已淘汰. 使用 Bot 的 AppCredentials，取得要傳送給使用者以登入連線名稱的原始登入連結。 (繼承來源 BotFrameworkAdapter)
GetSignInResourceAsync(ITurnContext, AppCredentials, String, String, String, CancellationToken)	已淘汰. 取得要傳送給使用者以登入以取得連線名稱的原始登入連結。 (繼承來源 BotFrameworkAdapter)
GetSignInResourceAsync(ITurnContext, String, CancellationToken)	已淘汰. 取得要傳送給使用者以登入以取得連線名稱的原始登入連結。 (繼承來源 BotFrameworkAdapter)
GetSignInResourceAsync(ITurnContext, String, String, String, CancellationToken)	已淘汰. 取得要傳送給使用者以登入以取得連線名稱的原始登入連結。 (繼承來源 BotFrameworkAdapter)
GetTokenStatusAsync(ITurnContext, AppCredentials, String, String, CancellationToken)	已淘汰. 使用自定義的AppCredentials，擷取指定使用者每個已設定連線的令牌狀態。 (繼承來源 BotFrameworkAdapter)
GetTokenStatusAsync(ITurnContext, String, String, CancellationToken)	已淘汰. 使用 Bot 的 AppCredentials，擷取指定使用者每個已設定連線的令牌狀態。 (繼承來源 BotFrameworkAdapter)
GetUserTokenAsync(ITurnContext, AppCredentials, String, String, CancellationToken)	已淘汰. 嘗試使用自定義的AppCredentials擷取登入流程中使用者的令牌。 (繼承來源 BotFrameworkAdapter)
GetUserTokenAsync(ITurnContext, String, String, CancellationToken)	已淘汰. 嘗試使用 Bot 的 AppCredentials 擷取登入流程中使用者的令牌。 (繼承來源 BotFrameworkAdapter)
ProcessActivityAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)	已淘汰. 建立回合內容，並執行傳入活動的中間件管線。 (繼承來源 BotFrameworkAdapter)
ProcessActivityAsync(String, Activity, BotCallbackHandler, CancellationToken)	已淘汰. 建立回合內容，並執行傳入活動的中間件管線。 (繼承來源 BotFrameworkAdapter)
ProcessAsync(HttpRequest, HttpResponse, IBot, CancellationToken)	已淘汰. 這個方法可以從任何控制器實作的POST方法內部呼叫。
ProcessOutgoingActivityAsync(ITurnContext, Activity, CancellationToken)	已淘汰. 傳送傳出活動。 (繼承來源 BotFrameworkHttpAdapterBase)
ProcessStreamingActivityAsync(Activity, BotCallbackHandler, CancellationToken)	已淘汰. 處理從串流通道傳送之活動的主要配接器方法。建立回合內容，並執行傳入活動的中間件管線。還會 ArgumentNullException 加入空參數。 (繼承來源 BotFrameworkHttpAdapterBase)
RunPipelineAsync(ITurnContext, BotCallbackHandler, CancellationToken)	已淘汰. 啟動目前 Bot 回合的活動處理。 (繼承來源 BotAdapter)
SendActivitiesAsync(ITurnContext, Activity[], CancellationToken)	已淘汰. 將活動傳送至交談。 (繼承來源 BotFrameworkAdapter)
SendStreamingActivityAsync(Activity, CancellationToken)	已淘汰. 傳送活動。 (繼承來源 BotFrameworkHttpAdapterBase)
SignOutUserAsync(ITurnContext, AppCredentials, String, String, CancellationToken)	已淘汰. 使用自定義的 AppCredentials，以令牌伺服器將用戶登出。 (繼承來源 BotFrameworkAdapter)
SignOutUserAsync(ITurnContext, String, String, CancellationToken)	已淘汰. 使用 Bot 的 AppCredentials，以令牌伺服器將用戶註銷。 (繼承來源 BotFrameworkAdapter)
UpdateActivityAsync(ITurnContext, Activity, CancellationToken)	已淘汰. 取代交談中的現有活動。 (繼承來源 BotFrameworkAdapter)
Use(IMiddleware)	已淘汰. 將中間件新增至配接器的管線。 (繼承來源 BotFrameworkAdapter)

明確介面實作

名稱	Description
IConnectorClientBuilder.CreateConnectorClientAsync(String, ClaimsIdentity, String, CancellationToken)	已淘汰. 用來處理 Bot Framework HTTP 要求的 Bot Builder 配接器實作。 (繼承來源 BotFrameworkAdapter)

擴充方法

名稱	Description
UseBotState(BotAdapter, BotState[])	已淘汰. 在轉接器中加入中介軟體，以便在回合上下文中註冊一個或多個 BotState 物件。中間件會在每次回合開始時，於回合內容上註冊狀態物件。
UseState(BotAdapter, UserState, ConversationState, Boolean)	已淘汰. 向配接器註冊用戶和交談狀態物件。這些物件將透過回合上下文的 TurnState.Get<T>() 方法提供。
UseStorage(BotAdapter, IStorage)	已淘汰. 在轉接器中加入中介軟體，以便在回合上下文中註冊 IStorage 物件。中間件會在每次回合開始時，於回合內容上註冊狀態物件。

適用於