ChannelServiceHandlerBase.OnGetConversationPagedMembersAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
GetConversationPagedMembers() 技能 API。
protected virtual System.Threading.Tasks.Task<Microsoft.Bot.Schema.PagedMembersResult> OnGetConversationPagedMembersAsync(System.Security.Claims.ClaimsIdentity claimsIdentity, string conversationId, int? pageSize = default, string continuationToken = default, System.Threading.CancellationToken cancellationToken = default);
abstract member OnGetConversationPagedMembersAsync : System.Security.Claims.ClaimsIdentity * string * Nullable<int> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.PagedMembersResult>
override this.OnGetConversationPagedMembersAsync : System.Security.Claims.ClaimsIdentity * string * Nullable<int> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Bot.Schema.PagedMembersResult>
Protected Overridable Function OnGetConversationPagedMembersAsync (claimsIdentity As ClaimsIdentity, conversationId As String, Optional pageSize As Nullable(Of Integer) = Nothing, Optional continuationToken As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of PagedMembersResult)
參數
- claimsIdentity
- ClaimsIdentity
bot 的 claimsIdentity 應該具有 AudienceClaim、AppIdClaim 和 ServiceUrlClaim。
- conversationId
- String
交談識別碼。
- continuationToken
- String
接續令牌。
- cancellationToken
- CancellationToken
取消權杖。
傳回
回應的工作。
備註
覆寫此方法,以一次列舉一頁交談的成員。
此 REST API 會採用 ConversationId。 您可以選擇提供 pageSize 和/或 continuationToken。 它會傳回 PagedMembersResult,其中包含 ChannelAccounts 陣列,代表交談的成員和可用來取得更多值的接續令牌。
每個呼叫都會傳回 ChannelAccounts 記錄的一頁。 頁面中的記錄數目可能會因通道和呼叫而有所不同。 pageSize 參數可用來做為建議。 如果沒有其他結果,回應將不會包含接續令牌。 如果交談中沒有任何成員,則成員在回應中將會是空的或不存在的。
對先前要求具有接續令牌的要求回應,可能很少會從先前的要求傳回成員。