Choices Klasse

  • Referenz

Definition

Namespace:
System.Speech.Recognition
Assembly:
System.Speech.dll

Stellt einen Satz von Alternativen in den Einschränkungen einer Spracherkennungsgrammatik dar.

public ref class Choices
public class Choices
type Choices = class
Public Class Choices
Vererbung
Object
Choices

Beispiele

Im folgenden Beispiel wird eine Spracherkennungs grammatik für den Ausdruck "Hintergrund auf ColorChoice festlegen" erstellt, in dem colorChoice eine der definierten Farben sein kann. Dies GrammarBuilder wird 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, der einen von mehreren Werten aufweisen kann. Verwenden Sie diese Klasse beim Erstellen einer Spracherkennungs grammatik aus einem GrammarBuilder Objekt.

Ein Objekt könnte beispielsweise Choices die Komponente colorChoice im Ausdruck "Farbe in ColorChoice ändern", wobei zulässige Werte für colorChoice "rot" oder "grün" oder "blau" sind.

Hinweis

Wenn Sie ein Choices Objekt als optionale Komponente in einem Ausdruck verwenden möchten, erstellen Sie das Choices Objekt, und fügen Sie es zu einem GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) Objekt hinzu, das minRepeat jeweils auf 0 und maxRepeat 1 festgelegt ist. Ausdrücke mit optionalen Komponenten können erkannt werden, ob die optionale Komponente gesprochen wird.

Die Choices Klasse dient der gleichen Funktion wie das XML-Element, das durch die one-of Spracherkennungs grammatikspezifikation (SRGS) Version 1.0 definiert ist und der Klasse im System.Speech.Recognition.SrgsGrammar Namespace ähnlich SrgsOneOf ist.

Weitere Informationen zum Definieren einer Spracherkennungs grammatik 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)

Gilt für

Siehe auch