Choices.Add 方法

定义

命名空间:

System.Speech.Recognition

程序集:

System.Speech.dll

包:

System.Speech v9.0.0

将项添加到替代项组中。

重载

Add(GrammarBuilder[])	将包含一个或多个 GrammarBuilder 对象的数组添加到替代项组中。
Add(String[])	将包含一个或多个 String 对象的数组添加到替代项组中。

Add(GrammarBuilder[])

Source:

Choices.cs

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

public:
 void Add(... cli::array <System::Speech::Recognition::GrammarBuilder ^> ^ alternateChoices);

public void Add (params System.Speech.Recognition.GrammarBuilder[] alternateChoices);

member this.Add : System.Speech.Recognition.GrammarBuilder[] -> unit

Public Sub Add (ParamArray alternateChoices As GrammarBuilder())

参数

alternateChoices

GrammarBuilder[]

要添加到 GrammarBuilder 对象中的 Choices 对象。

示例

以下示例为诸如“在单元格上呼叫 Anne”和“使用工作电话呼叫 James”等短语创建语音识别语法。 该示例使用 方法的两个 Add 重载来生成语法。

public Grammar CreatePhonePhrase()  
{  

  // Create alternatives for female names and add a phrase.  
  GrammarBuilder females = new Choices(new string[] { "Anne", "Mary" });  
  females.Append("on her");  

  // Create alternatives for male names and add a phrase.  
  GrammarBuilder males = new Choices(new string[] { "James", "Sam" });  
  males.Append("on his");  

  // Create a Choices object that contains an array of alternative  
  // GrammarBuilder objects.  
  Choices people = new Choices();  
  people.Add(new Choices(new GrammarBuilder[] {females, males}));  

  // Create a Choices object that contains a set of alternative phone types.  
  Choices phoneType = new Choices();  
  phoneType.Add(new string[] { "cell", "home", "work" });  

  // Construct the phrase.  
  GrammarBuilder gb = new GrammarBuilder();  
  gb.Append("call");  
  gb.Append(people);  
  gb.Append(phoneType);  
  gb.Append(new GrammarBuilder("phone"), 0, 1);  

  return new Grammar(gb);  
}  

注解

由于支持从 Choices、 SemanticResultKey和 SemanticResultValue 对象隐 GrammarBuilder式转换为 ，这三个 Choices 类也可能添加到 实例。

如果 alternateChoices 是空数组，则此方法不会更新替代项集。

应用程序可以使用 Add(String[]) 和 Add(GrammarBuilder[]) 将替代项添加到 Choices 对象。

当 为 null 或任一ArgumentNullException数组元素为 null时alternateChoices，此方法将引发 。

另请参阅

• GrammarBuilder
• Grammar

Add(String[])

Source:

Choices.cs

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

public:
 void Add(... cli::array <System::String ^> ^ phrases);

public void Add (params string[] phrases);

member this.Add : string[] -> unit

Public Sub Add (ParamArray phrases As String())

参数

phrases

String[]

要添加到该Choices对象的字符串。

示例

以下示例为类似于“在单元格上呼叫 Anne”和“在其工作电话上呼叫 James”的短语创建语音识别语法。 该示例使用 方法的两个 Add 重载来生成语法。

public Grammar CreatePhonePhrase()  
{  

  // Create alternatives for female names and add a phrase.  
  GrammarBuilder females = new Choices(new string[] { "Anne", "Mary" });  
  females.Append("on her");  

  // Create alternatives for male names and add a phrase.  
  GrammarBuilder males = new Choices(new string[] { "James", "Sam" });  
  males.Append("on his");  

  // Create a Choices object that contains an array of alternative  
  // GrammarBuilder objects.  
  Choices people = new Choices();  
  people.Add(new Choices(new GrammarBuilder[] {females, males}));  

  // Create a Choices object that contains a set of alternative phone types.  
  Choices phoneType = new Choices();  
  phoneType.Add(new string[] { "cell", "home", "work" });  

  // Construct the phrase.  
  GrammarBuilder gb = new GrammarBuilder();  
  gb.Append("call");  
  gb.Append(people);  
  gb.Append(phoneType);  
  gb.Append(new GrammarBuilder("phone"), 0, 1);  

  return new Grammar(gb);  
}  

注解

应用程序可以使用 Add(String[]) 和 Add(GrammarBuilder[]) 将替代项添加到 Choices 对象。

如果 phrases 是空数组，则此方法不会更新备用项集。

当 为 null 或任一ArgumentNullException数组元素为 null时phrases，此方法将引发 。 如果数组中的任何元素是空字符串 (“”) ，则此方法将引发 ArgumentException 。

另请参阅

• Grammar
• GrammarBuilder