Choices Konstruktoren
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.
Initialisiert eine neue Instanz der Choices-Klasse.
Überlädt
| Name | Beschreibung |
|---|---|
| Choices() |
Initialisiert eine neue Instanz der Klasse, die Choices einen leeren Satz von Alternativen enthält. |
| Choices(GrammarBuilder[]) |
Initialisiert eine neue Instanz der Choices Klasse aus einem Array, das mindestens ein GrammarBuilder Objekt enthält. |
| Choices(String[]) |
Initialisiert eine neue Instanz der Choices Klasse aus einem Array, das mindestens ein String Objekt enthält. |
Beispiele
Im folgenden Beispiel werden Choices Objekte verwendet, um zwei Listen mit Alternativen zu erstellen.
Das erste Choices Objekt wird aus einem Array von String Objekten erstellt. Das andere Choices Objekt wird aus einem Array von GrammarBuilder Objekten erstellt, die implizit von einer Umwandlung konvertiert wurden.
Im Beispiel wird ein GrammarBuilder Objekt verwendet, um einen Ausdruck mit den Choices Objekten und zwei zusätzlichen Zeichenfolgen zusammenzustellen, die zum Erkennen von Spracheingaben in Form von "Call [contactlList] on [phoneType] phone" verwendet werden können, z. B. "Call Jane on cell phone".
public GrammarBuilder ChoicesConstructor2 ()
{
GrammarBuilder gb = new GrammarBuilder ();
Choices phoneType = new Choices (new string[] {"cell", "home", "work"});
Choices contactList = new Choices (new GrammarBuilder[] {(GrammarBuilder) "Mark", (GrammarBuilder) "Jane", (GrammarBuilder) "Frank"});
gb.Append ("Call");
gb.Append (contactList);
gb.Append ("on");
gb.Append (phoneType);
gb.Append ("phone");
return gb;
}
Hinweise
Sie können ein Choices Objekt mithilfe eines parameterlosen Konstruktors (der ein leeres Objekt zurückgibt), aus einer Gruppe von String Objekten oder einer Gruppe von GrammarBuilder Objekten erstellen.
Da das GrammarBuilder Objekt implizite Konvertierungen aus SemanticResultValue und SemanticResultKeyunterstützt, kann ein Choices Objekt aus einem Array dieser Objekte mithilfe einer Umwandlung erstellt werden.
Choices()
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
Initialisiert eine neue Instanz der Klasse, die Choices einen leeren Satz von Alternativen enthält.
public:
Choices();public Choices();Public Sub New ()Beispiele
Das folgende Beispiel verwendet Choices und GrammarBuilder Objekte, um einen Ausdruck zu erstellen, der zum Erkennen von Spracheingaben wie "Call Anne on her cell" und "Call James on his work phone" verwendet werden kann. Im Beispiel werden implizite Umwandlungen von Choices und String zu GrammarBuilder.
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
Dieser Konstruktor gibt einen gültigen, leeren Satz von Alternativen zurück. Sie können Alternativen mithilfe einer der Add Methoden hinzufügen.
Weitere Informationen
Gilt für:
Choices(GrammarBuilder[])
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
Initialisiert eine neue Instanz der Choices Klasse aus einem Array, das mindestens ein GrammarBuilder Objekt enthält.
public:
Choices(... cli::array <System::Speech::Recognition::GrammarBuilder ^> ^ alternateChoices);public Choices(params System.Speech.Recognition.GrammarBuilder[] alternateChoices);new System.Speech.Recognition.Choices : System.Speech.Recognition.GrammarBuilder[] -> System.Speech.Recognition.ChoicesPublic Sub New (ParamArray alternateChoices As GrammarBuilder())Parameter
- alternateChoices
- GrammarBuilder[]
Ein Array, das die Gruppe von Alternativen enthält.
Beispiele
Im folgenden Beispiel werden Ausdrücke Choices wie "Call Anne on her cell" und "Call James on his work phone" erstellt GrammarBuilderGrammar . Im Beispiel werden implizite Umwandlungen von Choices und String zu GrammarBuilder.
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
Jede GrammarBuilder In alternateChoices definiert eine Alternative. Wenn alternateChoices es sich um ein leeres Array handelt, gibt der Konstruktor einen leeren Satz von Alternativen zurück. Sie können Alternativen mithilfe einer der Add Methoden hinzufügen.
Der Konstruktor löst ein ArgumentNullException , wann alternateChoices oder null wenn eines der Arrayelemente ist null.
Da die GrammarBuilder Klasse die implizite Konvertierung von Choices, SemanticResultValueund SemanticResultKey Objekten in GrammarBuilder Instanzen unterstützt, kann dieser Konstruktor auch zum Erstellen eines Choices Objekts aus einer Liste dieser Objekte verwendet werden.
Weitere Informationen
Gilt für:
Choices(String[])
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
- Quelle:
- Choices.cs
public:
Choices(... cli::array <System::String ^> ^ phrases);public Choices(params string[] phrases);new System.Speech.Recognition.Choices : string[] -> System.Speech.Recognition.ChoicesPublic Sub New (ParamArray phrases As String())Parameter
- phrases
- String[]
Ein Array, das die Gruppe von Alternativen enthält.
Beispiele
Im folgenden Beispiel werden die Choices Ausdrücke "Anne auf ihrer Zelle anrufen" und "Call James on his work phone" erstellt GrammarBuilderGrammar . Im Beispiel werden implizite Umwandlungen von Choices und String zu GrammarBuilder.
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
Jede String In phrases definiert eine Alternative. Das Spracherkennungsmodul kann eines der Elemente im Zeichenfolgenarray verwenden, um der Spracheingabe zu entsprechen. Wenn phrases es sich um ein leeres Array handelt, gibt der Konstruktor einen leeren Satz von Alternativen zurück. Sie können Alternativen mithilfe einer der Add Methoden hinzufügen.
Der Konstruktor löst einen ArgumentNullException Zeitpunkt phrasesnull oder eines der Arrayelemente aus null. Der Konstruktor löst ein ArgumentException , wenn ein Element im Array eine leere Zeichenfolge ("") ist.
