Choices Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un ensemble d’alternatives dans les contraintes d’une grammaire de reconnaissance vocale.
public ref class Choicespublic class Choicestype Choices = classPublic 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. Il 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. 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 ».
Note
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 défini sur 0 et maxRepeat 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 de grammaire de reconnaissance vocale (SRGS) version 1.0 et est similaire à la SrgsOneOf classe dans l’espace System.Speech.Recognition.SrgsGrammar de noms.
Constructeurs
| Nom | Description |
|---|---|
| Choices() |
Initialise une nouvelle instance de la Choices classe qui contient un ensemble vide d’alternatives. |
| Choices(GrammarBuilder[]) |
Initialise une nouvelle instance de la Choices classe à partir d’un tableau contenant un ou plusieurs GrammarBuilder objets. |
| Choices(String[]) |
Initialise une nouvelle instance de la Choices classe à partir d’un tableau contenant un ou plusieurs String objets. |
Méthodes
| Nom | Description |
|---|---|
| Add(GrammarBuilder[]) |
Ajoute un tableau contenant un ou plusieurs GrammarBuilder objets à l’ensemble d’alternatives. |
| Add(String[]) |
Ajoute un tableau contenant un ou plusieurs String objets à l’ensemble d’alternatives. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToGrammarBuilder() |
Retourne un GrammarBuilder objet de cet Choices objet. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
