Activity Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Een activiteit is het basiscommunicatietype voor het Bot Framework 3.0-protocol.
public class Activity : Microsoft.Bot.Schema.ICommandActivity, Microsoft.Bot.Schema.ICommandResultActivity, Microsoft.Bot.Schema.IContactRelationUpdateActivity, Microsoft.Bot.Schema.IConversationUpdateActivity, Microsoft.Bot.Schema.IEndOfConversationActivity, Microsoft.Bot.Schema.IEventActivity, Microsoft.Bot.Schema.IHandoffActivity, Microsoft.Bot.Schema.IInstallationUpdateActivity, Microsoft.Bot.Schema.IInvokeActivity, Microsoft.Bot.Schema.IMessageDeleteActivity, Microsoft.Bot.Schema.IMessageReactionActivity, Microsoft.Bot.Schema.IMessageUpdateActivity, Microsoft.Bot.Schema.ISuggestionActivity, Microsoft.Bot.Schema.ITraceActivity, Microsoft.Bot.Schema.ITypingActivity
type Activity = class
interface IActivity
interface IConversationUpdateActivity
interface IContactRelationUpdateActivity
interface IInstallationUpdateActivity
interface IMessageActivity
interface IMessageUpdateActivity
interface IMessageDeleteActivity
interface IMessageReactionActivity
interface ISuggestionActivity
interface ITypingActivity
interface IEndOfConversationActivity
interface IEventActivity
interface IInvokeActivity
interface ITraceActivity
interface IHandoffActivity
interface ICommandActivity
interface ICommandResultActivity
Public Class Activity
Implements ICommandActivity, ICommandResultActivity, IContactRelationUpdateActivity, IConversationUpdateActivity, IEndOfConversationActivity, IEventActivity, IHandoffActivity, IInstallationUpdateActivity, IInvokeActivity, IMessageDeleteActivity, IMessageReactionActivity, IMessageUpdateActivity, ISuggestionActivity, ITraceActivity, ITypingActivity
- Overname
-
Activity
- Implementeringen
-
IActivity ICommandActivity ICommandResultActivity IContactRelationUpdateActivity IConversationUpdateActivity IEndOfConversationActivity IEventActivity IHandoffActivity IInstallationUpdateActivity IInvokeActivity IMessageActivity IMessageDeleteActivity IMessageReactionActivity IMessageUpdateActivity ISuggestionActivity ITraceActivity ITypingActivity
Opmerkingen
De activiteitsklasse bevat alle eigenschappen die afzonderlijke, specifiekere activiteiten kunnen bevatten. Het is een supersettype.
Constructors
Velden
| Name | Description |
|---|---|
| ContentType |
De HTTP-entiteitsheader |
Eigenschappen
| Name | Description |
|---|---|
| Action |
Hiermee wordt een tekenreeks opgehaald of ingesteld die aangeeft of de ontvanger van een contactRelationUpdate is toegevoegd aan of verwijderd uit de lijst met contactpersonen van de afzender. |
| AttachmentLayout |
Hiermee haalt u de lay-outhint voor meerdere bijlagen op of stelt u deze in. Standaard: lijst. Mogelijke waarden worden gedefinieerd door AttachmentLayoutTypes. |
| Attachments |
Hiermee haalt u de bijlagen voor de activiteit op of stelt u deze in. |
| CallerId |
Hiermee haalt u een tekenreeks op die een IRI bevat die de aanroeper van een bot identificeert. Dit veld is niet bedoeld om via de kabel te worden verzonden, maar wordt in plaats daarvan gevuld door bots en clients op basis van cryptografisch verifieerbare gegevens die de identiteit van de bellers (bijvoorbeeld tokens) bevestigen. |
| ChannelData |
Hiermee haalt u kanaalspecifieke inhoud op of stelt u deze in. |
| ChannelId |
Hiermee haalt u een id op waarmee het kanaal uniek wordt geïdentificeerd of ingesteld. Ingesteld door het kanaal. |
| Code |
Hiermee haalt u een code op voor endOfConversation-activiteiten die aangeeft waarom het gesprek is beëindigd. Mogelijke waarden worden gedefinieerd in EndOfConversationCodes. |
| Conversation |
Hiermee haalt u het gesprek op waartoe de activiteit behoort of stelt u deze in. |
| DeliveryMode |
Hiermee haalt u een bezorgingshint op of stelt u een signaal in voor de alternatieve bezorgingspaden van de ontvanger voor de activiteit. De standaardleveringsmodus is 'standaard'. Mogelijke waarden worden gedefinieerd in DeliveryModes. |
| Entities |
Hiermee haalt u de entiteiten op die in het bericht zijn vermeld of stelt u deze in. |
| Expiration |
Hiermee wordt het tijdstip opgehaald of ingesteld waarop de activiteit moet worden beschouwd als 'verlopen' en mag deze niet aan de ontvanger worden gepresenteerd. |
| From |
Hiermee haalt u de afzender van het bericht op of stelt u deze in. |
| HistoryDisclosed |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de eerdere geschiedenis van het kanaal wordt bekendgemaakt. |
| Id |
Hiermee haalt u een id op waarmee de activiteit op het kanaal uniek wordt geïdentificeerd of ingesteld. |
| Importance |
Hiermee haalt u het belang van de activiteit op of stelt u deze in. Mogelijke waarden worden gedefinieerd in ActivityImportance. |
| InputHint |
Krijgt of stelt een string op die aangeeft of je bot gebruikersinvoer accepteert, verwacht of negeert nadat het bericht aan de client is afgeleverd (zie InputHints. |
| Label |
Hiermee wordt een beschrijvend label voor de activiteit ophaalt of ingesteld. |
| ListenFor |
Hiermee haalt of stelt u een lijst met woordgroepen en verwijzingen op waarnaar spraak- en taalinstellingen moeten luisteren. |
| Locale |
Hiermee wordt de naam van een BCP-47-landinstelling opgehaald of ingesteld voor de inhoud van het tekstveld. |
| LocalTimestamp |
Hiermee wordt de datum en tijd opgehaald of ingesteld waarop het bericht is verzonden, in lokale tijd, uitgedrukt in ISO-8601-indeling. Bijvoorbeeld 2016-09-23T13:07:49.4714686-07:00. |
| LocalTimezone |
Hiermee haalt u de naam op van de tijdzone die wordt gebruikt om de lokale tijd voor het bericht te definiëren, uitgedrukt in de IANA Time Zone-databaseindeling. Bijvoorbeeld Amerika/Los_Angeles. |
| MembersAdded |
Hiermee haalt u de verzameling leden op die aan het gesprek zijn toegevoegd of stelt u deze in. |
| MembersRemoved |
Hiermee wordt de verzameling leden opgehaald of ingesteld die uit het gesprek zijn verwijderd. |
| Name |
Hiermee haalt u de naam op van de bewerking die is gekoppeld aan een aanroep- of gebeurtenisactiviteit. |
| Properties |
Krijgt of stelt eigenschappen die verder niet door het Activity type worden gedefinieerd, maar die wel kunnen voorkomen in het geserialiseerde REST JSON-object. |
| ReactionsAdded |
Hiermee haalt u de verzameling reacties op die aan het gesprek zijn toegevoegd of stelt u deze in. |
| ReactionsRemoved |
Hiermee wordt de verzameling reacties opgehaald of ingesteld die uit het gesprek zijn verwijderd. |
| Recipient |
Hiermee haalt u de geadresseerde van het bericht op of stelt u deze in. |
| RelatesTo |
Krijgt of zet een ConversationReference andere conversatie of activiteit op. |
| ReplyToId |
Hiermee haalt u de id op van het bericht waarop dit bericht een antwoord is of stelt u deze in. |
| SemanticAction |
Hiermee haalt u een optionele programmatische actie op die bij deze aanvraag hoort. |
| ServiceUrl |
Hiermee haalt u de URL op waarmee het service-eindpunt van het kanaal wordt opgegeven. Ingesteld door het kanaal. |
| Speak |
Hiermee haalt u de tekst op of stelt u deze in om te spreken. |
| SuggestedActions |
Hiermee haalt u de voorgestelde acties voor de activiteit op of stelt u deze in. |
| Summary |
Hiermee wordt de tekst opgevraagd of ingesteld om weer te geven als het kanaal geen kaarten kan weergeven. |
| Text |
Hiermee haalt u de tekstinhoud van het bericht op of stelt u deze in. |
| TextFormat |
Hiermee haalt u de notatie van tekstvelden op of stelt u deze in. Standaard: markdown. Mogelijke waarden worden gedefinieerd door TextFormatTypes. |
| TextHighlights |
Hiermee wordt de verzameling tekstfragmenten opgehaald of ingesteld om te markeren wanneer de activiteit een ReplyToId-waarde bevat. |
| Timestamp |
Hiermee wordt de datum en tijd opgehaald of ingesteld waarop het bericht is verzonden, in UTC, uitgedrukt in ISO-8601-indeling. |
| TopicName |
Hiermee haalt u de bijgewerkte onderwerpnaam van het gesprek op of stelt u deze in. |
| Type |
Hiermee haalt u het activiteitstype op of stelt u dit in. Mogelijke waarden zijn: 'message', 'contactRelationUpdate', 'conversationUpdate', 'typing', 'endOfConversation', 'event', 'invoke', 'deleteUserData', 'messageUpdate', 'messageDelete', 'installationUpdate', 'messageReaction', 'suggestion', 'trace', 'handoff'. |
| Value |
Hiermee wordt een waarde opgehaald of ingesteld die is gekoppeld aan de activiteit. |
| ValueType |
Hiermee wordt het type waardeobject van de activiteit opgehaald of ingesteld. |
Methoden
| Name | Description |
|---|---|
| ApplyConversationReference(ConversationReference, Boolean) |
Werkt deze activiteit bij met de leveringsinformatie van een bestaande ConversationReference. |
| AsCommandActivity() |
Geeft deze activiteit terug als object ICommandActivity ; of null, als dit niet dat type activiteit is. |
| AsCommandResultActivity() |
Geeft deze activiteit terug als object ICommandResultActivity ; of null, als dit niet dat type activiteit is. |
| AsContactRelationUpdateActivity() |
Geeft deze activiteit terug als object IContactRelationUpdateActivity ; of null, als dit niet dat type activiteit is. |
| AsConversationUpdateActivity() |
Geeft deze activiteit terug als object IConversationUpdateActivity ; of null, als dit niet dat type activiteit is. |
| AsEndOfConversationActivity() |
Geeft deze activiteit terug als object IEndOfConversationActivity ; of null, als dit niet dat type activiteit is. |
| AsEventActivity() |
Geeft deze activiteit terug als object IEventActivity ; of null, als dit niet dat type activiteit is. |
| AsHandoffActivity() |
Geeft deze activiteit terug als object IHandoffActivity ; of null, als dit niet dat type activiteit is. |
| AsInstallationUpdateActivity() |
Geeft deze activiteit terug als object IInstallationUpdateActivity ; of null, als dit niet dat type activiteit is. |
| AsInvokeActivity() |
Geeft deze activiteit terug als object IInvokeActivity ; of null, als dit niet dat type activiteit is. |
| AsMessageActivity() |
Geeft deze activiteit terug als object IMessageActivity ; of null, als dit niet dat type activiteit is. |
| AsMessageDeleteActivity() |
Geeft deze activiteit terug als object IMessageDeleteActivity ; of null, als dit niet dat type activiteit is. |
| AsMessageReactionActivity() |
Geeft deze activiteit terug als object IMessageReactionActivity ; of null, als dit niet dat type activiteit is. |
| AsMessageUpdateActivity() |
Geeft deze activiteit terug als object IMessageUpdateActivity ; of null, als dit niet dat type activiteit is. |
| AsSuggestionActivity() |
Geeft deze activiteit terug als object ISuggestionActivity ; of null, als dit niet dat type activiteit is. |
| AsTraceActivity() |
Geeft deze activiteit terug als object ITraceActivity ; of null, als dit niet dat type activiteit is. |
| AsTypingActivity() |
Geeft deze activiteit terug als object ITypingActivity ; of null, als dit niet dat type activiteit is. |
| CreateContactRelationUpdateActivity() |
Maakt een instantie van de Activity klasse aan als object IContactRelationUpdateActivity . |
| CreateConversationUpdateActivity() |
Maakt een instantie van de Activity klasse aan als object IConversationUpdateActivity . |
| CreateEndOfConversationActivity() |
Maakt een instantie van de Activity klasse aan als object IEndOfConversationActivity . |
| CreateEventActivity() |
Maakt een instantie van de Activity klasse aan als object IEventActivity . |
| CreateHandoffActivity() |
Maakt een instantie van de Activity klasse aan als object IHandoffActivity . |
| CreateInvokeActivity() |
Maakt een instantie van de Activity klasse aan als object IInvokeActivity . |
| CreateMessageActivity() |
Maakt een instantie van de Activity klasse aan als object IMessageActivity . |
| CreateReply(String, String) |
Hiermee maakt u een nieuwe berichtactiviteit als reactie op deze activiteit. |
| CreateTrace(String, Object, String, String) |
Hiermee maakt u een nieuwe traceringsactiviteit op basis van deze activiteit. |
| CreateTraceActivity(String, String, Object, String) |
Maakt een instantie van de Activity klasse aan als object ITraceActivity . |
| CreateTypingActivity() |
Maakt een instantie van de Activity klasse aan als object ITypingActivity . |
| GetChannelData<TypeT>() |
Hiermee haalt u de kanaalgegevens voor deze activiteit op als een sterk getypt object. |
| GetConversationReference() |
Maakt een ConversationReference op basis van deze activiteit. |
| GetMentions() |
Hiermee worden de vermeldingen van de entiteiten van deze activiteit omgezet. |
| GetReplyConversationReference(ResourceResponse) |
Maak een ConversationReference op basis van de gespreksgegevens van deze activiteit en de ResourceResponse van het verzenden van een activiteit. |
| HasContent() |
Geeft aan of deze activiteit inhoud heeft. |
| IsActivity(String) |
Geeft aan of deze activiteit van een opgegeven activiteitstype is. |
| IsFromStreamingConnection() |
Bepaal of de activiteit is verzonden via een Http/Https-verbinding of streaming. Dit kan worden bepaald door de eigenschap ServiceUrl te bekijken: (1) Alle kanalen die berichten verzenden via http/https, streamen niet (2) Kanalen die berichten verzenden via streaming, hebben een ServiceUrl die niet begint met http/https. |
| TryGetChannelData<TypeT>(TypeT) |
Hiermee haalt u de kanaalgegevens voor deze activiteit op als een sterk getypt object. Een retourwaarde geeft aan of de bewerking is geslaagd. |
Extensiemethoden
| Name | Description |
|---|---|
| GetLocale(IActivity) |
Hiermee haalt u de landinstelling voor de activiteit op. |
| MentionsId(IMessageActivity, String) |
Is er een vermelding van de id in de teksteigenschap. |
| MentionsRecipient(IMessageActivity) |
Is er een vermelding van Recipient.Id in de eigenschap Tekst. |
| RemoveMentionText(IMessageActivity, String) |
Verwijder alle vermeldingstekst voor de opgegeven id uit de eigenschap Activity.Text. Bijvoorbeeld, gegeven het bericht @echoBot Hi Bot, verwijdert dit "@echoBot", waardoor "Hi Bot" overblijft. |
| RemoveRecipientMention(IMessageActivity) |
Verwijder tekst van geadresseerde vermelding uit de eigenschap Tekst. Wees voorzichtig omdat deze functie de tekst van de activiteit wijzigt. |
| SetLocale(IActivity, String) |
Hiermee stelt u de landinstelling voor de activiteit in. |
| TeamsGetChannelId(IActivity) |
Hiermee haalt u de kanaal-id van het team op uit de huidige activiteit. |
| TeamsGetMeetingInfo(IActivity) |
Hiermee haalt u het TeamsMeetingInfo-object op van de huidige activiteit. |
| TeamsGetSelectedChannelId(IActivity) |
Hiermee haalt u de geselecteerde kanaal-id van het team op uit de huidige activiteit. |
| TeamsGetTeamInfo(IActivity) |
Hiermee haalt u het TeamsInfo-object op van de huidige activiteit. |
| TeamsGetTeamOnBehalfOf(IActivity) |
Hiermee haalt u de lijst Teams OnBehalfOf op uit de huidige activiteit. |
| TeamsNotifyUser(IActivity, Boolean, String) |
Hiermee configureert u de huidige activiteit om een melding te genereren in Teams. |
| TeamsNotifyUser(IActivity) |
Hiermee configureert u de huidige activiteit om een melding te genereren in Teams. |