GrammarBuilder GrammarBuilder GrammarBuilder GrammarBuilder Class

Définition

Fournit un mécanisme pour la génération par programmation des contraintes d'une syntaxe de reconnaissance vocale.Provides a mechanism for programmatically building the constraints for a speech recognition grammar.

public ref class GrammarBuilder
public class GrammarBuilder
type GrammarBuilder = class
Public Class GrammarBuilder
Héritage
GrammarBuilderGrammarBuilderGrammarBuilderGrammarBuilder

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 colorChoiced’arrière-plan» ou «définir l’arrière-plan sur colorChoice».The following example uses GrammarBuilder and Choices objects to construct a grammar that can recognize either of the two phrases, "Make background colorChoice" or "Set background to colorChoice".

L’exemple utilise un Choices objet pour créer une liste de valeurs acceptables pour colorChoice à partir d' String un tableau d’objets.The example uses a Choices object to create a list of acceptable values for colorChoice from an array of String objects. 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.A Choices object is analogous to the one-of element in the SRGS specification, and contains a set of alternate phrases, any of which can be recognized when spoken. L’exemple utilise également un Choices objet pour regrouper un tableau GrammarBuilder de deux objets dans une paire d’expressions de remplacement que la grammaire résultante peut reconnaître.The example also uses a Choices object to group an array of two GrammarBuilder objects into a pair of alternative phrases that the resultant grammar can recognize. 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. GrammarBuilderAlternate words or phrases are a component of most grammars, and the Choices object provides this functionality for grammars constructed with GrammarBuilder.

L’exemple crée enfin un Grammar objet à partir GrammarBuilder d’un construit Choices à partir d’un objet.The example finally creates a Grammar object from a GrammarBuilder constructed from a Choices object.

  
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

Les grammaires de la reconnaissance vocale sont couramment créées dans le format XML défini par la spécification de la grammaire de reconnaissance vocale (SRGS) Version 1,0.Speech recognition grammars are commonly authored in the XML format defined by the Speech Recognition Grammar Specification (SRGS) Version 1.0. Si vous êtes familiarisé avec SRGS mais que vous souhaitez générer les grammaires par programmation, vous pouvez utiliser l' System.Speech.Recognition.SrgsGrammar espace de noms, dont les membres correspondent étroitement aux éléments et attributs définis par SRGS.If you are familiar with SRGS but want to generate the grammars programmatically, you can use the System.Speech.Recognition.SrgsGrammar namespace, whose members correspond closely to the elements and attributes defined by SRGS. Si vous n’êtes pas familiarisé avec SRGS, ou si vous souhaitez une approche légère et par programmation de la création de grammaires avec laquelle vous pouvez effectuer efficacement de nombreux scénarios courants; vous pouvez utiliser les GrammarBuilder classes Choices et.If you are unfamiliar with SRGS, or you want a lightweight, programmatic approach to authoring grammars with which you can efficiently accomplish many common scenarios; you can use the GrammarBuilder and Choices classes.

Utilisez GrammarBuilder des objets pour créer une arborescence hiérarchique composée d' Choices objets qui contiennent d’autres expressions, intercalés avec le préambule et les expressions amble sur chaque nœud, et amorcées avec des valeurs sémantiques qui renvoient la signification au oeuvre.Use GrammarBuilder objects to build a hierarchical tree composed of Choices objects that contain alternate phrases, interspersed with preamble and post-amble phrases at each node, and seeded with semantic values that convey meaning back to the application.

Pour utiliser un GrammarBuilder pour créer un Grammar objet, procédez comme suit.To use a GrammarBuilder to create a Grammar object, use the following steps.

  1. Créez un objet GrammarBuilder.Create a GrammarBuilder object.

  2. Ajoutez des contraintes à GrammarBuilder, telles que String des SemanticResultKey SemanticResultValue Choices GrammarBuilder objets,,,,, et d’autres objets qui définissent les contraintes pour la grammaire. DictationGrammarAppend constraints to the GrammarBuilder, such as String objects, Choices, SemanticResultKey, SemanticResultValue, DictationGrammar, and other GrammarBuilder objects that define the constraints for the grammar.

  3. Utilisez l’un des Grammar constructeurs pour créer un Grammar objet à partir de la GrammarBuilder grammaire terminée.Use one of the Grammar constructors to create a Grammar object from the completed GrammarBuilder grammar.

La création avec GrammarBuilder est mieux adaptée aux grammaires qui ont une seule règle contenant des listes, ou peut-être des listes de listes.Authoring with GrammarBuilder is best suited to grammars that have a single rule containing lists, or perhaps lists of lists. Pour créer par programmation des grammaires qui ont plusieurs règles, ou qui doivent créer des références de règle internes, utilisez les classes de System.Speech.Recognition.SrgsGrammar l’espace de noms.To programmatically build grammars that have multiple rules, or that need to make internal rule references, use the classes of the System.Speech.Recognition.SrgsGrammar namespace.

Les instances GrammarBuilder de peuvent également être obtenues par les conversions implicites à partir de certaines autres GrammarBuilder classes ou en combinant un avec un deuxième objet qui contient des contraintes pour une grammaire..Instances of GrammarBuilder can also be obtained by implicit conversions from certain other classes or by combining a GrammarBuilder with a second object that contains constraints for a grammar.. Pour plus d’informations, consultez Implicit les Addition opérateurs et et Add les méthodes.For more information, see the Implicit and Addition operators and the Add methods.

Pour ajouter des règles à un GrammarBuilderexistant, utilisez Addles Appendméthodes AppendDictation, AppendRuleReference,, AppendWildcard et.To add rules to an existing GrammarBuilder, use the Add, Append, AppendDictation, AppendRuleReference, and AppendWildcard methods.

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.The speech recognizer can throw an exception when using a speech recognition grammar that contains duplicate semantic elements with the same key name or multiple semantic elements that could repeatedly modify the value of the same semantic element.

Pour faciliter le débogage, la DebugShowPhrases propriété retourne l’état actuel de sous la GrammarBuilder forme d’une chaîne.To help with debugging, the DebugShowPhrases property returns the current status of the GrammarBuilder as a string.

Pour plus d’informations sur la création et l’utilisation des grammaires de la reconnaissance vocale, consultez reconnaissance vocale et création de grammaires GrammarBuilder.For more information about building and using speech recognition grammars, see Speech Recognition and Creating GrammarBuilder Grammars.

Constructeurs

GrammarBuilder() GrammarBuilder() GrammarBuilder() GrammarBuilder()

Initialise une nouvelle instance vide de la classe GrammarBuilder.Initializes a new, empty instance of the GrammarBuilder class.

GrammarBuilder(Choices) GrammarBuilder(Choices) GrammarBuilder(Choices) GrammarBuilder(Choices)

Initialise une nouvelle instance de la classe GrammarBuilder à partir d'un ensemble de solutions de remplacement.Initializes a new instance of the GrammarBuilder class from a set of alternatives.

GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32)

Initialise une nouvelle instance de la classe GrammarBuilder à partir d'un élément répété.Initializes a new instance of the GrammarBuilder class from a repeated element.

GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey)

Initialise une nouvelle instance de la classe GrammarBuilder à partir d'une clé sémantique.Initializes a new instance of the GrammarBuilder class from a semantic key.

GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue)

Initialise une nouvelle instance de la classe GrammarBuilder à partir d'une valeur sémantique.Initializes a new instance of the GrammarBuilder class from a semantic value.

GrammarBuilder(String) GrammarBuilder(String) GrammarBuilder(String) GrammarBuilder(String)

Initialise une nouvelle instance de la classe GrammarBuilder à partir d'une suite de mots.Initializes a new instance of the GrammarBuilder class from a sequence of words.

GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32) 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.Initializes a new instance of the GrammarBuilder class from the sequence of words in a String and specifies how many times the String can be repeated.

GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode)

Initialise une nouvelle instance de la classe GrammarBuilder pour un sous-ensemble d'une suite de mots.Initializes a new instance of the GrammarBuilder class for a subset of a sequence of words.

Propriétés

Culture Culture Culture Culture

Obtient ou définit la culture de la syntaxe de reconnaissance vocale.Gets or sets the culture of the speech recognition grammar.

DebugShowPhrases DebugShowPhrases DebugShowPhrases DebugShowPhrases

Obtient une chaîne qui indique les contenus et la structure de la grammaire contenus par GrammarBuilder.Gets a string that shows the contents and structure of the grammar contained by the GrammarBuilder.

Méthodes

Add(Choices, GrammarBuilder) Add(Choices, GrammarBuilder) Add(Choices, GrammarBuilder) Add(Choices, GrammarBuilder)

Crée un GrammarBuilder nouveau qui contient un objet Choices suivi d’un objet GrammarBuilder.Creates a new GrammarBuilder that contains a Choices object followed by a GrammarBuilder object.

Add(GrammarBuilder, Choices) Add(GrammarBuilder, Choices) Add(GrammarBuilder, Choices) Add(GrammarBuilder, Choices)

Crée un GrammarBuilder nouveau qui contient un objet GrammarBuilder suivi d’un objet Choices.Creates a new GrammarBuilder that contains a GrammarBuilder object followed by a Choices object.

Add(GrammarBuilder, GrammarBuilder) Add(GrammarBuilder, GrammarBuilder) Add(GrammarBuilder, GrammarBuilder) Add(GrammarBuilder, GrammarBuilder)

Crée un nouveau GrammarBuilder qui contient une séquence de deux objets GrammarBuilder .Creates a new GrammarBuilder that contains a sequence of two GrammarBuilder objects.

Add(GrammarBuilder, String) Add(GrammarBuilder, String) Add(GrammarBuilder, String) Add(GrammarBuilder, String)

Crée un nouveau GrammarBuilder qui contient un objet GrammarBuilder suivi d'une expression.Creates a new GrammarBuilder that contains a GrammarBuilder object followed by a phrase.

Add(String, GrammarBuilder) Add(String, GrammarBuilder) Add(String, GrammarBuilder) Add(String, GrammarBuilder)

Crée un nouveau GrammarBuilder qui contient une expression suivie d'un objet GrammarBuilder .Creates a new GrammarBuilder that contains a phrase followed by a GrammarBuilder object.

Append(Choices) Append(Choices) Append(Choices) Append(Choices)

Ajoute un ensemble d'alternatives à la séquence en cours d'éléments de syntaxe.Appends a set of alternatives to the current sequence of grammar elements.

Append(GrammarBuilder) Append(GrammarBuilder) Append(GrammarBuilder) Append(GrammarBuilder)

Ajoute un élément de syntaxe à la séquence en cours d'éléments de syntaxe.Appends a grammar element to the current sequence of grammar elements.

Append(GrammarBuilder, Int32, Int32) Append(GrammarBuilder, Int32, Int32) Append(GrammarBuilder, Int32, Int32) Append(GrammarBuilder, Int32, Int32)

Ajoute un élément de syntaxe répété à la séquence en cours d'éléments de syntaxe.Appends a repeated grammar element to the current sequence of grammar elements.

Append(SemanticResultKey) Append(SemanticResultKey) Append(SemanticResultKey) Append(SemanticResultKey)

Ajoute une clé sémantique à la séquence en cours d'éléments de syntaxe.Appends a semantic key to the current sequence of grammar elements.

Append(SemanticResultValue) Append(SemanticResultValue) Append(SemanticResultValue) Append(SemanticResultValue)

Ajoute une valeur sémantique à la séquence en cours d'éléments de syntaxe.Appends a semantic value to the current sequence of grammar elements.

Append(String) Append(String) Append(String) Append(String)

Ajoute une expression à la séquence en cours d'éléments de syntaxe.Appends a phrase to the current sequence of grammar elements.

Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32)

Ajoute une expression répétée à la séquence en cours d'éléments de syntaxe.Appends a repeated phrase to the current sequence of grammar elements.

Append(String, SubsetMatchingMode) Append(String, SubsetMatchingMode) Append(String, SubsetMatchingMode) Append(String, SubsetMatchingMode)

Ajoute un élément pour un sous-ensemble d'une expression à la séquence en cours d'éléments de syntaxe.Appends an element for a subset of a phrase to the current sequence of grammar elements.

AppendDictation() AppendDictation() AppendDictation() AppendDictation()

Ajoute la syntaxe de dictée par défaut à la séquence en cours d'éléments de syntaxe.Appends the default dictation grammar to the current sequence of grammar elements.

AppendDictation(String) AppendDictation(String) AppendDictation(String) AppendDictation(String)

Ajoute la syntaxe de dictée spécifiée à la séquence en cours d'éléments de syntaxe.Appends the specified dictation grammar to the current sequence of grammar elements.

AppendRuleReference(String) AppendRuleReference(String) AppendRuleReference(String) AppendRuleReference(String)

Ajoute un fichier de définition de syntaxe à la séquence en cours d'éléments de syntaxe.Appends a grammar definition file to the current sequence of grammar elements.

AppendRuleReference(String, String) AppendRuleReference(String, String) AppendRuleReference(String, String) AppendRuleReference(String, String)

Ajoute la règle spécifiée d'un fichier de définition de syntaxe à la séquence en cours d'éléments de syntaxe.Appends the specified rule of a grammar definition file to the current sequence of grammar elements.

AppendWildcard() AppendWildcard() AppendWildcard() AppendWildcard()

Ajoute un élément de syntaxe de reconnaissance qui correspond à une entrée dans la séquence en cours d'éléments de syntaxe.Appends a recognition grammar element that matches any input to the current sequence of grammar elements.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Opérateurs

Addition(Choices, GrammarBuilder) Addition(Choices, GrammarBuilder) Addition(Choices, GrammarBuilder) Addition(Choices, GrammarBuilder)

Crée un GrammarBuilder nouveau qui contient un objet Choices suivi d’un objet GrammarBuilder.Creates a new GrammarBuilder that contains a Choices object followed by a GrammarBuilder object.

Addition(GrammarBuilder, Choices) Addition(GrammarBuilder, Choices) Addition(GrammarBuilder, Choices) Addition(GrammarBuilder, Choices)

Crée un nouveau GrammarBuilder qui contient un GrammarBuilder suivi d'un Choices.Creates a new GrammarBuilder that contains a GrammarBuilder followed by a Choices.

Addition(GrammarBuilder, GrammarBuilder) Addition(GrammarBuilder, GrammarBuilder) Addition(GrammarBuilder, GrammarBuilder) Addition(GrammarBuilder, GrammarBuilder)

Crée un nouveau GrammarBuilder qui contient une séquence de deux objets GrammarBuilder .Creates a new GrammarBuilder that contains a sequence of two GrammarBuilder objects.

Addition(GrammarBuilder, String) Addition(GrammarBuilder, String) Addition(GrammarBuilder, String) Addition(GrammarBuilder, String)

Crée un nouveau GrammarBuilder qui contient un GrammarBuilder suivi d'une expression.Creates a new GrammarBuilder that contains a GrammarBuilder followed by a phrase.

Addition(String, GrammarBuilder) Addition(String, GrammarBuilder) Addition(String, GrammarBuilder) Addition(String, GrammarBuilder)

Crée un nouveau GrammarBuilder qui contient une expression suivie d'un GrammarBuilder .Creates a new GrammarBuilder that contains a phrase followed by a GrammarBuilder.

Implicit(Choices to GrammarBuilder) Implicit(Choices to GrammarBuilder) Implicit(Choices to GrammarBuilder) Implicit(Choices to GrammarBuilder)

Convertit un objet Choices en un objet GrammarBuilder.Converts a Choices object to a GrammarBuilder object.

Implicit(SemanticResultKey to GrammarBuilder) Implicit(SemanticResultKey to GrammarBuilder) Implicit(SemanticResultKey to GrammarBuilder) Implicit(SemanticResultKey to GrammarBuilder)

Convertit un objet SemanticResultKey en un objet GrammarBuilder.Converts a SemanticResultKey object to a GrammarBuilder object.

Implicit(SemanticResultValue to GrammarBuilder) Implicit(SemanticResultValue to GrammarBuilder) Implicit(SemanticResultValue to GrammarBuilder) Implicit(SemanticResultValue to GrammarBuilder)

Convertit un objet SemanticResultValue en un objet GrammarBuilder.Converts a SemanticResultValue object to a GrammarBuilder object.

Implicit(String to GrammarBuilder) Implicit(String to GrammarBuilder) Implicit(String to GrammarBuilder) Implicit(String to GrammarBuilder)

Convertit une chaîne en objet GrammarBuilder.Converts a string to a GrammarBuilder object.

S’applique à

Voir aussi