Choices.Add メソッド

定義

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

オーバーロード

名前 説明
Add(GrammarBuilder[])

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

Add(String[])

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

Add(GrammarBuilder[])

ソース:
Choices.cs
ソース:
Choices.cs
ソース:
Choices.cs
ソース:
Choices.cs

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 オブジェクト。

次の例では、"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);
}

注釈

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

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

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

このメソッドは、ArgumentNullExceptionalternateChoicesされているか、配列要素のいずれかがnullされたときに、nullをスローします。

こちらもご覧ください

適用対象

Add(String[])

ソース:
Choices.cs
ソース:
Choices.cs
ソース:
Choices.cs
ソース:
Choices.cs

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

次の例では、"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);
}

注釈

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

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

このメソッドは、ArgumentNullExceptionphrasesされているか、配列要素のいずれかがnullされたときに、nullをスローします。 配列内の要素が空の文字列 ("") の場合、このメソッドは ArgumentException をスローします。

こちらもご覧ください

適用対象