Share via

Choices.Add メソッド

  • リファレンス

定義

名前空間:
System.Speech.Recognition
アセンブリ:
System.Speech.dll

代替のセットに項目を追加します。

オーバーロード

Add(GrammarBuilder[])

1 つ以上の GrammarBuilder オブジェクトを含む配列を代替のセットに追加します。
Add(String[])

1 つ以上の String オブジェクトを含む配列を代替のセットに追加します。

Add(GrammarBuilder[])

1 つ以上の 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 オブジェクト。

例

次の例では、"自分のセルでアンを呼び出す" や "勤務先の電話で 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);  
}

注釈

、およびSemanticResultValueオブジェクトGrammarBuilderからChoicesSemanticResultKeyへの暗黙的な変換がサポートされているため、これら 3 つのクラスもインスタンスにChoices追加できます。

空の配列の場合 alternateChoices 、このメソッドは代替のセットを更新しません。

アプリケーションでは、オブジェクトに代替手段を追加する両方Add(String[])Add(GrammarBuilder[])をChoices使用できます。

このメソッドは、 ArgumentNullException when alternateChoices または null いずれかの配列要素 nullをスローします。

こちらもご覧ください

適用対象

Add(String[])

1 つ以上の 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 オブジェクトに追加する文字列。

例

次の例では、"自分のセルでアンを呼び出す" と "自分の仕事用電話で 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 、このメソッドは代替のセットを更新しません。

このメソッドは、 ArgumentNullException when phrases または null いずれかの配列要素 nullをスローします。 このメソッドは、 ArgumentException 配列内の任意の要素が空の文字列 ("") である場合に、その要素をスローします。

こちらもご覧ください

適用対象