ChannelServiceHandlerBase.OnGetConversationPagedMembersAsync 메서드

정의

네임스페이스:

Microsoft.Bot.Builder

어셈블리:

Microsoft.Bot.Builder.dll

패키지:

Microsoft.Bot.Builder v4.22.7

GetConversationPagedMembers() API for Skill.

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

봇에 대한 claimsIdentity에는 AudienceClaim, AppIdClaim 및 ServiceUrlClaim이 있어야 합니다.

conversationId

String

대화 ID입니다.

pageSize

Nullable<Int32>

제안된 페이지 크기입니다.

continuationToken

String

연속 토큰.

cancellationToken

CancellationToken

취소 토큰입니다.

반환

Task<PagedMembersResult>

응답에 대한 작업입니다.

설명

이 메서드를 재정의하여 대화의 멤버를 한 번에 한 페이지씩 열거합니다.

이 REST API는 ConversationId를 사용합니다. 필요에 따라 pageSize 및/또는 continuationToken을 제공할 수 있습니다. 대화의 멤버를 나타내는 ChannelAccounts 배열과 더 많은 값을 가져오는 데 사용할 수 있는 연속 토큰이 포함된 PagedMembersResult를 반환합니다.

각 호출과 함께 ChannelAccounts 레코드의 한 페이지가 반환됩니다. 페이지의 레코드 수는 채널과 호출마다 다를 수 있습니다. pageSize 매개 변수를 제안으로 사용할 수 있습니다. 추가 결과가 없으면 응답에 연속 토큰이 포함되지 않습니다. 대화에 멤버가 없으면 멤버가 비어 있거나 응답에 표시되지 않습니다.

이전 요청의 연속 토큰이 있는 요청에 대한 응답은 이전 요청의 멤버를 거의 반환하지 않을 수 있습니다.