Choices 类

定义

表示一组在语音识别语法约束的选择。

public ref class Choices
public class Choices
type Choices = class
Public Class Choices
继承
Choices

示例

以下示例为短语“将背景设置为 colorChoice”创建语音识别语法,其中 colorChoice 可以是定义的颜色之一。 GrammarBuilder用于定义语法的约束。

private Grammar CreateColorGrammar()  
{  

  // Create a Choices object that contains a set of alternative colors.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  colorChoice.Add(new string[] {"cyan", "yellow", "magenta"});  

  // Construct the phrase.  
  GrammarBuilder builder = new GrammarBuilder("Set background to");  
  builder.Append(colorChoice);  

  // Create a grammar for the phrase.  
  Grammar colorGrammar = new Grammar(builder);  
  colorGrammar.Name = "SetBackground";  

  return colorGrammar;  
}  

注解

对象 Choices 表示短语的一个组件,该短语可以具有多个值之一。 从 对象创建语音识别语法时, GrammarBuilder 请使用此类。

例如,对象 Choices 可以表示短语“将颜色更改为 colorChoice ”中的组件 colorChoice,其中 colorChoice 的可接受值为“红色”、“绿色”或“蓝色”。

注意

若要将 Choices 对象用作短语中的可选组件,请创建 Choices 对象,并将其 GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) 分别添加到 对象 minRepeat ,并将 maxRepeat 它分别设置为 0 和 1。 无论是否朗读可选组件,都可以识别包含可选组件的短语。

Choices提供与语音识别语法规范 (SRGS) 版本 1.0 定义的 XML 元素相同的函数one-of,并且类似于 SrgsOneOf 命名空间中的 System.Speech.Recognition.SrgsGrammar 类。

有关定义语音识别语法的详细信息,请参阅 语音识别

构造函数

Choices()

初始化包含空备选项集的 Choices 类的新实例。

Choices(GrammarBuilder[])

从包含一个或多个 Choices 对象数组初始化 GrammarBuilder 类的新实例。

Choices(String[])

从包含一个或多个 Choices 对象数组初始化 String 类的新实例。

方法

Add(GrammarBuilder[])

将包含一个或多个 GrammarBuilder 对象的数组添加到替代项组中。

Add(String[])

将包含一个或多个 String 对象的数组添加到替代项组中。

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type

(继承自 Object)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
ToGrammarBuilder()

GrammarBuilder 对象返回此 Choices 对象。

ToString()

返回表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅