Choices.Add Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt der Gruppe von Alternativen Elemente hinzu.
Überlädt
| Name | Beschreibung |
|---|---|
| Add(GrammarBuilder[]) |
Fügt dem Satz von Alternativen ein Array hinzu, das mindestens ein GrammarBuilder Objekt enthält. |
| Add(String[]) |
Fügt dem Satz von Alternativen ein Array hinzu, das mindestens ein String Objekt enthält. |
Add(GrammarBuilder[])
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
Fügt dem Satz von Alternativen ein Array hinzu, das mindestens ein GrammarBuilder Objekt enthält.
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[] -> unitPublic Sub Add (ParamArray alternateChoices As GrammarBuilder())Parameter
- alternateChoices
- GrammarBuilder[]
Die GrammarBuilder Objekte, die diesem Choices Objekt hinzugefügt werden sollen.
Beispiele
Im folgenden Beispiel wird eine Spracherkennungsgrammatik für Ausdrücke wie "Call Anne on her cell" und "Call James on his work phone" erstellt. Im Beispiel werden beide Überladungen der Add Methode verwendet, um die Grammatik zu erstellen.
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);
}
Hinweise
Aufgrund der Unterstützung für die implizite Konvertierung von Choices, SemanticResultKeyund SemanticResultValue Objekten in GrammarBuildereine Instanz können diese drei Klassen ebenfalls zu einer Choices Instanz hinzugefügt werden.
Wenn alternateChoices es sich um ein leeres Array handelt, aktualisiert diese Methode nicht den Satz von Alternativen.
Anwendungen können sowohl als auch Add(String[])Add(GrammarBuilder[]) Alternativen zu einem Choices Objekt hinzufügen.
Diese Methode löst einen ArgumentNullException Zeitpunkt alternateChoicesnull oder eines der Arrayelemente aus null.
Weitere Informationen
Gilt für:
Add(String[])
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
Fügt dem Satz von Alternativen ein Array hinzu, das mindestens ein String Objekt enthält.
public:
void Add(... cli::array <System::String ^> ^ phrases);public void Add(params string[] phrases);member this.Add : string[] -> unitPublic Sub Add (ParamArray phrases As String())Parameter
Beispiele
Im folgenden Beispiel wird eine Spracherkennungsgrammatik für Ausdrücke wie "Call Anne on her cell" und "Call James on his work phone" erstellt. Im Beispiel werden beide Überladungen der Add Methode verwendet, um die Grammatik zu erstellen.
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);
}
Hinweise
Anwendungen können sowohl als auch Add(String[])Add(GrammarBuilder[]) Alternativen zu einem Choices Objekt hinzufügen.
Wenn phrases es sich um ein leeres Array handelt, aktualisiert diese Methode nicht die Gruppe von Alternativen.
Diese Methode löst einen ArgumentNullException Zeitpunkt phrasesnull oder eines der Arrayelemente aus null. Diese Methode löst ein ArgumentException , wenn ein Element im Array die leere Zeichenfolge ("") ist.
