Choices.Add 方法

定義

命名空間:

System.Speech.Recognition

組件:

System.Speech.dll

套件:

System.Speech v9.0.0-preview.3.24172.9

將項目加入至選項組合。

多載

Add(GrammarBuilder[])	將陣列（其中包含一或多個GrammarBuilder物件）加入至選項組合。
Add(String[])	將陣列（其中包含一或多個String物件）加入至選項組合。

Add(GrammarBuilder[])

來源:

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 物件。

範例

下列範例會為片語建立語音辨識文法，例如「Call Anne on her cell」 和 「Call James on his work phone」。 此範例會使用 方法的 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 或任何陣列元素為 null 時 alternateChoices 擲回 ArgumentNullException 。

另請參閱

• GrammarBuilder
• Grammar

Add(String[])

來源:

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 或任何陣列元素為 null 時 phrases 擲回 ArgumentNullException 。 如果陣列中的任何專案是空字串 (「」) ，這個方法會 ArgumentException 擲回 。

另請參閱

• Grammar
• GrammarBuilder