Partager via


Choices Classe

Définition

Représente un ensemble d'alternatives dans les contraintes d'une syntaxe de reconnaissance vocale.

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. GrammarBuilder est utilisé pour définir les contraintes de la grammaire.

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. Utilisez cette classe lors de la création d’une grammaire de reconnaissance vocale à partir d’un GrammarBuilder objet.

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 », ou « green », ou « blue ».

Notes

Pour utiliser un Choices objet comme composant facultatif dans une expression, créez l’objet et ajoutez-le Choices à un GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) objet avec minRepeat et maxRepeat défini sur 0 et 1, respectivement. Les expressions contenant des composants facultatifs peuvent être reconnues, que le composant facultatif soit prononcé ou non.

La Choices classe remplit la même fonction que l’élément one-of XML défini par la spécification de grammaire de reconnaissance vocale (SRGS) version 1.0 et est similaire à la classe dans l’espace SrgsOneOfSystem.Speech.Recognition.SrgsGrammar de noms.

Pour plus d’informations sur la définition d’une grammaire de reconnaissance vocale, consultez Reconnaissance vocale.

Constructeurs

Choices()

Initialise une nouvelle instance de la classe Choices qui contient un ensemble vide de solutions de remplacement.

Choices(GrammarBuilder[])

Initialise une nouvelle instance de la classe Choices à partir d'un tableau contenant un ou plusieurs objets GrammarBuilder.

Choices(String[])

Initialise une nouvelle instance de la classe Choices à partir d'un tableau contenant un ou plusieurs objets String.

Méthodes

Add(GrammarBuilder[])

Ajoute un tableau contenant un ou plusieurs objets GrammarBuilder à l'ensemble de solutions de remplacement.

Add(String[])

Ajoute un tableau contenant un ou plusieurs objets String à l'ensemble de solutions de remplacement.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToGrammarBuilder()

Retourne un objet GrammarBuilder de cet objet Choices.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi