Grammar Classe

Définition

Objet de runtime qui référence une syntaxe de reconnaissance vocale qu'une application peut utiliser pour définir les contraintes de reconnaissance vocale.A runtime object that references a speech recognition grammar, which an application can use to define the constraints for speech recognition.

public ref class Grammar
public class Grammar
type Grammar = class
Public Class Grammar
Héritage
Grammar
Dérivé

Exemples

L’exemple suivant construit un objet Grammar à partir d’une grammaire de reconnaissance vocale définie dans un fichier XML (villes. Xml).The following example constructs a Grammar object from a speech recognition grammar defined in a XML file (cities.xml). Le contenu du fichier villes. xml apparaît dans l’exemple XML suivant.The content of the cities.xml file appears in the following XML example.

// Load a cities grammar from a local file and return the grammar object.   
private static Grammar CreateGrammarFromFile()  
{  
  Grammar citiesGrammar = new Grammar(@"c:\temp\cities.xml");  
  citiesGrammar.Name = "SRGS File Cities Grammar";  
  return citiesGrammar;  
}  
  
  
<?xml version="1.0" encoding="UTF-8" ?>  
<grammar version="1.0" xml:lang="en-US"  
         xmlns="http://www.w3.org/2001/06/grammar"  
         tag-format="semantics/1.0" root="Main">  
  
  <!-- cities.xml:   
    Defines an SRGS grammar for requesting a flight. This grammar includes  
    a Cities rule that lists the cities that can be used for departures  
    and destinations. -->  
  
  <rule id="Main">  
    <item>  
      I would like to fly from <ruleref uri="#Cities"/>  
      to <ruleref uri="#Cities"/>  
    </item>  
  </rule>  
  
  <rule id="Cities" scope="public">  
    <one-of>  
      <item> Seattle </item>  
      <item> Los Angeles </item>  
      <item> New York </item>  
      <item> Miami </item>  
    </one-of>  
  </rule>  
</grammar>  

Remarques

Une grammaire de reconnaissance vocale est un ensemble de règles ou de contraintes qui définissent ce qu’un moteur de reconnaissance vocale peut reconnaître en tant qu’entrée significative.A speech recognition grammar is a set of rules or constraints that define what a speech recognition engine can recognize as meaningful input. Pour plus d’informations sur la création et l’utilisation des grammaires de reconnaissance vocale, consultez reconnaissance vocale, créer des grammaires à l’aide de XML, créer des grammaires à l’aide de GrammarBuilderet créer des grammaires à l’aide de SrgsGrammar.For more information about creating and using speech recognition grammars, see Speech Recognition, Create Grammars Using XML, Create Grammars Using GrammarBuilder, and Create Grammars Using SrgsGrammar.

Une fois que vous avez créé une grammaire, vous devez la créer dans un objet Grammar qu’un moteur de reconnaissance vocale peut charger et que votre application peut utiliser au moment de l’exécution pour gérer la reconnaissance vocale.After you author a grammar, you must build it into a Grammar object that a speech recognition engine can load and that your application can use at runtime to manage speech recognition. Vous pouvez utiliser un constructeur Grammar pour créer une instance Grammar à partir d’un objet GrammarBuilder ou SrgsDocument, ou à partir d’un fichier ou d’un Stream qui contient une description d’une grammaire dans un format pris en charge.You can use a Grammar constructor to create a Grammar instance from a GrammarBuilder or a SrgsDocument object, or from a file or a Stream that contains a description of a grammar in a supported format. Les formats pris en charge sont les suivants :Supported formats include the following:

Les constructeurs de grammaire qui acceptent les fichiers de grammaire de format XML dans leurs arguments compilent les grammaires XML dans un format binaire pour les optimiser pour le chargement et la consommation par un moteur de reconnaissance vocale.Grammar constructors that accept XML-format grammar files in their arguments compile the XML grammars to a binary format to optimize them for loading and consumption by a speech recognition engine. Vous pouvez réduire la durée nécessaire à la construction d’un objet Grammar à partir d’une grammaire au format XML en compilant la grammaire à l’avance, à l’aide de l’une des méthodes Compile.You can reduce the amount of time required to construct a Grammar object from an XML-format grammar by compiling the grammar in advance, using one of the Compile methods.

Le moteur de reconnaissance vocale d’une application, tel qu’il est géré par un objet SpeechRecognizer ou SpeechRecognitionEngine, peut charger plusieurs grammaires de reconnaissance vocale.An application's speech recognition engine, as managed by a SpeechRecognizer or SpeechRecognitionEngine object, can load multiple speech recognition grammars. L’application peut activer ou désactiver des grammaires individuelles indépendamment en définissant la propriété Enabled, et modifier le comportement de reconnaissance par le biais de propriétés Grammar, telles que les propriétés Priority et Weight.The application can independently enable or disable individual grammars by setting the Enabled property, and modify recognition behavior through Grammar properties, such as the Priority and Weight properties.

L’événement SpeechRecognized de la grammaire est déclenché lorsque l’entrée correspond à un chemin d’accès par le biais de la grammaire.The grammar's SpeechRecognized event is raised when input matches a path through the grammar.

Notes

Il est recommandé de vérifier la sécurité de n’importe quel URI ou DLL utilisé pour créer un objet Grammar.It is a best practice to verify the safety of any URI or DLL used to build a Grammar object.

Windows et la plateforme de reconnaissance vocale fournissent la sécurité pour les applications créant une instance Grammar à partir d’une DLL ou à partir d’une grammaire qui prend en charge les scripts.Windows and the Speech platform provide security for applications constructing a Grammar instance from a DLL or from a grammar that supports scripting.

Les scripts dans les objets Grammar sont toujours exécutés comme s’ils étaient téléchargés à partir d’une page Web dans la Internet Zone.Scripts in Grammar objects are always run as if downloaded from a web page in the Internet Zone. Le Common Language Runtime (CLR) isole toute DLL chargée pour obtenir une définition grammaticale.The Common Language Runtime (CLR) isolates any DLL loaded to obtain a grammar definition.

Constructeurs

Grammar()

Initialise une nouvelle instance de la classe Grammar.Initializes a new instance of the Grammar class.

Grammar(GrammarBuilder)

Initialise une nouvelle instance de la classe Grammar à partir d'un objet GrammarBuilder.Initializes a new instance of the Grammar class from a GrammarBuilder object.

Grammar(SrgsDocument)

Initialise une nouvelle instance de Grammar à partir d'un objet SrgsDocument.Initializes a new instance of a Grammar class from an SrgsDocument object.

Grammar(SrgsDocument, String)

Initialise une nouvelle instance d'une classe Grammar à partir d'un objet SrgsDocument et spécifie une règle racine.Initializes a new instance of a Grammar class from an SrgsDocument object and specifies a root rule.

Grammar(SrgsDocument, String, Object[])

Initialise une nouvelle instance de la classe Grammar d'une instance de SrgsDocument, puis spécifie le nom d'une règle comme point d'entrée de la grammaire.Initializes a new instance of the Grammar class from an instance of SrgsDocument, and specifies the name of a rule to be the entry point to the grammar.

Grammar(SrgsDocument, String, Uri)

Initialise une nouvelle instance d'une classe Grammar à partir d'un objet SrgsDocument, spécifie une règle racine et définit un URI (Uniform Resource Identifier) de base pour résoudre les références de règles relatives.Initializes a new instance of a Grammar class from an SrgsDocument object, specifies a root rule, and defines a base Uniform Resource Identifier (URI) to resolve relative rule references.

Grammar(SrgsDocument, String, Uri, Object[])

Initialise une nouvelle instance de la classe Grammar d'une instance de SrgsDocument, puis spécifie le nom d'une règle comme point d'entrée de la grammaire et un URI de base pour résoudre les références relatives.Initializes a new instance of the Grammar class from an instance of SrgsDocument, and specifies the name of a rule to be the entry point to the grammar and a base URI to resolve relative references.

Grammar(Stream)

Initialise une nouvelle instance de la classe Grammar à partir d'un Stream.Initializes a new instance of the Grammar class from a Stream.

Grammar(Stream, String)

Initialise une nouvelle instance de la classe Grammar à partir de Stream et spécifie une règle racine.Initializes a new instance of the Grammar class from a Stream and specifies a root rule.

Grammar(Stream, String, Object[])

Initialise une nouvelle instance de la classe Grammar à partir de Stream et spécifie une règle racine.Initializes a new instance of the Grammar class from a Stream and specifies a root rule.

Grammar(Stream, String, Uri)

Initialise une nouvelle instance de la classe Grammar à partir d'un flux, spécifie une règle racine et définit un URI (Uniform Resource Identifier) de base pour résoudre les références de règles relatives.Initializes a new instance of the Grammar class from a stream, specifies a root rule, and defines a base Uniform Resource Identifier (URI) to resolve relative rule references.

Grammar(Stream, String, Uri, Object[])

Initialise une nouvelle instance de la classe Grammar à partir d’une classe Stream, et spécifie une règle racine et un URI de base pour résoudre les références relatives.Initializes a new instance of the Grammar class a Stream and specifies a root rule and a base URI to resolve relative references.

Grammar(String)

Initialise une nouvelle instance de la classe Grammar à partir d'un fichier.Initializes a new instance of the Grammar class from a file.

Grammar(String, String)

Initialise une nouvelle instance de la classe Grammar à partir d'un fichier et spécifie une règle racine.Initializes a new instance of the Grammar class from a file and specifies a root rule.

Grammar(String, String, Object[])

Initialise une nouvelle instance de la classe Grammar à partir d’un fichier qui contient une définition de grammaire et spécifie le nom d’une règle comme point d’entrée de la grammaire.Initializes a new instance of the Grammar class from a file that contains a grammar definition, and specifies the name of a rule to be the entry point to the grammar.

Propriétés

Enabled

Obtient ou définit une valeur qui contrôle si Grammar peut être utilisée par un module de reconnaissance vocale pour effectuer la reconnaissance.Gets or sets a value that controls whether a Grammar can be used by a speech recognizer to perform recognition.

IsStg

Obtient une valeur indiquant si une grammaire est fortement typée.Gets whether a grammar is strongly typed.

Loaded

Obtient une valeur indiquant si Grammar a été chargé par un module de reconnaissance vocale.Gets whether a Grammar has been loaded by a speech recognizer.

Name

Obtient ou définit le nom d'un objet Grammar.Gets or sets the name of a Grammar object.

Priority

Obtient ou définit la valeur de priorité d'un objet Grammar.Gets or sets the priority value of a Grammar object.

ResourceName

Obtient ou définit une valeur avec le nom d'une ressource binaire utilisée pour charger la Grammaractuelle.Gets or sets a value with the name of a binary resource that was used to load the current Grammar.

RuleName

Obtient le nom de la règle racine ou du point d'entrée d'un objet Grammar.Gets the name of the root rule or entry point of a Grammar object.

Weight

Obtient ou définit la valeur pondérée d'un objet Grammar.Gets or sets the weight value of a Grammar object.

Méthodes

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.

(Hérité de Object)
GetHashCode()

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

(Hérité de Object)
GetType()

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

(Hérité de Object)
LoadLocalizedGrammarFromType(Type, Object[])

La méthode LoadLocalizedGrammarFromType retourne une instance localisée d'un objet Grammar dérivé du Type.The LoadLocalizedGrammarFromType method returns a localized instance of a Grammar object derived from Type.

MemberwiseClone()

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

(Hérité de Object)
StgInit(Object[])

La méthode StgInit initialise une syntaxe fortement typée.The StgInit method initializes a strongly-typed grammar.

ToString()

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

(Hérité de Object)

Événements

SpeechRecognized

Déclenché lorsqu'un module de reconnaissance vocale exécute la reconnaissance à l'aide de l'objet Grammar.Raised when a speech recognizer performs recognition using the Grammar object.

S’applique à

Voir aussi