GrammarBuilder.AppendRuleReference Método

Definição

Espaço de Nomes:
System.Speech.Recognition
Assemblagem:
System.Speech.dll

Acrescenta um ficheiro gramatical ou uma regra gramatical à sequência atual de elementos gramaticais.

Sobrecargas

Name Description
AppendRuleReference(String)

Acrescenta um ficheiro de definição gramatical à sequência atual de elementos gramaticais.
AppendRuleReference(String, String)

Acrescenta a regra especificada de um ficheiro de definição gramatical à sequência atual de elementos gramaticais.

Observações

Os AppendRuleReference métodos podem adicionar um ficheiro gramatical ou uma regra gramatical a partir de um ficheiro. Estes métodos permitem que as aplicações utilizem regras gramaticais pré-implementadas ou publicamente disponíveis. A aplicação deve ter acesso de leitura à localização dos ficheiros gramaticais especificados.

Estes métodos podem ler uma gramática de reconhecimento de fala dos seguintes formatos.

Compilar um ficheiro gramatical SRGS em formato XML para um ficheiro gramático binário com a extensão .cfg pode reduzir o tempo gasto em pesquisas por correspondência, especialmente se a gramática exigir o reconhecimento de um grande número de palavras e frases. Para informações sobre a compilação de gramáticas SRGS para o formato binário CFG, veja SrgsGrammarCompiler.

AppendRuleReference(String)

Acrescenta um ficheiro de definição gramatical à sequência atual de elementos gramaticais.

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

Parâmetros

path
String

O caminho ou Identificador Universal de Recursos (URI) do ficheiro que descreve uma gramática de reconhecimento de fala num formato suportado.

Exemplos

O exemplo seguinte de C# cria uma gramática de reconhecimento de fala que utiliza a regra nomeada Cities num ficheiro SRGS local, cities.grxml. O conteúdo do ficheiro cities.grxml aparece abaixo do exemplo do código 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>

Observações

Importante

Utilizar uma instância deste tipo com dados não confiáveis é um risco de segurança. Use este objeto apenas com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.

O URI fornecido pelo path argumento pode ser local ou remoto. A aplicação deve ter acesso de leitura à localização dos ficheiros gramaticais especificados.

Uma representação da Especificação de Gramática de Reconhecimento de Fala (SRGS) do W3C pode definir uma regra raiz. Este método acrescenta a gramática, começando pela sua regra raiz, à sequência atual de elementos gramaticais. Para acrescentar uma regra gramatical específica, use o AppendRuleReference método.

Ver também

Aplica-se a

AppendRuleReference(String, String)

Acrescenta a regra especificada de um ficheiro de definição gramatical à sequência atual de elementos gramaticais.

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)

Parâmetros

path
String

O caminho do ficheiro ou Identificador Universal de Recursos (URI) do ficheiro que descreve uma gramática de reconhecimento de fala num formato suportado.

rule
String

O identificador da regra a acrescentar, ou null a regra raiz padrão do ficheiro gramatical.

Exemplos

O exemplo seguinte de C# cria uma gramática de reconhecimento de fala que utiliza a regra nomeada Cities num ficheiro SRGS local, cities.grxml. O conteúdo do ficheiro cities.grxml aparece abaixo do exemplo do código 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>

Observações

Importante

Utilizar uma instância deste tipo com dados não confiáveis é um risco de segurança. Use este objeto apenas com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.

O URI fornecido pelo path argumento pode ser local ou remoto. A aplicação deve ter acesso de leitura à localização dos ficheiros gramaticais especificados.

Podes usar o método usar para AppendRuleReference anexar um ficheiro gramatical que começa pela sua regra raiz.

Ver também

Aplica-se a