Choices Klasse

Definition

Stellt einen Satz von Alternativen in den Einschränkungen einer Spracherkennungsgrammatik dar.Represents a set of alternatives in the constraints of a speech recognition grammar.

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

Beispiele

Im folgenden Beispiel wird eine sprach Erkennungs Grammatik für den Ausdruck "Background on colorchoicefestlegen" erstellt, wobei colorchoice eine der definierten Farben sein kann.The following example creates a speech recognition grammar for the phrase, "Set background to colorChoice", where colorChoice can be one of the defined colors. GrammarBuilder Wird verwendet, um die Einschränkungen für die Grammatik zu definieren.The GrammarBuilder is used to define the constraints for the grammar.

  
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.A Choices object represents a component of a phrase that can have one of several values. Verwenden Sie diese Klasse, wenn Sie eine sprach Erkennungs Grammatik GrammarBuilder aus einem-Objekt erstellen.Use this class when creating a speech recognition grammar from a GrammarBuilder object.

Ein Choices -Objekt könnte z. b. die Komponente colorchoice im Ausdruck "Ändern der Farbe in colorchoice" darstellen, wobei zulässige Werte für colorchoice "Red", "Green" oder "Blue" lauten.For example, a Choices object could represent the component colorChoice in the phrase, "Change the color to colorChoice", where acceptable values for colorChoice are "red", or "green", or "blue".

Hinweis

Wenn Sie ein Choices -Objekt als optionale Komponente in einem Ausdruck verwenden möchten, Choices erstellen Sie das-Objekt, GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) und fügen Sie maxRepeat es einem-Objekt mit minRepeat und auf 0 bzw. 1 fest.To use a Choices object as an optional component in a phrase, create the Choices object and add it to a GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) object with minRepeat and maxRepeat set to 0 and 1, respectively. Ausdrücke mit optionalen Komponenten können erkannt werden, unabhängig davon, ob die optionale Komponente gesprochen wird oder nicht.Phrases containing optional components can be recognized whether or not the optional component is spoken.

Die Choices -Klasse erfüllt dieselbe Funktion wie das one-of von der sprach Erkennungs Grammatik-Spezifikation (SRGS) Version 1,0 definierte XML-Element und ähnelt der SrgsOneOf -Klasse im System.Speech.Recognition.SrgsGrammar -Namespace.The Choices class serves the same function as the one-of XML element defined by the Speech Recognition Grammar Specification (SRGS) Version 1.0 and is similar to the SrgsOneOf class in the System.Speech.Recognition.SrgsGrammar namespace.

Weitere Informationen zum Definieren einer sprach Erkennungs Grammatik finden Sie unter Spracherkennung und Erstellenvon Grammatiken für Grammatiken.For more information about defining a speech recognition grammar, see Speech Recognition and Creating GrammarBuilder Grammars.

Konstruktoren

Choices()

Initialisiert eine neue Instanz der Choices-Klasse, die einen leeren Satz von Alternativen enthält.Initializes a new instance of the Choices class that contains an empty set of alternatives.

Choices(GrammarBuilder[])

Initialisiert eine neue Instanz der Choices-Klasse aus einem Array von einem oder mehreren GrammarBuilder-Objekten.Initializes a new instance of the Choices class from an array containing one or more GrammarBuilder objects.

Choices(String[])

Initialisiert eine neue Instanz der Choices-Klasse aus einem Array von einem oder mehreren String-Objekten.Initializes a new instance of the Choices class from an array containing one or more String objects.

Methoden

Add(GrammarBuilder[])

Fügt der Gruppe von Alternativen ein Array hinzu, das ein oder mehrere GrammarBuilder-Objekte enthält.Adds an array containing one or more GrammarBuilder objects to the set of alternatives.

Add(String[])

Fügt der Gruppe von Alternativen ein Array hinzu, das ein oder mehrere String-Objekte enthält.Adds an array containing one or more String objects to the set of alternatives.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToGrammarBuilder()

Gibt ein GrammarBuilder-Objekt aus diesem Choices-Objekt zurück.Returns a GrammarBuilder object from this Choices object.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch