GrammarBuilder.AppendRuleReference Méthode

Définition

Espace de noms:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paquet:

System.Speech v11.0.0-preview.3.26207.106

Ajoute un fichier de grammaire ou une règle de grammaire à la séquence actuelle d’éléments de grammaire.

Surcharges

Nom	Description
AppendRuleReference(String)	Ajoute un fichier de définition de grammaire à la séquence actuelle d’éléments de grammaire.
AppendRuleReference(String, String)	Ajoute la règle spécifiée d’un fichier de définition de grammaire à la séquence actuelle d’éléments de grammaire.

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ée ou publiquement disponibles. L’application doit avoir un accès en lecture à l’emplacement des fichiers de grammaire spécifiés.

Ces méthodes peuvent lire une grammaire de reconnaissance vocale à partir des formats suivants.

• Fichiers au format XML conformes à la spécification de grammaire de reconnaissance vocale W3C (SRGS) version 1.0

• Fichiers binaires conformes au format binaire de 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 les recherches d’une correspondance, en particulier si la grammaire nécessite la reconnaissance d’un grand nombre de mots et d’expressions. Pour plus d’informations sur la compilation de grammaires SRGS au format binaire CFG, consultez SrgsGrammarCompiler.

AppendRuleReference(String)

Source:

GrammarBuilder.cs

Ajoute un fichier de définition de grammaire à la séquence actuelle d’éléments de grammaire.

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, cities.grxml. Le contenu du fichier cities.grxml apparaît 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

Important

L’utilisation d’une instance de ce type avec des données non approuvées est un risque de sécurité. Utilisez cet objet uniquement avec des données approuvées. Pour plus d’informations, consultez Valider toutes les entrées.

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

Une représentation SRGS (Speech Recognition Grammar Specification) W3C peut définir une règle racine. Cette méthode ajoute la grammaire, en commençant par sa règle racine, à la séquence actuelle d’éléments de grammaire. Pour ajouter une règle de grammaire spécifique, utilisez la AppendRuleReference méthode.

Voir aussi

• Append(Choices)
• AppendDictation()
• AppendWildcard()
• Grammar

AppendRuleReference(String, String)

Source:

GrammarBuilder.cs

Ajoute la règle spécifiée d’un fichier de définition de grammaire à la séquence actuelle d’éléments de grammaire.

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 au fichier 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 null 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, cities.grxml. Le contenu du fichier cities.grxml apparaît 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

Important

L’utilisation d’une instance de ce type avec des données non approuvées est un risque de sécurité. Utilisez cet objet uniquement avec des données approuvées. Pour plus d’informations, consultez Valider toutes les entrées.

L’URI fourni par l’argument path peut être local ou distant. L’application doit avoir 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 commençant par sa règle racine.

Voir aussi

• Append(Choices)
• AppendDictation()
• AppendWildcard()
• Grammar