Choices Classe

Définition

Représente un ensemble d'alternatives dans les contraintes d'une syntaxe de reconnaissance vocale.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
Héritage
Choices

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale pour l’expression «définir l’arrière-plan sur colorChoice», où colorChoice peut être l’une des couleurs définies.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 Est utilisé pour définir les contraintes de la grammaire.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;  
}  

Remarques

Un Choices objet représente un composant d’une expression qui peut avoir l’une des valeurs suivantes.A Choices object represents a component of a phrase that can have one of several values. Utilisez cette classe lors de la création d’une grammaire de GrammarBuilder reconnaissance vocale à partir d’un objet.Use this class when creating a speech recognition grammar from a GrammarBuilder object.

Par exemple, un Choices objet peut représenter le composant colorChoice dans l’expression «change the Color to colorChoice», où les valeurs acceptables pour colorChoice sont «Red», «Green» ou «Blue».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".

Notes

Pour utiliser un Choices objet en tant que composant facultatif dans une expression, créez Choices l’objet et ajoutez-le GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) à un minRepeat objet maxRepeat avec et défini sur 0 et 1, respectivement.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. Les expressions contenant des composants facultatifs peuvent être reconnues, que le composant facultatif soit parlé ou non.Phrases containing optional components can be recognized whether or not the optional component is spoken.

La Choices classe remplit la même fonction que l' one-of élément XML défini par la spécification de la grammaire de la reconnaissance vocale (SRGS) version 1,0 et SrgsOneOf est semblable à System.Speech.Recognition.SrgsGrammar la classe dans l’espace de noms.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.

Pour plus d’informations sur la définition d’une grammaire de reconnaissance vocale, consultez reconnaissance vocale et création de grammaires GrammarBuilder.For more information about defining a speech recognition grammar, see Speech Recognition and Creating GrammarBuilder Grammars.

Constructeurs

Choices()

Initialise une nouvelle instance de la classe Choices qui contient un ensemble vide de solutions de remplacement.Initializes a new instance of the Choices class that contains an empty set of alternatives.

Choices(GrammarBuilder[])

Initialise une nouvelle instance de la classe Choices à partir d'un tableau contenant un ou plusieurs objets GrammarBuilder.Initializes a new instance of the Choices class from an array containing one or more GrammarBuilder objects.

Choices(String[])

Initialise une nouvelle instance de la classe Choices à partir d'un tableau contenant un ou plusieurs objets String.Initializes a new instance of the Choices class from an array containing one or more String objects.

Méthodes

Add(GrammarBuilder[])

Ajoute un tableau contenant un ou plusieurs objets GrammarBuilder à l'ensemble de solutions de remplacement.Adds an array containing one or more GrammarBuilder objects to the set of alternatives.

Add(String[])

Ajoute un tableau contenant un ou plusieurs objets String à l'ensemble de solutions de remplacement.Adds an array containing one or more String objects to the set of alternatives.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToGrammarBuilder()

Retourne un objet GrammarBuilder de cet objet Choices.Returns a GrammarBuilder object from this Choices object.

ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi