GrammarBuilder Constructeurs

Définition

Espace de noms:

System.Speech.Recognition

Assembly:

System.Speech.dll

Initialise une nouvelle instance de la classe GrammarBuilder.

Surcharges

GrammarBuilder()	Initialise une nouvelle instance vide de la classe GrammarBuilder.
GrammarBuilder(Choices)	Initialise une nouvelle instance de la classe GrammarBuilder à partir d'un ensemble de solutions de remplacement.
GrammarBuilder(SemanticResultKey)	Initialise une nouvelle instance de la classe GrammarBuilder à partir d'une clé sémantique.
GrammarBuilder(SemanticResultValue)	Initialise une nouvelle instance de la classe GrammarBuilder à partir d'une valeur sémantique.
GrammarBuilder(String)	Initialise une nouvelle instance de la classe GrammarBuilder à partir d'une suite de mots.
GrammarBuilder(String, SubsetMatchingMode)	Initialise une nouvelle instance de la classe GrammarBuilder pour un sous-ensemble d'une suite de mots.
GrammarBuilder(GrammarBuilder, Int32, Int32)	Initialise une nouvelle instance de la classe GrammarBuilder à partir d'un élément répété.
GrammarBuilder(String, Int32, Int32)	Initialise une nouvelle instance de la classe GrammarBuilder à partir de la séquence de mots d'une String et spécifie le nombre de fois que la String peut être répétée.

Remarques

Les instances de cette classe peuvent également être obtenues par les conversions implicites à partir d’autres classes ou en combinant un GrammarBuilder objet avec un deuxième objet à à partir d’un nouveau GrammarBuilder . Pour plus d’informations, consultez Implicit les Addition méthodes et.

Pour ajouter des contraintes à un existant GrammarBuilder , utilisez les Add méthodes,,, Append AppendDictation AppendRuleReference et AppendWildcard , ainsi que l' Addition opérateur.

Important

Le module de reconnaissance vocale peut lever une exception lors de l’utilisation d’une syntaxe de reconnaissance vocale qui contient des éléments sémantiques dupliqués avec le même nom de clé ou plusieurs éléments sémantiques qui peuvent modifier à plusieurs reprises la valeur du même élément sémantique.

Pour plus d’informations sur la création et l’utilisation des grammaires de reconnaissance vocale, consultez reconnaissance vocale.

GrammarBuilder()

Initialise une nouvelle instance vide de la classe GrammarBuilder.

public:
 GrammarBuilder();

public GrammarBuilder ();

Public Sub New ()

Exemples

L’exemple suivant utilise GrammarBuilder les Choices objets et pour construire une grammaire qui peut reconnaître l’une des deux expressions suivantes : « créer un colorChoice d’arrière-plan » ou « définir l’arrière-plan sur colorChoice».

L’exemple utilise un Choices objet pour créer une liste de valeurs acceptables pour colorChoice à partir d’un tableau d' String objets. Un Choices objet est analogue à l' one-of élément dans la spécification SRGS et contient un ensemble d’expressions alternatives, dont l’une d’entre elles peut être reconnue quand elle est parlée. L’exemple utilise également un Choices objet pour regrouper un tableau de deux GrammarBuilder objets dans une paire d’expressions de remplacement que la grammaire résultante peut reconnaître. Les mots ou expressions de substitution sont un composant de la plupart des grammaires, et l' Choices objet fournit cette fonctionnalité pour les grammaires construites avec GrammarBuilder .

L’exemple crée enfin un Grammar objet à partir d’un GrammarBuilder construit à partir d’un Choices objet.

private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices for the two alternative phrases, convert the Choices  
  // to a GrammarBuilder, and construct the Grammar object from the result.  
  GrammarBuilder bothPhrases = new GrammarBuilder();  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  bothPhrases.Append(bothChoices);  
  Grammar grammar = new Grammar(bothPhrases);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Remarques

Pour ajouter des règles à un GrammarBuilder objet existant, utilisez Add les Append méthodes,, AppendDictation , AppendRuleReference et AppendWildcard , ainsi que l' Addition opérateur.

Important

Le module de reconnaissance vocale peut lever une exception lors de l’utilisation d’une syntaxe de reconnaissance vocale qui contient des éléments sémantiques dupliqués avec le même nom de clé ou plusieurs éléments sémantiques qui peuvent modifier à plusieurs reprises la valeur du même élément sémantique.

Voir aussi

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

GrammarBuilder(Choices)

Initialise une nouvelle instance de la classe GrammarBuilder à partir d'un ensemble de solutions de remplacement.

public:
 GrammarBuilder(System::Speech::Recognition::Choices ^ alternateChoices);

public GrammarBuilder (System.Speech.Recognition.Choices alternateChoices);

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

Public Sub New (alternateChoices As Choices)

Paramètres

alternateChoices

Choices

Jeu d'alternatives.

Exemples

L’exemple suivant utilise GrammarBuilder les Choices objets et pour construire une grammaire qui peut reconnaître l’une des deux expressions suivantes : « créer un colorChoice d’arrière-plan » ou « définir l’arrière-plan sur colorChoice».

L’exemple utilise un Choices objet pour créer une liste de valeurs acceptables pour colorChoice à partir d’un tableau d' String objets. Un Choices objet est analogue à l' one-of élément dans la spécification SRGS et contient un ensemble d’expressions alternatives, qui peuvent être reconnues à l’oral. L’exemple utilise également un Choices objet pour regrouper un tableau de deux GrammarBuilder objets dans une paire d’expressions de remplacement que la grammaire résultante peut reconnaître. Les mots ou expressions de substitution sont un composant de la plupart des grammaires, et l' Choices objet fournit cette fonctionnalité pour les grammaires construites avec GrammarBuilder .

L’exemple crée enfin un Grammar objet à partir d’un GrammarBuilder construit à partir d’un Choices objet.

private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices for the two alternative phrases, convert the Choices  
  // to a GrammarBuilder, and construct the grammar from the result.  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Remarques

Pour plus d’informations sur la création d’une grammaire de reconnaissance vocale qui contient des alternatives, consultez utilisation de choix pour créer une grammaire GrammarBuilder.

Voir aussi

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

GrammarBuilder(SemanticResultKey)

Initialise une nouvelle instance de la classe GrammarBuilder à partir d'une clé sémantique.

public:
 GrammarBuilder(System::Speech::Recognition::SemanticResultKey ^ key);

public GrammarBuilder (System.Speech.Recognition.SemanticResultKey key);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultKey -> System.Speech.Recognition.GrammarBuilder

Public Sub New (key As SemanticResultKey)

Paramètres

key

SemanticResultKey

Clé sémantique.

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale qui peut reconnaître les deux expressions « make Background colorChoice» et « Set background to colorChoice», où colorChoice est sélectionné dans un jeu de couleurs. La grammaire permet à un utilisateur de prononcer n’importe quel nom de couleur et retourne des informations sémantiques sur le nom de la couleur reconnue à l’application.

L’exemple utilise un seul SemanticResultKey avec lequel vous pouvez récupérer le SemanticValue associé à la couleur parlée par l’utilisateur. Par exemple, si l’entrée contient l’expression « définir l’arrière-plan sur rouge », le résultat de la reconnaissance contient la valeur sémantique « #FF0000 », que vous pouvez récupérer à l’aide d’un gestionnaire pour l' SpeechRecognized événement.

L’exemple utilise String les Choices objets,, SemanticResultKey , SemanticResultValue et GrammarBuilder pour générer les contraintes qui sont toutes contenues dans le dernier GrammarBuilder objet, bothPhrases . Enfin, l’exemple construit un Grammar objet à partir du terminé GrammarBuilder .

private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  // Include semantic information about each of the colors.  
  Choices colorChoice = new Choices();  

  GrammarBuilder colorBuilder = new GrammarBuilder("red");  
  SemanticResultValue colorValue =  
    new SemanticResultValue(colorBuilder, "#FF0000");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  colorBuilder = new GrammarBuilder("green");  
  colorValue = new SemanticResultValue(colorBuilder, "#00FF00");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  colorBuilder = new GrammarBuilder("blue");  
  colorValue = new SemanticResultValue(colorBuilder, "#0000FF");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices object for the two alternative phrases.  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);  

  // Create the semantic key for referencing the color information.  
  SemanticResultKey colorKey =  
    new SemanticResultKey("ColorCode", bothPhrases);  
  bothPhrases = new GrammarBuilder(colorKey);  

  // Construct the Grammar object from the GrammarBuilder.  
  Grammar grammar = new Grammar(bothPhrases);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Remarques

Lorsque vous créez une GrammarBuilder instance à partir d’un SemanticResultValue objet, vous ajoutez des informations sémantiques à la grammaire qui peut être retournée dans le résultat de la reconnaissance. Vous pouvez accéder aux informations sémantiques dans le résultat de la reconnaissance à l’aide Semantics de la propriété de RecognizedPhrase , qui est disponible dans le gestionnaire de l' SpeechRecognized événement. Si GrammarBuilder définit un SemanticResultKey , il peut être utilisé pour récupérer les informations sémantiques dans un résultat de reconnaissance associé à la clé. Consultez l’exemple pour et Append(SemanticResultKey) consultez également SemanticResultValue et SemanticResultKey .

Important

Lorsque vous construisez GrammarBuilder des objets qui contiennent des SemanticResultValue instances ou, veillez SemanticResultKey à éviter de créer des éléments sémantiques en double avec le même nom de clé ou plusieurs éléments sémantiques qui peuvent modifier de façon répétée la Value propriété d’un SemanticValue objet. Le module de reconnaissance vocale peut lever une exception s’il rencontre ces circonstances.

Voir aussi

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

GrammarBuilder(SemanticResultValue)

Initialise une nouvelle instance de la classe GrammarBuilder à partir d'une valeur sémantique.

public:
 GrammarBuilder(System::Speech::Recognition::SemanticResultValue ^ value);

public GrammarBuilder (System.Speech.Recognition.SemanticResultValue value);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultValue -> System.Speech.Recognition.GrammarBuilder

Public Sub New (value As SemanticResultValue)

Paramètres

value

SemanticResultValue

Valeur ou paire nom/valeur sémantique.

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale qui peut reconnaître les deux expressions « make Background colorChoice» et « Set background to colorChoice», où colorChoice est sélectionné dans un jeu de couleurs. La grammaire permet à un utilisateur de prononcer n’importe quel nom de couleur et retourne des informations sémantiques sur le nom de la couleur reconnue à l’application.

L’exemple utilise un seul SemanticResultKey avec lequel vous pouvez récupérer le SemanticValue associé à la couleur parlée par l’utilisateur. Par exemple, si l’entrée contient l’expression « définir l’arrière-plan sur rouge », le résultat de la reconnaissance contient la valeur sémantique « #FF0000 », que vous pouvez récupérer à l’aide d’un gestionnaire pour l' SpeechRecognized événement.

L’exemple utilise String les Choices objets,, SemanticResultKey , SemanticResultValue et GrammarBuilder pour générer les contraintes qui sont toutes contenues dans le dernier GrammarBuilder objet, bothPhrases . Enfin, l’exemple construit un Grammar objet à partir du terminé GrammarBuilder .

private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  // Include semantic information about each of the colors.  
  Choices colorChoice = new Choices();  

  GrammarBuilder colorBuilder = new GrammarBuilder("red");  
  SemanticResultValue colorValue =  
    new SemanticResultValue(colorBuilder, "#FF0000");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  colorBuilder = new GrammarBuilder("green");  
  colorValue = new SemanticResultValue(colorBuilder, "#00FF00");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  colorBuilder = new GrammarBuilder("blue");  
  colorValue = new SemanticResultValue(colorBuilder, "#0000FF");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices for the two alternative phrases.  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);  

  // Create the semantic key for referencing the color information.  
  SemanticResultKey colorKey =  
    new SemanticResultKey("ColorCode", bothPhrases);  
  bothPhrases = new GrammarBuilder(colorKey);  

  // Construct the grammar from the grammar builder.  
  Grammar grammar = new Grammar(bothPhrases);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Remarques

Lorsque vous créez une GrammarBuilder instance à partir d’un SemanticResultValue objet, vous ajoutez des informations sémantiques à la grammaire qui peut être retournée dans le résultat de la reconnaissance. Vous pouvez accéder aux informations sémantiques dans le résultat de la reconnaissance à l’aide Semantics de la propriété de RecognizedPhrase , qui est disponible dans le gestionnaire de l' SpeechRecognized événement. Si GrammarBuilder définit un SemanticResultKey , il peut être utilisé pour récupérer les informations sémantiques dans un résultat de reconnaissance associé à la clé. Consultez l’exemple pour et Append(SemanticResultKey) consultez également SemanticResultValue et SemanticResultKey .

Important

Lorsque vous construisez GrammarBuilder des objets qui contiennent des SemanticResultValue instances ou, veillez SemanticResultKey à éviter de créer des éléments sémantiques en double avec le même nom de clé ou plusieurs éléments sémantiques qui peuvent modifier de façon répétée la Value propriété d’un SemanticValue objet. Le module de reconnaissance vocale peut lever une exception s’il rencontre ces circonstances.

Voir aussi

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

GrammarBuilder(String)

Initialise une nouvelle instance de la classe GrammarBuilder à partir d'une suite de mots.

public:
 GrammarBuilder(System::String ^ phrase);

public GrammarBuilder (string phrase);

new System.Speech.Recognition.GrammarBuilder : string -> System.Speech.Recognition.GrammarBuilder

Public Sub New (phrase As String)

Paramètres

phrase

String

Séquence de mots.

Exemples

L’exemple suivant utilise GrammarBuilder les Choices objets et pour construire une grammaire qui peut reconnaître l’une des deux expressions suivantes : « créer un colorChoice d’arrière-plan » ou « définir l’arrière-plan sur colorChoice».

Après avoir créé une liste de valeurs acceptables pour colorChoice à l’aide d’un Choices objet, l’exemple initialise deux GrammarBuilder objets, makePhrase et setPhrase , à l’aide d’une chaîne comme argument.

L’exemple crée enfin un Grammar objet à partir d’un Choices cast d’objet en GrammarBuilder objet.

private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices for the two alternative phrases, convert the Choices  
  // to a GrammarBuilder, and construct the Grammar object from the result.  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Remarques

L’expression représente une expression orale exacte que la grammaire de reconnaissance vocale peut reconnaître. Pour plus d’informations sur la création d’une grammaire de reconnaissance vocale qui contient des chaînes, consultez utilisation de chaînes pour créer une grammaire GrammarBuilder.

Voir aussi

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

GrammarBuilder(String, SubsetMatchingMode)

Initialise une nouvelle instance de la classe GrammarBuilder pour un sous-ensemble d'une suite de mots.

public:
 GrammarBuilder(System::String ^ phrase, System::Speech::Recognition::SubsetMatchingMode subsetMatchingCriteria);

public GrammarBuilder (string phrase, System.Speech.Recognition.SubsetMatchingMode subsetMatchingCriteria);

new System.Speech.Recognition.GrammarBuilder : string * System.Speech.Recognition.SubsetMatchingMode -> System.Speech.Recognition.GrammarBuilder

Public Sub New (phrase As String, subsetMatchingCriteria As SubsetMatchingMode)

Paramètres

phrase

String

Séquence de mots.

subsetMatchingCriteria

SubsetMatchingMode

Mode correspondant que la syntaxe de reconnaissance vocale utilise pour identifier l'expression.

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale pour chaque SubsetMatchingMode valeur et une grammaire pour choisir entre les grammaires en mode correspondant. Si la valeur de phrase est « 1 2 3 4 5 6 7 », la grammaire de la sous-séquence reconnaît l’entrée « 2 3 4 », mais pas l’entrée « 1 3 5 ». Toutefois, la grammaire de sous-ensemble ordonnée reconnaît ces deux entrées.

private static IEnumerable<Grammar>  
  CreateMatchingModeGrammars(string phrase)  
{  
  List<Grammar> grammars = new List<Grammar>(5);  

  Choices modeChoice = new Choices();  
  Type enumType = typeof(SubsetMatchingMode);  
  foreach (SubsetMatchingMode mode in Enum.GetValues(enumType))  
  {  
    string modeName = Enum.GetName(enumType, mode);  
    modeName = BreakAtCaps(modeName);  

    GrammarBuilder builder = new GrammarBuilder(phrase, mode);  
    Grammar modeGrammar = new Grammar(builder);  
    modeGrammar.Name = modeName;  
    modeGrammar.Enabled = false;  
    grammars.Add(modeGrammar);  

    modeChoice.Add(modeName);  
  }  

  Grammar choiceGrammar = new Grammar(modeChoice);  
  choiceGrammar.Name = "choice";  
  grammars.Add(choiceGrammar);  

  return grammars;  
}  

// Insert spaces preceding each uppercase letter in a string.   
private static string BreakAtCaps(string item)  
{  
  if (item == null || item.Length == 0)  
  {  
    return item;  
  }  

  StringBuilder sb = new StringBuilder(item[0].ToString());  
  for (int i = 1; i < item.Length; i++)  
  {  
    char c = item[i];  
    if (char.IsUpper(c))  
    {  
      sb.Append(" ");  
    }  
    sb.Append(c);  
  }  

  return sb.ToString();  
}  

Remarques

Le phrase paramètre représente l’expression que la grammaire de reconnaissance vocale peut reconnaître. Le subsetMatchingMode paramètre spécifie un sous-ensemble de l’expression qui peut être parlé pour obtenir une reconnaissance réussie de l’expression entière. Vous pouvez l’utiliser pour créer une grammaire avec une liste d’entrées avec des noms longs, sans obliger les utilisateurs à parler un nom entier pour correspondre à un élément.

Pour plus d’informations sur les modes de correspondance, consultez SubsetMatchingMode . Pour plus d’informations sur la création d’une grammaire de reconnaissance vocale qui contient des chaînes, consultez utilisation de chaînes pour créer une grammaire GrammarBuilder.

Voir aussi

• SubsetMatchingMode

GrammarBuilder(GrammarBuilder, Int32, Int32)

Initialise une nouvelle instance de la classe GrammarBuilder à partir d'un élément répété.

public:
 GrammarBuilder(System::Speech::Recognition::GrammarBuilder ^ builder, int minRepeat, int maxRepeat);

public GrammarBuilder (System.Speech.Recognition.GrammarBuilder builder, int minRepeat, int maxRepeat);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.GrammarBuilder * int * int -> System.Speech.Recognition.GrammarBuilder

Public Sub New (builder As GrammarBuilder, minRepeat As Integer, maxRepeat As Integer)

Paramètres

builder

GrammarBuilder

Élément répété.

minRepeat

Int32

Nombre minimum de fois où l'entrée correspondant à l'élément défini par le builder doit se produire pour constituer une correspondance.

maxRepeat

Int32

Nombre maximum de fois où l'entrée correspondant à l'élément défini par le builder peut se produire pour constituer une correspondance.

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale pour commander une pizza. Elle commence par une expression d’ouverture facultative, suivie d’une à quatre requêtes ping, et se termine par le mot « pizza ».

private static Grammar CreatePizzaGrammar()  
{  

  // Create a Choices object from a string array of alternative toppings.  
  Choices toppings = new Choices(new string[] {  
    "cheese", "mushroom", "tomato", "onion",  
    "anchovy", "chicken", "pepperoni"});  

  // Create a GrammarBuilder and append the Choices object.  
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);  
  andToppings.Append(toppings);  

  // Construct the phrase.  
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);  
  gb.Append(toppings);  
  gb.Append(new GrammarBuilder(andToppings, 0, 3));  
  gb.Append("pizza");  

  // Create the Grammar from the GrammarBuilder.  
  Grammar grammar = new Grammar(gb);  
  grammar.Name = "Pizza Order";  

  return grammar;  
}  

Remarques

Si la valeur de minRepeat est égale à 0, le nouveau GrammarBuilder représente un élément facultatif.

La valeur de minRepeat doit être supérieure ou égale à 0 et inférieure ou égale à la valeur de maxRepeat .

Important

Lorsque vous spécifiez des répétitions pour des GrammarBuilder objets qui contiennent des SemanticResultValue instances ou, veillez SemanticResultKey à éviter de créer des éléments sémantiques dupliqués avec le même nom de clé ou plusieurs éléments sémantiques qui peuvent modifier de façon répétée la Value propriété d’un SemanticValue objet. Le module de reconnaissance vocale peut lever une exception s’il rencontre ces circonstances.

Voir aussi

• Choices
• Grammar

GrammarBuilder(String, Int32, Int32)

Initialise une nouvelle instance de la classe GrammarBuilder à partir de la séquence de mots d'une String et spécifie le nombre de fois que la String peut être répétée.

public:
 GrammarBuilder(System::String ^ phrase, int minRepeat, int maxRepeat);

public GrammarBuilder (string phrase, int minRepeat, int maxRepeat);

new System.Speech.Recognition.GrammarBuilder : string * int * int -> System.Speech.Recognition.GrammarBuilder

Public Sub New (phrase As String, minRepeat As Integer, maxRepeat As Integer)

Paramètres

phrase

String

Séquence de mots répétée.

minRepeat

Int32

Nombre minimum de fois où l'entrée correspondant à l'expression doit se produire pour constituer une correspondance.

maxRepeat

Int32

Nombre maximum de fois où l'entrée correspondant à l'expression peut se produire pour constituer une correspondance.

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale pour commander une pizza. Elle commence par une expression d’ouverture facultative, suivie d’une à quatre requêtes ping, et se termine par le mot « pizza ».

private static Grammar CreatePizzaGrammar()  
{  

  // Create a Choices object with alternatives for toppings.  
  Choices toppings = new Choices(new string[] {  
    "cheese", "mushroom", "tomato", "onion",  
    "anchovy", "chicken", "pepperoni"});  

  // Create a GrammarBuilder and append the Choices object.  
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);  
  andToppings.Append(toppings);  

  // Construct the phrase.  
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);  
  gb.Append(toppings);  
  gb.Append(new GrammarBuilder(andToppings, 0, 3));  
  gb.Append("pizza");  

  // Create the Grammar from the GrammarBuilder.  
  Grammar grammar = new Grammar(gb);  
  grammar.Name = "Pizza Order";  

  return grammar;  
}  

Remarques

Si la valeur de minRepeat est égale à 0, le nouveau GrammarBuilder représente un élément facultatif.

La valeur de minRepeat doit être supérieure ou égale à 0 et inférieure ou égale à la valeur de maxRepeat . Pour plus d’informations sur la création d’une grammaire de reconnaissance vocale qui contient des chaînes, consultez utilisation de chaînes pour créer une grammaire GrammarBuilder.

Voir aussi

• Choices
• Grammar