Choices.Add メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
代替のセットに項目を追加します。
オーバーロード
| 名前 | 説明 |
|---|---|
| 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);
}
注釈
Choices、SemanticResultKey、およびSemanticResultValueオブジェクトからGrammarBuilderへの暗黙的な変換がサポートされているため、これらの 3 つのクラスは、Choices インスタンスにも追加できます。
alternateChoicesが空の配列の場合、このメソッドは代替のセットを更新しません。
アプリケーションでは、 Add(String[]) と Add(GrammarBuilder[]) の両方を使用して、 Choices オブジェクトに代替手段を追加できます。
このメソッドは、ArgumentNullExceptionがalternateChoicesされているか、配列要素のいずれかが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())
パラメーター
例
次の例では、"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が空の配列の場合、このメソッドは代替のセットを更新しません。
このメソッドは、ArgumentNullExceptionがphrasesされているか、配列要素のいずれかがnullされたときに、nullをスローします。 配列内の要素が空の文字列 ("") の場合、このメソッドは ArgumentException をスローします。