Grammar Construtores

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

protected:
 Grammar();

protected Grammar();

Protected Sub New ()

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::Speech::Recognition::SrgsGrammar::SrgsDocument ^ srgsDocument, System::String ^ ruleName, Uri ^ baseUri, cli::array <System::Object ^> ^ parameters);

public Grammar(System.Speech.Recognition.SrgsGrammar.SrgsDocument? srgsDocument, string? ruleName, Uri? baseUri, object[]? parameters);

public Grammar(System.Speech.Recognition.SrgsGrammar.SrgsDocument srgsDocument, string ruleName, Uri baseUri, object[] parameters);

new System.Speech.Recognition.Grammar : System.Speech.Recognition.SrgsGrammar.SrgsDocument * string * Uri * obj[] -> System.Speech.Recognition.Grammar

Public Sub New (srgsDocument As SrgsDocument, ruleName As String, baseUri As Uri, parameters As Object())

Parâmetros

Exceções

Observações

Também podem ser especificados parâmetros para um manipulador de inicialização.

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::IO::Stream ^ stream, System::String ^ ruleName, Uri ^ baseUri, cli::array <System::Object ^> ^ parameters);

public Grammar(System.IO.Stream stream, string? ruleName, Uri? baseUri, object[]? parameters);

public Grammar(System.IO.Stream stream, string ruleName, Uri baseUri, object[] parameters);

new System.Speech.Recognition.Grammar : System.IO.Stream * string * Uri * obj[] -> System.Speech.Recognition.Grammar

Public Sub New (stream As Stream, ruleName As String, baseUri As Uri, parameters As Object())

Parâmetros

Exceções

Observações

Também podem ser especificados parâmetros para um manipulador de inicialização.

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::Speech::Recognition::SrgsGrammar::SrgsDocument ^ srgsDocument, System::String ^ ruleName, Uri ^ baseUri);

public Grammar(System.Speech.Recognition.SrgsGrammar.SrgsDocument? srgsDocument, string? ruleName, Uri? baseUri);

public Grammar(System.Speech.Recognition.SrgsGrammar.SrgsDocument srgsDocument, string ruleName, Uri baseUri);

new System.Speech.Recognition.Grammar : System.Speech.Recognition.SrgsGrammar.SrgsDocument * string * Uri -> System.Speech.Recognition.Grammar

Public Sub New (srgsDocument As SrgsDocument, ruleName As String, baseUri As Uri)

Parâmetros

Exceções

Exemplos

O exemplo seguinte cria uma gramática de reconhecimento de fala em um SrgsDocument que contém uma referência relativa à regra ao ficheiro cities.xml e especifica um URI a usar para resolver a referência da regra. O conteúdo do ficheiro cities.xml aparece no exemplo XML que segue o exemplo de C#.

private static Grammar CreateSrgsDocumentGrammar3()
{
  // Create the SrgsDocument.
  SrgsDocument document = new SrgsDocument();

  // Create the Main rule and add it to the document.
  SrgsRule mainRule = new SrgsRule("Main");
  mainRule.Scope = SrgsRuleScope.Public;

  SrgsItem item = new SrgsItem("Can I get a shuttle in");

  // Create a relative URI for the cities rule.
  Uri ruleUri = new Uri("cities.xml#Cities", UriKind.Relative);

  item.Add(new SrgsRuleRef(ruleUri));

  mainRule.Add(item);
  document.Rules.Add(mainRule);

  // Set the root rule.
  document.Root = mainRule;

  // Create the grammar.
  Uri baseUri = new Uri(@"file://c:\temp\");
  Grammar citiesGrammar = new Grammar(document, null, baseUri);
  citiesGrammar.Name = "SrgsDocument Cities Grammar 3";

  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>

Observações

Este construtor não passa quaisquer parâmetros para o manipulador de inicialização, e não SrgsDocument deve conter um tratador de inicialização que exija argumentos.

Este construtor não valida baseUri. No entanto, o LoadGrammar método de um SpeechRecognitionEngine objeto ou SpeechRecognizer lança uma exceção se não conseguir resolver todas as referências de regras na descrição gramatical. Se baseUri não nullfor , o LoadGrammar método usa o URI para resolver quaisquer referências de regras que não possa resolver de outra forma. Se baseUri representa um ficheiro, então o LoadGrammar método utiliza tanto o ficheiro designado como o diretório do ficheiro quando tenta resolver referências de regras relativas.

Ver também

• System.Speech.Recognition.SrgsGrammar
• SrgsDocument
• SpeechRecognitionEngine
• SpeechRecognizer
• Especificação da Gramática de Reconhecimento de Fala

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::Speech::Recognition::SrgsGrammar::SrgsDocument ^ srgsDocument, System::String ^ ruleName, cli::array <System::Object ^> ^ parameters);

public Grammar(System.Speech.Recognition.SrgsGrammar.SrgsDocument? srgsDocument, string? ruleName, object[]? parameters);

public Grammar(System.Speech.Recognition.SrgsGrammar.SrgsDocument srgsDocument, string ruleName, object[] parameters);

new System.Speech.Recognition.Grammar : System.Speech.Recognition.SrgsGrammar.SrgsDocument * string * obj[] -> System.Speech.Recognition.Grammar

Public Sub New (srgsDocument As SrgsDocument, ruleName As String, parameters As Object())

Parâmetros

Exceções

Observações

Também podem ser especificados parâmetros para um manipulador de inicialização.

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::IO::Stream ^ stream, System::String ^ ruleName, Uri ^ baseUri);

public Grammar(System.IO.Stream stream, string? ruleName, Uri? baseUri);

public Grammar(System.IO.Stream stream, string ruleName, Uri baseUri);

new System.Speech.Recognition.Grammar : System.IO.Stream * string * Uri -> System.Speech.Recognition.Grammar

Public Sub New (stream As Stream, ruleName As String, baseUri As Uri)

Parâmetros

Exceções

Exemplos

O exemplo seguinte carrega um ficheiro SRGS local (shuttle.xml) a partir de um fluxo de ficheiros. O ficheiro contém uma referência relativa a uma regra no ficheiro cities.xml e especifica um URI base para usar para resolver a referência da regra. O conteúdo dos ficheiros shuttle.xml e cities.xml aparece nos exemplos XML que seguem o exemplo de C#.

private static Grammar CreateGrammarFromStream3()
{
  FileInfo file = new FileInfo(@".\shuttle.xml");
  Uri baseUri = new Uri(@"file://c:\temp\");
  Grammar citiesGrammar = new Grammar(file.OpenRead(), null, baseUri);
  citiesGrammar.Name = "Stream Cities Grammar 3";
  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">

  <!-- shuttle.xml:
    Defines an SRGS grammar for asking about a shuttle service. This grammar
    references a Cities rule that is defined in the cities.xml grammar. -->

  <rule id="Main">
    <item>
      Can I get a shuttle in
      <ruleref uri="cities.xml#Cities"/>
    </item>
  </rule>
</grammar>

<?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>

Observações

Este construtor não passa quaisquer parâmetros ao manipulador de inicialização, e a descrição não deve definir um handler de inicialização que exija argumentos.

Este construtor pode criar uma Grammar instância a partir dos seguintes formatos:

• Ficheiros em formato XML que cumprem a Especificação de Gramática de Reconhecimento de Fala do W3C (SRGS) Versão 1.0

• Gramáticas que foram compiladas para um ficheiro binário com uma extensão de ficheiro .cfg

Este construtor compila ficheiros gramaticais em formato XML para um formato binário para os otimizar para carregamento e consumo por um motor de reconhecimento de voz. Pode reduzir o tempo necessário para construir um Grammar objeto a partir de uma gramática em formato XML compilando a gramática antecipadamente, usando um dos Compile métodos.

Este construtor não valida baseUri. No entanto, o LoadGrammar método de um SpeechRecognitionEngine objeto ou SpeechRecognizer lança uma exceção se não conseguir resolver todas as referências de regras na descrição gramatical. Se baseUri não nullfor , o LoadGrammar método usa o URI para resolver quaisquer referências de regras que não possa resolver de outra forma. Se baseUri representa um ficheiro, então utiliza LoadGrammar tanto o ficheiro designado como o diretório do ficheiro quando tenta resolver referências relativas às regras.

Ver também

• Stream
• SpeechRecognizer
• SpeechRecognitionEngine
• Especificação da Gramática de Reconhecimento de Fala

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::IO::Stream ^ stream, System::String ^ ruleName, cli::array <System::Object ^> ^ parameters);

public Grammar(System.IO.Stream stream, string? ruleName, object[]? parameters);

public Grammar(System.IO.Stream stream, string ruleName, object[] parameters);

new System.Speech.Recognition.Grammar : System.IO.Stream * string * obj[] -> System.Speech.Recognition.Grammar

Public Sub New (stream As Stream, ruleName As String, parameters As Object())

Parâmetros

Exceções

Observações

Também podem ser especificados parâmetros para um manipulador de inicialização.

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::String ^ path, System::String ^ ruleName, cli::array <System::Object ^> ^ parameters);

public Grammar(string path, string? ruleName, object[]? parameters);

public Grammar(string path, string ruleName, object[] parameters);

new System.Speech.Recognition.Grammar : string * string * obj[] -> System.Speech.Recognition.Grammar

Public Sub New (path As String, ruleName As String, parameters As Object())

Parâmetros

Exceções

Observações

Também podem ser especificados parâmetros para um manipulador de inicialização.

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::Speech::Recognition::SrgsGrammar::SrgsDocument ^ srgsDocument, System::String ^ ruleName);

public Grammar(System.Speech.Recognition.SrgsGrammar.SrgsDocument? srgsDocument, string? ruleName);

public Grammar(System.Speech.Recognition.SrgsGrammar.SrgsDocument srgsDocument, string ruleName);

new System.Speech.Recognition.Grammar : System.Speech.Recognition.SrgsGrammar.SrgsDocument * string -> System.Speech.Recognition.Grammar

Public Sub New (srgsDocument As SrgsDocument, ruleName As String)

Parâmetros

Exceções

Exemplos

O exemplo seguinte cria uma gramática de reconhecimento de fala numa SrgsDocument instância e especifica uma regra a usar como regra raiz da gramática. O exemplo constrói um Grammar objeto a partir da SrgsDocument instância e carrega-o no motor de reconhecimento de voz.

using System;
using System.Speech.Recognition;
using System.Speech.Recognition.SrgsGrammar;

namespace SampleRecognition
{
  class Program
  {
    static void Main(string[] args)

    // Initialize an in-process speech recognition engine.
    {
      using (SpeechRecognitionEngine recognizer =
         new SpeechRecognitionEngine())
      {

        // Create the SrgsDocument.
        SrgsDocument document = new SrgsDocument();

        // Create the Cities rule and add it to the document.
        SrgsRule citiesRule = new SrgsRule("Cities");
        citiesRule.Scope = SrgsRuleScope.Public;

        SrgsOneOf cityChoice = new SrgsOneOf();
        cityChoice.Add(new SrgsItem("Seattle"));
        cityChoice.Add(new SrgsItem("Los Angeles"));
        cityChoice.Add(new SrgsItem("New York"));
        cityChoice.Add(new SrgsItem("Miami"));

        citiesRule.Add(cityChoice);
        document.Rules.Add(citiesRule);

        // Create the Main rule and add it to the document.
        SrgsRule mainRule = new SrgsRule("Main");
        mainRule.Scope = SrgsRuleScope.Public;

        mainRule.Add(new SrgsItem("I would like to fly from"));
        mainRule.Add(new SrgsRuleRef(citiesRule));
        mainRule.Add(new SrgsItem("to"));
        mainRule.Add(new SrgsRuleRef(citiesRule));

        document.Rules.Add(mainRule);

        // Create the Grammar object and specify which rule to use as the root.
        Grammar citiesGrammar = new Grammar(document,"Main");

        // Load the grammar object to the recognizer.
        recognizer.LoadGrammarAsync(citiesGrammar);

        // Attach a handler for the SpeechRecognized event.
        recognizer.SpeechRecognized +=
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);

        // Set the input to the recognizer.
        recognizer.SetInputToDefaultAudioDevice();

        // Start recognition.
        recognizer.RecognizeAsync();
        Console.WriteLine("Starting asynchronous recognition...");

        // Keep the console window open.
        Console.ReadLine();
      }
    }

    // Handle the SpeechRecognized event.
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)
    {
      Console.WriteLine("  Speech recognized: " + e.Result.Text);
    }
  }
}

Observações

Este construtor não passa quaisquer parâmetros para o manipulador de inicialização, e não SrgsDocument deve conter um tratador de inicialização que exija argumentos.

Para criar um Grammar objeto a partir de e SrgsDocument especificar um URI base para resolver referências de regras relativas, use o Grammar construtor.

Ver também

• System.Speech.Recognition.SrgsGrammar
• SrgsDocument
• SpeechRecognizer
• SpeechRecognitionEngine
• Especificação da Gramática de Reconhecimento de Fala

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::IO::Stream ^ stream, System::String ^ ruleName);

public Grammar(System.IO.Stream stream, string? ruleName);

public Grammar(System.IO.Stream stream, string ruleName);

new System.Speech.Recognition.Grammar : System.IO.Stream * string -> System.Speech.Recognition.Grammar

Public Sub New (stream As Stream, ruleName As String)

Parâmetros

Exceções

Exemplos

O exemplo seguinte carrega um ficheiro SRGS local (cities.xml) a partir de um fluxo de ficheiros e especifica uma regra a usar como raiz da gramática. O conteúdo do ficheiro cities.xml aparece no exemplo XML que segue o exemplo de C#.

// Load a cities grammar from an I/O stream, use a specific
// rule as the root of the grammar, and return the new grammar.
private static Grammar CreateGrammarFromStream2()
{
  FileInfo file = new FileInfo(@"c:\temp\cities.xml");
  Grammar citiesGrammar = new Grammar(file.OpenRead(), "Main");
  citiesGrammar.Name = "Stream 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.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>

Observações

Este construtor não passa quaisquer parâmetros ao manipulador de inicialização, e a descrição não deve definir um handler de inicialização que exija argumentos.

Este construtor pode criar uma Grammar instância a partir dos seguintes formatos:

• Ficheiros em formato XML que cumprem a Especificação de Gramática de Reconhecimento de Fala do W3C (SRGS) Versão 1.0

• Gramáticas que foram compiladas para um ficheiro binário com uma extensão de ficheiro .cfg

Este construtor compila ficheiros gramaticais em formato XML para um formato binário para os otimizar para carregamento e consumo por um motor de reconhecimento de voz. Pode reduzir o tempo necessário para construir um Grammar objeto a partir de uma gramática em formato XML compilando a gramática antecipadamente, usando um dos Compile métodos.

Para criar um Grammar a partir de um fluxo e especificar um URI base para usar na resolução de referências relativas de regras, use o Grammar construtor.

Ver também

• Stream
• SpeechRecognitionEngine
• SpeechRecognizer
• Especificação da Gramática de Reconhecimento de Fala

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::String ^ path);

public Grammar(string path);

new System.Speech.Recognition.Grammar : string -> System.Speech.Recognition.Grammar

Public Sub New (path As String)

Parâmetros

Exceções

Exemplos

O exemplo seguinte carrega uma gramática de reconhecimento de voz a partir de um ficheiro SRGS local para construir um Grammar objeto. O conteúdo do ficheiro cities.xml aparece no exemplo XML que segue o exemplo de C#.

// Load a cities grammar from a local file and
// return the new grammar.
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>

Observações

Este construtor não passa quaisquer parâmetros ao manipulador de inicialização, e a descrição não deve definir um handler de inicialização que exija argumentos.

Este construtor pode criar uma Grammar instância a partir dos seguintes formatos:

• Ficheiros em formato XML que cumprem a Especificação de Gramática de Reconhecimento de Fala do W3C (SRGS) Versão 1.0

• Gramáticas que foram compiladas para um ficheiro binário com uma extensão de ficheiro .cfg

Este construtor compila ficheiros gramaticais em formato XML para um formato binário para os otimizar para carregamento e consumo por um motor de reconhecimento de voz. Pode reduzir o tempo necessário para construir um Grammar objeto a partir de uma gramática em formato XML compilando a gramática antecipadamente, usando um dos Compile métodos.

Uma gramática SRGS pode definir uma regra raiz. Para criar um Grammar objeto a partir de uma cadeia e especificar uma regra raiz, use o Grammar construtor.

Para criar um Grammar objeto que especifique um URI base para resolver referências de regras relativas, abra o ficheiro num fluxo de ficheiros e use o Grammar.Grammar construtor.

Ver também

• SpeechRecognitionEngine
• SpeechRecognizer
• Especificação da Gramática de Reconhecimento de Fala

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::Speech::Recognition::SrgsGrammar::SrgsDocument ^ srgsDocument);

public Grammar(System.Speech.Recognition.SrgsGrammar.SrgsDocument? srgsDocument);

public Grammar(System.Speech.Recognition.SrgsGrammar.SrgsDocument srgsDocument);

new System.Speech.Recognition.Grammar : System.Speech.Recognition.SrgsGrammar.SrgsDocument -> System.Speech.Recognition.Grammar

Public Sub New (srgsDocument As SrgsDocument)

Parâmetros

Exceções

Exemplos

O exemplo seguinte cria uma gramática de reconhecimento de fala numa SrgsDocument instância, que é depois usada para construir um Grammar objeto.

private static Grammar CreateSrgsDocumentGrammar()
{
  // Create the SrgsDocument.
  SrgsDocument document = new SrgsDocument();

  // Create the Cities rule and add it to the document.
  SrgsRule citiesRule = new SrgsRule("Cities");

  SrgsOneOf cityChoice = new SrgsOneOf();
  cityChoice.Add(new SrgsItem("Seattle"));
  cityChoice.Add(new SrgsItem("Los Angeles"));
  cityChoice.Add(new SrgsItem("New York"));
  cityChoice.Add(new SrgsItem("Miami"));

  citiesRule.Add(cityChoice);
  document.Rules.Add(citiesRule);

  // Create the Main rule and add it to the document.
  SrgsRule mainRule = new SrgsRule("Main");
  mainRule.Scope = SrgsRuleScope.Public;

  SrgsItem item = new SrgsItem("I would like to fly from");
  item.Add(new SrgsRuleRef(citiesRule));
  item.Add(new SrgsText("to"));
  item.Add(new SrgsRuleRef(citiesRule));

  mainRule.Add(item);
  document.Rules.Add(mainRule);

  // Set the root rule.
  document.Root = mainRule;

  // Create the Grammar object.
  Grammar citiesGrammar = new Grammar(document);
  citiesGrammar.Name = "SrgsDocument Cities Grammar";

  return citiesGrammar;
}

Observações

Este construtor não passa quaisquer parâmetros para o manipulador de inicialização, e não SrgsDocument deve conter um tratador de inicialização que exija argumentos.

A SrgsDocument pode ter uma regra raiz. Para criar um Grammar objeto que especifique uma regra raiz, use o Grammar construtor or Grammar .

Para criar um reconhecimento Grammar de voz a partir de um SrgsDocument e especificar um URI base a usar para resolver referências de regras relativas, use o Grammar construtor.

Ver também

• System.Speech.Recognition.SrgsGrammar
• SrgsDocument
• SpeechRecognizer
• SpeechRecognitionEngine
• Especificação da Gramática de Reconhecimento de Fala

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::String ^ path, System::String ^ ruleName);

public Grammar(string path, string ruleName);

new System.Speech.Recognition.Grammar : string * string -> System.Speech.Recognition.Grammar

Public Sub New (path As String, ruleName As String)

Parâmetros

Exceções

Exemplos

O exemplo seguinte carrega um ficheiro SRGS local (cities.xml) a partir de um ficheiro e especifica uma regra a usar como raiz da gramática. O conteúdo do ficheiro cities.xml aparece no exemplo XML que segue o exemplo de C#.

// Load a cities grammar from a local file, use a specific
// rule as the root of the grammar, and return the new grammar.
private static Grammar CreateGrammarFromFile2()
{
  Grammar citiesGrammar = new Grammar(@"c:\temp\cities.xml", "Main");
  citiesGrammar.Name = "SRGS File 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.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>

Observações

Este construtor não passa quaisquer parâmetros ao manipulador de inicialização, e a descrição não deve definir um handler de inicialização que exija argumentos.

Este construtor pode criar uma Grammar instância a partir dos seguintes formatos:

• Ficheiros em formato XML que cumprem a Especificação de Gramática de Reconhecimento de Fala do W3C (SRGS) Versão 1.0

• Gramáticas que foram compiladas para um ficheiro binário com uma extensão de ficheiro .cfg

Este construtor compila ficheiros gramaticais em formato XML para um formato binário para os otimizar para carregamento e consumo por um motor de reconhecimento de voz. Pode reduzir o tempo necessário para construir um Grammar objeto a partir de uma gramática em formato XML compilando a gramática antecipadamente, usando um dos Compile métodos.

Para criar um Grammar que especifique um URI base para resolver referências relativas às regras, abra um fluxo de ficheiros para o ficheiro e use o Grammar construtor.

Ver também

• SpeechRecognitionEngine
• SpeechRecognizer
• Especificação da Gramática de Reconhecimento de Fala

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::Speech::Recognition::GrammarBuilder ^ builder);

public Grammar(System.Speech.Recognition.GrammarBuilder builder);

new System.Speech.Recognition.Grammar : System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.Grammar

Public Sub New (builder As GrammarBuilder)

Parâmetros

Exemplos

O exemplo seguinte cria uma gramática de reconhecimento de fala usando Choices objetos e GrammarBuilder . O Grammar construtor cria um Grammar objeto a partir do GrammarBuilder objeto.

// Create a grammar using a GrammarBuilder and return the new grammar.
private static Grammar CreateGrammarBuilderGrammar()
{
  GrammarBuilder builder = new GrammarBuilder();

  Choices cityChoice = new Choices (new string[]
  {"Seattle", "New York", "Miami", "Los Angeles"});

  builder.Append("I would like to fly from");
  builder.Append(cityChoice);
  builder.Append("to");
  builder.Append(cityChoice);

  Grammar citiesGrammar = new Grammar(builder);
  citiesGrammar.Name = "GrammarBuilder Cities Grammar";

  return citiesGrammar;
}

Ver também

• GrammarBuilder
• SpeechRecognitionEngine
• SpeechRecognizer

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

Origem:

Grammar.cs

public:
 Grammar(System::IO::Stream ^ stream);

public Grammar(System.IO.Stream stream);

new System.Speech.Recognition.Grammar : System.IO.Stream -> System.Speech.Recognition.Grammar

Public Sub New (stream As Stream)

Parâmetros

Exceções

Exemplos

O exemplo seguinte cria uma gramática de reconhecimento de fala a partir de um ficheiro SRGS local (cities.xml) usando um fluxo de ficheiros. O conteúdo do ficheiro cities.xml aparece seguindo o exemplo de C#.

// Load a cities grammar from an I/O stream and
// return the new grammar.
private static Grammar CreateGrammarFromStream()
{
  string fileName = @"c:\temp\cities.xml";
  Grammar citiesGrammar =
    new Grammar(new FileStream(fileName, FileMode.Open));
  citiesGrammar.Name = "Stream 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>

Observações

Este construtor não passa quaisquer parâmetros ao manipulador de inicialização, e a descrição não deve definir um handler de inicialização que exija argumentos.

Este construtor pode criar uma Grammar instância a partir dos seguintes formatos:

• Ficheiros em formato XML que cumprem a Especificação de Gramática de Reconhecimento de Fala do W3C (SRGS) Versão 1.0

• Gramáticas que foram compiladas para um ficheiro binário com uma extensão de ficheiro .cfg

Este construtor compila ficheiros gramaticais em formato XML para um formato binário para os otimizar para carregamento e consumo por um motor de reconhecimento de voz. Pode reduzir o tempo necessário para construir um Grammar objeto a partir de uma gramática em formato XML compilando a gramática antecipadamente, usando um dos Compile métodos.

Uma gramática SRGS pode definir uma regra raiz. Para criar um Grammar objeto a partir de um fluxo e especificar uma regra raiz, use o Grammar construtor ou Grammar .

Para criar um Grammar objeto a partir de um fluxo e especificar um URI base para resolver referências de regras relativas, use o Grammar construtor.

Ver também

• Stream
• SpeechRecognitionEngine
• SpeechRecognizer
• Especificação da Gramática de Reconhecimento de Fala