Choices.Add Méthode

Définition

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

phrases
String[]

Chaînes à ajouter à cet Choices objet.

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 («  »).

Voir aussi

S’applique à