Choices Constructeurs

Définition

Espace de noms:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paquet:

System.Speech v9.0.0-rc.2.24473.5

Initialise une nouvelle instance de la classe Choices.

Surcharges

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.

Exemples

L’exemple suivant utilise des Choices objets pour créer deux listes d’alternatives.

Le premier Choices objet est construit à partir d’un tableau d’objets String . L’autre Choices objet est construit à partir d’un tableau d’objets GrammarBuilder qui ont été implicitement convertis par un cast.

L’exemple utilise un GrammarBuilder objet pour assembler une expression, à l’aide Choices des objets et de deux chaînes supplémentaires, qui peut être utilisée pour reconnaître l’entrée vocale sous la forme « Call [contactlList] on [phoneType] phone », par exemple « Call Jane on cell phone ».

public GrammarBuilder ChoicesConstructor2 ()  
{  
    GrammarBuilder gb = new GrammarBuilder ();  
    Choices phoneType = new Choices (new string[] {"cell", "home", "work"});  
    Choices contactList = new Choices (new GrammarBuilder[] {(GrammarBuilder) "Mark", (GrammarBuilder) "Jane", (GrammarBuilder) "Frank"});  
    gb.Append ("Call");  
    gb.Append (contactList);  
    gb.Append ("on");  
    gb.Append (phoneType);  
    gb.Append ("phone");  
    return gb;  
}  

Remarques

Vous pouvez construire un Choices objet à l’aide d’un constructeur sans paramètre (qui retourne un objet vide), d’un groupe d’objets String ou d’un jeu d’objets GrammarBuilder .

Étant donné que l’objet prend en charge la GrammarBuilder conversion implicite à partir de SemanticResultValue et SemanticResultKey, un Choices peut être construit à partir d’un tableau de ces objets à l’aide d’un cast.

Choices()

Source:

Choices.cs

Initialise une nouvelle instance de la classe Choices qui contient un ensemble vide de solutions de remplacement.

public:
 Choices();

public Choices ();

Public Sub New ()

Exemples

L’exemple suivant utilise Choices des objets et GrammarBuilder pour créer une expression qui peut être utilisée pour reconnaître des entrées vocales telles que « Appeler Anne sur sa cellule » et « Appeler James sur son téléphone professionnel ». L’exemple utilise des casts implicites de Choices et String en GrammarBuilder.

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

Ce constructeur retourne un ensemble valide et vide d’alternatives. Vous pouvez ajouter des alternatives à l’aide de l’une des Add méthodes .

Voir aussi

• Grammar
• GrammarBuilder

Choices(GrammarBuilder[])

Source:

Choices.cs

Initialise une nouvelle instance de la classe Choices à partir d'un tableau contenant un ou plusieurs objets GrammarBuilder.

public:
 Choices(... cli::array <System::Speech::Recognition::GrammarBuilder ^> ^ alternateChoices);

public Choices (params System.Speech.Recognition.GrammarBuilder[] alternateChoices);

new System.Speech.Recognition.Choices : System.Speech.Recognition.GrammarBuilder[] -> System.Speech.Recognition.Choices

Public Sub New (ParamArray alternateChoices As GrammarBuilder())

Paramètres

alternateChoices

GrammarBuilder[]

Tableau contenant l'ensemble des solutions de remplacement.

Exemples

L’exemple suivant utilise Choices des objets et GrammarBuilder pour créer un Grammar pour des expressions telles que « Appeler Anne sur sa cellule » et « Appeler James sur son téléphone professionnel ». L’exemple utilise des casts implicites de Choices et String en GrammarBuilder.

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

Chaque GrammarBuilder dans alternateChoices définit une alternative. Si alternateChoices est un tableau vide, le constructeur retourne un ensemble vide d’alternatives. Vous pouvez ajouter des alternatives à l’aide de l’une des Add méthodes .

Le constructeur lève un ArgumentNullException quand alternateChoices est null ou quand l’un des éléments du tableau est null.

Étant donné que la classe prend en charge la GrammarBuilder conversion implicite d’objets Choices, SemanticResultValueet SemanticResultKey en GrammarBuilder instances, en utilisant correctement des casts, ce constructeur peut également être utilisé pour créer un Choices objet à partir d’une liste de toute combinaison de ces objets.

Voir aussi

• Grammar
• GrammarBuilder

Choices(String[])

Source:

Choices.cs

Initialise une nouvelle instance de la classe Choices à partir d'un tableau contenant un ou plusieurs objets String.

public:
 Choices(... cli::array <System::String ^> ^ phrases);

public Choices (params string[] phrases);

new System.Speech.Recognition.Choices : string[] -> System.Speech.Recognition.Choices

Public Sub New (ParamArray phrases As String())

Paramètres

phrases

String[]

Tableau contenant l'ensemble des solutions de remplacement.

Exemples

L’exemple suivant utilise Choices des objets et GrammarBuilder pour créer un Grammar pour les expressions telles que « Appeler Anne sur sa cellule » et « Appeler James sur son téléphone professionnel ». L’exemple utilise des casts implicites de Choices et String en GrammarBuilder.

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

Chaque String dans phrases définit une alternative. Le moteur de reconnaissance vocale peut utiliser l’un des éléments du tableau de chaînes pour faire correspondre l’entrée vocale. Si phrases est un tableau vide, le constructeur retourne un ensemble vide d’alternatives. Vous pouvez ajouter des alternatives à l’aide de l’une des Add méthodes .

Le constructeur lève un ArgumentNullException quand phrases est null ou l’un des éléments du tableau est null. Le constructeur lève un ArgumentException si un élément du tableau est une chaîne vide («  »).

Voir aussi

• Grammar
• GrammarBuilder