Choices.Add Méthode
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.
Ajoute des éléments à l’ensemble d’alternatives.
Surcharges
| 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. |
Add(GrammarBuilder[])
- Source:
- Choices.cs
- Source:
- Choices.cs
- Source:
- Choices.cs
- Source:
- Choices.cs
Ajoute un tableau contenant un ou plusieurs GrammarBuilder objets à l’ensemble d’alternatives.
public:
void Add(... cli::array <System::Speech::Recognition::GrammarBuilder ^> ^ alternateChoices);
public void Add(params System.Speech.Recognition.GrammarBuilder[] alternateChoices);
member this.Add : System.Speech.Recognition.GrammarBuilder[] -> unit
Public Sub Add (ParamArray alternateChoices As GrammarBuilder())
Paramètres
- alternateChoices
- GrammarBuilder[]
Objets GrammarBuilder à ajouter à cet Choices objet.
Exemples
L’exemple suivant crée une grammaire de reconnaissance vocale pour les expressions telles que « Appeler Anne sur sa cellule » et « Appeler James sur son téléphone professionnel ». L’exemple utilise les deux surcharges de la Add méthode pour générer la grammaire.
public Grammar CreatePhonePhrase()
{
// Create alternatives for female names and add a phrase.
GrammarBuilder females = new Choices(new string[] { "Anne", "Mary" });
females.Append("on her");
// Create alternatives for male names and add a phrase.
GrammarBuilder males = new Choices(new string[] { "James", "Sam" });
males.Append("on his");
// Create a Choices object that contains an array of alternative
// GrammarBuilder objects.
Choices people = new Choices();
people.Add(new Choices(new GrammarBuilder[] {females, males}));
// Create a Choices object that contains a set of alternative phone types.
Choices phoneType = new Choices();
phoneType.Add(new string[] { "cell", "home", "work" });
// Construct the phrase.
GrammarBuilder gb = new GrammarBuilder();
gb.Append("call");
gb.Append(people);
gb.Append(phoneType);
gb.Append(new GrammarBuilder("phone"), 0, 1);
return new Grammar(gb);
}
Remarques
En raison de la prise en charge de la conversion implicite depuis Choices, SemanticResultKeyet SemanticResultValue des objets vers GrammarBuilder, ces trois classes peuvent également être ajoutées à une Choices instance.
S’il alternateChoices s’agit d’un tableau vide, cette méthode ne met pas à jour l’ensemble d’alternatives.
Les applications peuvent utiliser les deux Add(String[]) et Add(GrammarBuilder[]) ajouter des alternatives à un Choices objet.
Cette méthode lève un ArgumentNullException moment alternateChoicesnull ou l’un des éléments de tableau .null
Voir aussi
S’applique à
Add(String[])
- Source:
- Choices.cs
- Source:
- Choices.cs
- Source:
- Choices.cs
- Source:
- Choices.cs
Ajoute un tableau contenant un ou plusieurs String objets à l’ensemble d’alternatives.
public:
void Add(... cli::array <System::String ^> ^ phrases);
public void Add(params string[] phrases);
member this.Add : string[] -> unit
Public Sub Add (ParamArray phrases As String())
Paramètres
Exemples
L’exemple suivant crée une grammaire de reconnaissance vocale pour les expressions similaires à « Appeler Anne sur sa cellule » et « Appeler James sur son téléphone professionnel ». L’exemple utilise les deux surcharges de la Add méthode pour générer la grammaire.
public Grammar CreatePhonePhrase()
{
// Create alternatives for female names and add a phrase.
GrammarBuilder females = new Choices(new string[] { "Anne", "Mary" });
females.Append("on her");
// Create alternatives for male names and add a phrase.
GrammarBuilder males = new Choices(new string[] { "James", "Sam" });
males.Append("on his");
// Create a Choices object that contains an array of alternative
// GrammarBuilder objects.
Choices people = new Choices();
people.Add(new Choices(new GrammarBuilder[] {females, males}));
// Create a Choices object that contains a set of alternative phone types.
Choices phoneType = new Choices();
phoneType.Add(new string[] { "cell", "home", "work" });
// Construct the phrase.
GrammarBuilder gb = new GrammarBuilder();
gb.Append("call");
gb.Append(people);
gb.Append(phoneType);
gb.Append(new GrammarBuilder("phone"), 0, 1);
return new Grammar(gb);
}
Remarques
Les applications peuvent utiliser les deux Add(String[]) et Add(GrammarBuilder[]) ajouter des alternatives à un Choices objet.
S’il phrases s’agit d’un tableau vide, cette méthode ne met pas à jour l’ensemble d’alternatives.
Cette méthode lève un ArgumentNullException moment phrasesnull ou l’un des éléments de tableau .null Cette méthode lève un ArgumentException élément si un élément du tableau est la chaîne vide (« »).