MessageFactory.SuggestedActions 方法

定义

命名空间:

Microsoft.Bot.Builder

程序集:

Microsoft.Bot.Builder.dll

包:

Microsoft.Bot.Builder v4.22.7

重载

SuggestedActions(IEnumerable<CardAction>, String, String, String)	返回一条消息，其中包含一组建议的操作和可选文本。
SuggestedActions(IEnumerable<String>, String, String, String)	返回一条消息，其中包含一组建议的操作和可选文本。
SuggestedActions(IEnumerable<CardAction>, String, String, String, IList<String>)	返回一条消息，其中包含一组建议的操作和可选文本。
SuggestedActions(IEnumerable<String>, String, String, String, IList<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 和 Title 的文本，并将 Type 设置为 ImBack。

另请参阅

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

SuggestedActions(IEnumerable<CardAction>, String, String, String, IList<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, System.Collections.Generic.IList<string> toList = default);

static member SuggestedActions : seq<Microsoft.Bot.Schema.CardAction> * string * string * string * System.Collections.Generic.IList<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, Optional toList As IList(Of String) = Nothing) As IMessageActivity

参数

cardActions

IEnumerable<CardAction>

要包括的卡片操作。

text

String

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

ssml

String

（可选）在启用了语音的通道上由机器人朗读的文本。

inputHint

String

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

toList

IList<String>

可选，收件人列表。

返回

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, IList<String>)

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

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

static member SuggestedActions : seq<string> * string * string * string * System.Collections.Generic.IList<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, Optional toList As IList(Of String) = Nothing) As IMessageActivity

参数

actions

IEnumerable<String>

要创建的操作的文本。

text

String

要发送的消息的文本。

ssml

String

（可选）在启用了语音的通道上由机器人朗读的文本。

inputHint

String

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

toList

IList<String>

可选，收件人列表。

返回

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 和 Title 的文本，并将 Type 设置为 ImBack。

另请参阅

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