Partager via


GrammarBuilder.AppendRuleReference Méthode

Définition

Ajoute un fichier de syntaxe ou une règle de grammaire à la séquence en cours d'éléments de syntaxe.

Surcharges

AppendRuleReference(String)

Ajoute un fichier de définition de syntaxe à la séquence en cours d'éléments de syntaxe.

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.

Remarques

Les AppendRuleReference méthodes peuvent ajouter un fichier de grammaire ou une règle de grammaire à partir d’un fichier. Ces méthodes permettent aux applications d’utiliser des règles de grammaire prédéployées ou disponibles publiquement. L’application doit disposer d’un accès en lecture à l’emplacement des fichiers de grammaire spécifiés.

Ces méthodes peuvent lire une grammaire de reconnaissance vocale dans les formats suivants.

  • Fichiers au format XML conformes à la spécification de la grammaire de la reconnaissance vocale W3C (SRGS) Version 1,0

  • Fichiers binaires conformes au format binaire de la grammaire de reconnaissance vocale Microsoft (extension de fichier. cfg)

La compilation d’un fichier de grammaire SRGS au format XML dans un fichier de grammaire binaire avec l’extension. cfg peut réduire le temps consommé par recherche une correspondance, en particulier si la grammaire requiert la reconnaissance d’un grand nombre de mots et d’expressions. Pour plus d’informations sur la compilation des grammaires SRGS au format binaire CFG, consultez SrgsGrammarCompiler .

AppendRuleReference(String)

Ajoute un fichier de définition de syntaxe à la séquence en cours d'éléments de syntaxe.

public:
 void AppendRuleReference(System::String ^ path);
public void AppendRuleReference (string path);
member this.AppendRuleReference : string -> unit
Public Sub AppendRuleReference (path As String)

Paramètres

path
String

Chemin d'accès ou URI (Universal Resource Identifier) du fichier qui décrit une grammaire de reconnaissance vocale dans un format pris en charge.

Exemples

L’exemple C# suivant crée une grammaire de reconnaissance vocale qui utilise la règle nommée Cities dans un fichier SRGS local, villes. grxml. Le contenu du fichier villes. grxml s’affiche sous l’exemple de code C#.

private static Grammar CreateCitiesGrammar1()  
{  
  GrammarBuilder builder = new GrammarBuilder();  
  builder.AppendRuleReference("file://c:/temp/cities.grxml");  

  Grammar citiesGrammar = new Grammar(builder);  
  citiesGrammar.Name = "Cities Grammar 1";  
  return citiesGrammar;  
}  
<?xml version="1.0" encoding="UTF-16" ?>  
<grammar version="1.0" xml:lang="en-US"  
         xmlns="http://www.w3.org/2001/06/grammar"  
         tag-format="semantics/1.0" root="Main">  

  <!-- cities.grxml:   
    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

L’URI fourni par l' path argument peut être local ou distant. L’application doit disposer d’un accès en lecture à l’emplacement des fichiers de grammaire spécifiés.

Une représentation du W3C sur la grammaire de la reconnaissance vocale (SRGS) peut définir une règle racine. Cette méthode ajoute la grammaire, en commençant par sa règle racine, à la séquence en cours d’éléments de syntaxe. Pour ajouter une règle de grammaire spécifique, utilisez la AppendRuleReference méthode.

Voir aussi

S’applique à

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.

public:
 void AppendRuleReference(System::String ^ path, System::String ^ rule);
public void AppendRuleReference (string path, string rule);
member this.AppendRuleReference : string * string -> unit
Public Sub AppendRuleReference (path As String, rule As String)

Paramètres

path
String

Chemin d'accès ou URI (Universal Resource Identifier) du fichier qui décrit une grammaire de reconnaissance vocale dans un format pris en charge.

rule
String

Identificateur de la règle à ajouter, ou la valeur null pour ajouter la règle racine par défaut du fichier de grammaire.

Exemples

L’exemple C# suivant crée une grammaire de reconnaissance vocale qui utilise la règle nommée Cities dans un fichier SRGS local, villes. grxml. Le contenu du fichier villes. grxml s’affiche sous l’exemple de code C#.

private static Grammar CreateCitiesGrammar2()  
{  
  GrammarBuilder builder = new GrammarBuilder();  
  builder.Append("Does");  
  builder.AppendRuleReference(@"c:\temp\cities.grxml", "Cities");  
  builder.Append("have a shuttle");  

  Grammar citiesGrammar = new Grammar(builder);  
  citiesGrammar.Name = "Cities Grammar 2";  
  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.grxml:   
    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

L’URI fourni par l' path argument peut être local ou distant. L’application doit disposer d’un accès en lecture à l’emplacement des fichiers de grammaire spécifiés.

Vous pouvez utiliser la AppendRuleReference méthode pour ajouter un fichier de grammaire en commençant par sa règle racine.

Voir aussi

S’applique à