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
ContentType |
De HTTP- |
Eigenschappen
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 |
Hiermee wordt een tekenreeks opgehaald of ingesteld die aangeeft of uw bot gebruikersinvoer accepteert, verwacht of negeert nadat het bericht aan de client is bezorgd (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 |
Hiermee worden eigenschappen opgehaald of ingesteld die niet anders zijn gedefinieerd door het Activity type, maar die kunnen worden weergegeven 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 |
Hiermee haalt u een ConversationReference op of stelt u deze in op een ander gesprek of een andere activiteit. |
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
ApplyConversationReference(ConversationReference, Boolean) |
Hiermee wordt deze activiteit bijgewerkt met de leveringsgegevens van een bestaande ConversationReference. |
AsCommandActivity() |
Retourneert deze activiteit als een ICommandActivity-object; of null, als dit niet het type activiteit is. |
AsCommandResultActivity() |
Retourneert deze activiteit als een ICommandResultActivity-object; of null, als dit niet het type activiteit is. |
AsContactRelationUpdateActivity() |
Retourneert deze activiteit als een IContactRelationUpdateActivity-object; of null, als dit niet het type activiteit is. |
AsConversationUpdateActivity() |
Retourneert deze activiteit als een IConversationUpdateActivity-object; of null, als dit niet het type activiteit is. |
AsEndOfConversationActivity() |
Retourneert deze activiteit als een IEndOfConversationActivity-object; of null, als dit niet het type activiteit is. |
AsEventActivity() |
Retourneert deze activiteit als een IEventActivity-object; of null, als dit niet het type activiteit is. |
AsHandoffActivity() |
Retourneert deze activiteit als een IHandoffActivity-object; of null, als dit niet het type activiteit is. |
AsInstallationUpdateActivity() |
Retourneert deze activiteit als een IInstallationUpdateActivity-object; of null, als dit niet het type activiteit is. |
AsInvokeActivity() |
Retourneert deze activiteit als een IInvokeActivity-object; of null, als dit niet het type activiteit is. |
AsMessageActivity() |
Retourneert deze activiteit als een IMessageActivity-object; of null, als dit niet het type activiteit is. |
AsMessageDeleteActivity() |
Retourneert deze activiteit als een IMessageDeleteActivity-object; of null, als dit niet het type activiteit is. |
AsMessageReactionActivity() |
Retourneert deze activiteit als een IMessageReactionActivity-object; of null, als dit niet het type activiteit is. |
AsMessageUpdateActivity() |
Retourneert deze activiteit als een IMessageUpdateActivity-object; of null, als dit niet het type activiteit is. |
AsSuggestionActivity() |
Retourneert deze activiteit als een ISuggestionActivity-object; of null, als dit niet het type activiteit is. |
AsTraceActivity() |
Retourneert deze activiteit als een ITraceActivity-object; of null, als dit niet het type activiteit is. |
AsTypingActivity() |
Retourneert deze activiteit als een ITypingActivity-object; of null, als dit niet het type activiteit is. |
CreateContactRelationUpdateActivity() |
Hiermee maakt u een exemplaar van de Activity-klasse als een IContactRelationUpdateActivity-object. |
CreateConversationUpdateActivity() |
Hiermee maakt u een exemplaar van de Activity-klasse als een IConversationUpdateActivity-object. |
CreateEndOfConversationActivity() |
Hiermee maakt u een exemplaar van de Activity-klasse als een IEndOfConversationActivity-object. |
CreateEventActivity() |
Hiermee maakt u een exemplaar van de Activity-klasse als een IEventActivity-object. |
CreateHandoffActivity() |
Hiermee maakt u een exemplaar van de Activity-klasse als een IHandoffActivity-object. |
CreateInvokeActivity() |
Hiermee maakt u een exemplaar van de Activity-klasse als een IInvokeActivity-object. |
CreateMessageActivity() |
Hiermee maakt u een exemplaar van de Activity-klasse als een IMessageActivity-object. |
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) |
Hiermee maakt u een exemplaar van de Activity-klasse als een ITraceActivity-object. |
CreateTypingActivity() |
Hiermee maakt u een exemplaar van de Activity-klasse als een ITypingActivity-object. |
GetChannelData<TypeT>() |
Hiermee haalt u de kanaalgegevens voor deze activiteit op als een sterk getypt object. |
GetConversationReference() |
Hiermee maakt u 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
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. |
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. Als het bericht bijvoorbeeld @echoBot Hallo bot, wordt '@echoBot' verwijderd, waardoor 'Hi Bot' wordt verlaten. |
RemoveRecipientMention(IMessageActivity) |
Verwijder tekst van geadresseerde vermelding uit de eigenschap Tekst. Wees voorzichtig omdat deze functie de tekst van de activiteit wijzigt. |
GetLocale(IActivity) |
Hiermee haalt u de landinstelling voor de activiteit op. |
SetLocale(IActivity, String) |
Hiermee stelt u de landinstelling voor de activiteit in. |