MessageFactory.SuggestedActions 方法

定义

命名空间:

Microsoft.Bot.Builder

程序集:

Microsoft.Bot.Builder.dll

包:

Microsoft.Bot.Builder v4.18.1

重载

SuggestedActions(IEnumerable<CardAction>, String, String, String)	返回一条消息，其中包含一组建议的操作和可选文本。
SuggestedActions(IEnumerable<String>, String, String, String)	返回一条消息，其中包含一组建议的操作和可选文本。

SuggestedActions(IEnumerable<CardAction>, String, String, String)

返回一条消息，其中包含一组建议的操作和可选文本。

public static Microsoft.Bot.Schema.IMessageActivity SuggestedActions (System.Collections.Generic.IEnumerable<Microsoft.Bot.Schema.CardAction> cardActions, string text = default, string ssml = default, string inputHint = default);

static member SuggestedActions : seq<Microsoft.Bot.Schema.CardAction> * string * string * string -> Microsoft.Bot.Schema.IMessageActivity

Public Shared Function SuggestedActions (cardActions As IEnumerable(Of CardAction), Optional text As String = Nothing, Optional ssml As String = Nothing, Optional inputHint As String = Nothing) As IMessageActivity

参数

cardActions

IEnumerable<CardAction>

要包括卡操作。

text

String

可选，要发送的消息的文本。

ssml

String

（可选）机器人在支持语音的通道上朗读的文本。

inputHint

String

可选，指示机器人在将消息传递到客户端后是接受、期望还是忽略用户输入。 其中之一：“acceptingInput”、“ignoringInput”或“expectingInput”。 默认值为“acceptingInput”。

返回

IMessageActivity

包含建议操作的消息活动。

例外

ArgumentNullException

cardActions 为 null。

示例

// Create the activity and add suggested actions.
var activity = MessageFactory.SuggestedActions(
    new CardAction[]
    {
        new CardAction(title: "red", type: ActionTypes.ImBack, value: "red"),
        new CardAction( title: "green", type: ActionTypes.ImBack, value: "green"),
        new CardAction(title: "blue", type: ActionTypes.ImBack, value: "blue")
    }, text: "Choose a color");

// Send the activity as a reply to the user.
await context.SendActivity(activity);

另请参阅

• SuggestedActions(IEnumerable<String>, String, String, String)

SuggestedActions(IEnumerable<String>, String, String, String)

返回一条消息，其中包含一组建议的操作和可选文本。

public static Microsoft.Bot.Schema.IMessageActivity SuggestedActions (System.Collections.Generic.IEnumerable<string> actions, string text = default, string ssml = default, string inputHint = default);

static member SuggestedActions : seq<string> * string * string * string -> Microsoft.Bot.Schema.IMessageActivity

Public Shared Function SuggestedActions (actions As IEnumerable(Of String), Optional text As String = Nothing, Optional ssml As String = Nothing, Optional inputHint As String = Nothing) As IMessageActivity

参数

actions

IEnumerable<String>

要创建的操作的文本。

text

String

要发送的消息的文本。

ssml

String

（可选）机器人在支持语音的通道上朗读的文本。

inputHint

String

可选，指示机器人在将消息传递到客户端后是接受、期望还是忽略用户输入。 其中之一：“acceptingInput”、“ignoringInput”或“expectingInput”。 默认值为“acceptingInput”。

返回

IMessageActivity

包含建议操作的消息活动。

例外

ArgumentNullException

actions 为 null。

示例

// Create the activity and add suggested actions.
var activity = MessageFactory.SuggestedActions(
    new string[] { "red", "green", "blue" },
    text: "Choose a color");

// Send the activity as a reply to the user.
await context.SendActivity(activity);

注解

此方法为 中的每个 actions字符串创建建议的操作。 创建的 操作使用 和 的文本，Value并将 设置为 ImBackType 。Title

另请参阅

• SuggestedActions(IEnumerable<CardAction>, String, String, String)