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. Permet GrammarBuilder de 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 « Modifier la couleur en colorChoice », où les valeurs acceptables pour colorChoice sont « rouge » ou « vert » ou « bleu ».

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 si le composant facultatif est prononcé ou non.

La Choices classe sert la même fonction que l’élément one-of XML défini par la spécification SRGS (Speech Recognition Grammar Specification) version 1.0 et est similaire à la SrgsOneOf classe dans l’espace System.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