共用方式為


Choices.Add 方法

定義

將項目加入至選項組合。

多載

Add(GrammarBuilder[])

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

Add(String[])

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

Add(GrammarBuilder[])

來源:
Choices.cs
來源:
Choices.cs
來源:
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);  
}  

備註

由於支援從 ChoicesSemanticResultKeySemanticResultValue 物件到 GrammarBuilder 的隱含轉換,因此這三個 Choices 類別也可以新增至 實例。

如果 alternateChoices 是空陣列,這個方法不會更新一組替代專案。

應用程式可以使用 Add(String[])Add(GrammarBuilder[]) ,將替代專案新增至 Choices 物件。

這個方法會在 是 null 或任何陣列元素為 nullalternateChoices 擲回 ArgumentNullException

另請參閱

適用於

Add(String[])

來源:
Choices.cs
來源:
Choices.cs
來源:
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 或任何陣列元素為 nullphrases 擲回 ArgumentNullException 。 如果陣列中的任何專案是空字串 (「」) ,這個方法會 ArgumentException 擲回 。

另請參閱

適用於