Choices Klasse
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.
Stellt einen Satz von Alternativen in den Einschränkungen einer Spracherkennungsgrammatik dar.
public ref class Choicespublic class Choicestype Choices = classPublic Class Choices- Vererbung
-
Choices
Beispiele
Im folgenden Beispiel wird eine Spracherkennungsgrammatik für den Ausdruck "Hintergrund auf colorChoice festlegen" erstellt, wobei colorChoice eine der definierten Farben sein kann. Wird GrammarBuilder verwendet, um die Einschränkungen für die Grammatik zu definieren.
private Grammar CreateColorGrammar()
{
// Create a Choices object that contains a set of alternative colors.
Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
colorChoice.Add(new string[] {"cyan", "yellow", "magenta"});
// Construct the phrase.
GrammarBuilder builder = new GrammarBuilder("Set background to");
builder.Append(colorChoice);
// Create a grammar for the phrase.
Grammar colorGrammar = new Grammar(builder);
colorGrammar.Name = "SetBackground";
return colorGrammar;
}
Hinweise
Ein Choices -Objekt stellt eine Komponente eines Ausdrucks dar, die einen von mehreren Werten aufweisen kann. Verwenden Sie diese Klasse, wenn Sie eine Spracherkennungsgrammatik aus einem GrammarBuilder -Objekt erstellen.
Ein Choices -Objekt könnte beispielsweise die Komponente colorChoice im Ausdruck "Ändern der Farbe in colorChoice" darstellen, wobei zulässige Werte für colorChoice "rot" oder "grün" oder "blau" sind.
Hinweis
Um ein Choices Objekt als optionale Komponente in einem Ausdruck zu verwenden, erstellen Sie das Choices -Objekt, und fügen Sie es einem GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) Objekt mit minRepeat hinzu, und maxRepeat legen Sie es auf 0 bzw. 1 fest. Ausdrücke, die optionale Komponenten enthalten, können unabhängig davon erkannt werden, ob die optionale Komponente gesprochen wird oder nicht.
Die Choices -Klasse hat dieselbe Funktion wie das XML-Element, das one-of durch die SRGS-Version 1.0 (Speech Recognition Grammar Specification) definiert wird, und ähnelt der SrgsOneOf Klasse im System.Speech.Recognition.SrgsGrammar Namespace.
Weitere Informationen zum Definieren einer Spracherkennungsgrammatik finden Sie unter Spracherkennung.
Konstruktoren
| Choices() |
Initialisiert eine neue Instanz der Choices-Klasse, die einen leeren Satz von Alternativen enthält. |
| Choices(GrammarBuilder[]) |
Initialisiert eine neue Instanz der Choices-Klasse aus einem Array von einem oder mehreren GrammarBuilder-Objekten. |
| Choices(String[]) |
Initialisiert eine neue Instanz der Choices-Klasse aus einem Array von einem oder mehreren String-Objekten. |
Methoden
| Add(GrammarBuilder[]) |
Fügt der Gruppe von Alternativen ein Array hinzu, das ein oder mehrere GrammarBuilder-Objekte enthält. |
| Add(String[]) |
Fügt der Gruppe von Alternativen ein Array hinzu, das ein oder mehrere String-Objekte enthält. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToGrammarBuilder() |
Gibt ein GrammarBuilder-Objekt aus diesem Choices-Objekt zurück. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
