Choices.Add Méthode

Définition

Espace de noms:

System.Speech.Recognition

Assembly:

System.Speech.dll

Ajoute des éléments à l'ensemble de solutions de remplacement.

Surcharges

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.

Add(GrammarBuilder[])

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

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 objet Choices.

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 à partir de Choices, SemanticResultKeyet SemanticResultValue des objets vers GrammarBuilder, ces trois classes peuvent également être ajoutées à une Choices instance.

S’il s’agit alternateChoices 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 une ArgumentNullException valeur lorsqu’il alternateChoices s’agit null ou l’un des éléments de tableau .null

Voir aussi

• GrammarBuilder
• Grammar

Add(String[])

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

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

phrases

String[]

Les chaînes à ajouter à cet objet Choices.

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’autres éléments.

Cette méthode lève une ArgumentNullException valeur lorsqu’il phrases s’agit null 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 («  »).

Voir aussi

• Grammar
• GrammarBuilder