GrammarBuilder.AppendRuleReference 方法

定义

重载

注解

这些 AppendRuleReference 方法可以从文件追加语法文件或语法规则。 这些方法允许应用程序使用预先部署的或公开可用的语法规则。 应用程序必须具有对指定语法文件位置的读取访问权限。

这些方法可以从以下格式读取语音识别语法。

• 符合 W3C 语音识别语法规范 （SRGS） 版本 1.0 的 XML 格式文件

• 符合Microsoft语音识别语法二进制格式（.cfg 文件扩展名）的二进制文件

使用 .cfg 扩展名将 XML 格式的 SRGS 语法文件编译为二进制语法文件可以减少搜索匹配所需的时间，尤其是在语法需要识别大量字词和短语时。 有关将 SRGS 语法编译为 CFG 二进制格式的信息，请参阅 SrgsGrammarCompiler。

public:
 void AppendRuleReference(System::String ^ path);

public void AppendRuleReference(string path);

member this.AppendRuleReference : string -> unit

Public Sub AppendRuleReference (path As String)

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>

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)

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>