GrammarBuilder Construtores

Definição

Inicializa uma nova instância da classe GrammarBuilder.

Sobrecargas

GrammarBuilder()

Inicializa uma nova instância vazia da classe GrammarBuilder.

GrammarBuilder(Choices)

Inicializa uma nova instância da classe GrammarBuilder de um conjunto de alternativas.

GrammarBuilder(SemanticResultKey)

Inicializa uma nova instância da classe GrammarBuilder de uma chave semântica.

GrammarBuilder(SemanticResultValue)

Inicializa uma nova instância da classe GrammarBuilder de um valor semântico.

GrammarBuilder(String)

Inicializa uma nova instância da classe GrammarBuilder de uma sequência de palavras.

GrammarBuilder(String, SubsetMatchingMode)

Inicializa uma nova instância da classe GrammarBuilder para um subconjunto de uma sequência de palavras.

GrammarBuilder(GrammarBuilder, Int32, Int32)

Inicializa uma nova instância da classe GrammarBuilder de um elemento repetido.

GrammarBuilder(String, Int32, Int32)

Inicializa uma nova instância da classe GrammarBuilder da sequência de palavras em uma String e especifica quantas vezes a String pode ser repetida.

Comentários

Instâncias dessa classe também podem ser obtidas por conversões implícitas de outras classes ou combinando um GrammarBuilder objeto com um segundo objeto para de um novo GrammarBuilder. Para obter mais informações, consulte os Implicit métodos e Addition .

Para adicionar restrições a um existente GrammarBuilder, use os Addmétodos , Append, AppendDictation, AppendRuleReferencee e AppendWildcard e o Addition operador .

Importante

O reconhecedor de fala pode gerar uma exceção ao usar uma gramática de reconhecimento de fala que contém elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que poderiam modificar repetidamente o valor do mesmo elemento semântico.

Para obter mais informações sobre como criar e usar gramáticas de reconhecimento de fala, consulte Reconhecimento de Fala.

GrammarBuilder()

Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs

Inicializa uma nova instância vazia da classe GrammarBuilder.

public:
 GrammarBuilder();
public GrammarBuilder ();
Public Sub New ()

Exemplos

O exemplo a seguir usa GrammarBuilder objetos e Choices para construir uma gramática que pode reconhecer uma das duas frases, "Make background colorChoice" ou "Set background to colorChoice".

O exemplo usa um Choices objeto para criar uma lista de valores aceitáveis para colorChoice de uma matriz de String objetos. Um Choices objeto é análogo ao one-of elemento na especificação SRGS e contém um conjunto de frases alternativas, qualquer uma das quais pode ser reconhecida quando falada. O exemplo também usa um Choices objeto para agrupar uma matriz de dois GrammarBuilder objetos em um par de frases alternativas que a gramática resultante pode reconhecer. Palavras ou frases alternativas são um componente da maioria das gramáticas, e o Choices objeto fornece essa funcionalidade para gramáticas construídas com GrammarBuilder.

O exemplo finalmente cria um Grammar objeto de um GrammarBuilder construído a partir de um Choices objeto .

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the Grammar object from the result.
  GrammarBuilder bothPhrases = new GrammarBuilder();
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  bothPhrases.Append(bothChoices);
  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Comentários

Para adicionar regras a um objeto existenteGrammarBuilder, use os Addmétodos , Append, AppendDictationAppendRuleReference, e AppendWildcard e o Addition operador .

Importante

O reconhecedor de fala pode gerar uma exceção ao usar uma gramática de reconhecimento de fala que contém elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que poderiam modificar repetidamente o valor do mesmo elemento semântico.

Confira também

Aplica-se a

GrammarBuilder(Choices)

Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs

Inicializa uma nova instância da classe GrammarBuilder de um conjunto de alternativas.

public:
 GrammarBuilder(System::Speech::Recognition::Choices ^ alternateChoices);
public GrammarBuilder (System.Speech.Recognition.Choices alternateChoices);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.Choices -> System.Speech.Recognition.GrammarBuilder
Public Sub New (alternateChoices As Choices)

Parâmetros

alternateChoices
Choices

O conjunto de alternativas.

Exemplos

O exemplo a seguir usa GrammarBuilder objetos e Choices para construir uma gramática que pode reconhecer uma das duas frases, "Make background colorChoice" ou "Set background to colorChoice".

O exemplo usa um Choices objeto para criar uma lista de valores aceitáveis para colorChoice de uma matriz de String objetos. Um Choices objeto é análogo ao one-of elemento na especificação SRGS e contém um conjunto de frases alternativas, qualquer uma das quais pode ser reconhecida quando falada. O exemplo também usa um Choices objeto para agrupar uma matriz de dois GrammarBuilder objetos em um par de frases alternativas que a gramática resultante pode reconhecer. Palavras ou frases alternativas são um componente da maioria das gramáticas, e o Choices objeto fornece essa funcionalidade para gramáticas construídas com GrammarBuilder.

O exemplo finalmente cria um Grammar objeto de um GrammarBuilder construído a partir de um Choices objeto .

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the grammar from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);
  grammar.Name = "backgroundColor";
  return grammar;
}

Comentários

Para obter mais informações sobre como criar uma gramática de reconhecimento de fala que contém alternativas, consulte Usando opções para criar uma gramática GrammarBuilder.

Confira também

Aplica-se a

GrammarBuilder(SemanticResultKey)

Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs

Inicializa uma nova instância da classe GrammarBuilder de uma chave semântica.

public:
 GrammarBuilder(System::Speech::Recognition::SemanticResultKey ^ key);
public GrammarBuilder (System.Speech.Recognition.SemanticResultKey key);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultKey -> System.Speech.Recognition.GrammarBuilder
Public Sub New (key As SemanticResultKey)

Parâmetros

key
SemanticResultKey

A chave semântica.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala que pode reconhecer as duas frases, "Make background colorChoice" e "Set background to colorChoice", em que colorChoice é selecionado em um conjunto de cores. A gramática permite que um usuário fale qualquer um dos vários nomes de cores e retorna informações semânticas sobre o nome de cor reconhecido para o aplicativo.

O exemplo usa um único SemanticResultKey com o qual você pode recuperar o SemanticValue associado à cor falada pelo usuário. Por exemplo, se a entrada contiver a frase "Definir plano de fundo como vermelho", o resultado do reconhecimento conterá o valor semântico de "#FF0000", que você pode recuperar usando um manipulador para o SpeechRecognized evento.

O exemplo usa Stringobjetos , Choices, SemanticResultKeySemanticResultValue, e GrammarBuilder para criar as restrições contidas no último GrammarBuilder objeto, bothPhrases. Por fim, o exemplo constrói um Grammar objeto do concluído GrammarBuilder.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  // Include semantic information about each of the colors.
  Choices colorChoice = new Choices();

  GrammarBuilder colorBuilder = new GrammarBuilder("red");
  SemanticResultValue colorValue =
    new SemanticResultValue(colorBuilder, "#FF0000");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("green");
  colorValue = new SemanticResultValue(colorBuilder, "#00FF00");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("blue");
  colorValue = new SemanticResultValue(colorBuilder, "#0000FF");
  colorChoice.Add(new GrammarBuilder(colorValue));

  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // Create a Choices object for the two alternative phrases.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  // Create the semantic key for referencing the color information.
  SemanticResultKey colorKey =
    new SemanticResultKey("ColorCode", bothPhrases);
  bothPhrases = new GrammarBuilder(colorKey);

  // Construct the Grammar object from the GrammarBuilder.
  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Comentários

Ao criar uma GrammarBuilder instância de um SemanticResultValue objeto , você adiciona informações semânticas à gramática que podem ser retornadas no resultado do reconhecimento. Você pode acessar as informações semânticas no resultado do reconhecimento usando a Semantics propriedade de RecognizedPhrase, que está disponível no manipulador para o SpeechRecognized evento. Se o GrammarBuilder definir um SemanticResultKey, isso poderá ser usado para recuperar as informações semânticas em um resultado de reconhecimento associado à chave. Veja o exemplo de Append(SemanticResultKey), e também veja SemanticResultValue e SemanticResultKey.

Importante

Ao construir GrammarBuilder objetos que contêm SemanticResultValue instâncias ou SemanticResultKey , evite criar elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que poderiam modificar repetidamente a Value propriedade de um SemanticValue objeto . O reconhecedor de fala poderá lançar uma exceção se encontrar essas circunstâncias.

Confira também

Aplica-se a

GrammarBuilder(SemanticResultValue)

Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs

Inicializa uma nova instância da classe GrammarBuilder de um valor semântico.

public:
 GrammarBuilder(System::Speech::Recognition::SemanticResultValue ^ value);
public GrammarBuilder (System.Speech.Recognition.SemanticResultValue value);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultValue -> System.Speech.Recognition.GrammarBuilder
Public Sub New (value As SemanticResultValue)

Parâmetros

value
SemanticResultValue

O par nome-valor ou o valor semântico.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala que pode reconhecer as duas frases, "Make background colorChoice" e "Set background to colorChoice", em que colorChoice é selecionado em um conjunto de cores. A gramática permite que um usuário fale qualquer um dos vários nomes de cores e retorna informações semânticas sobre o nome de cor reconhecido para o aplicativo.

O exemplo usa um único SemanticResultKey com o qual você pode recuperar o SemanticValue associado à cor falada pelo usuário. Por exemplo, se a entrada contiver a frase "Definir plano de fundo como vermelho", o resultado do reconhecimento conterá o valor semântico de "#FF0000", que você pode recuperar usando um manipulador para o SpeechRecognized evento.

O exemplo usa Stringobjetos , Choices, SemanticResultKeySemanticResultValue, e GrammarBuilder para criar as restrições contidas no último GrammarBuilder objeto, bothPhrases. Por fim, o exemplo constrói um Grammar objeto do concluído GrammarBuilder.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  // Include semantic information about each of the colors.
  Choices colorChoice = new Choices();

  GrammarBuilder colorBuilder = new GrammarBuilder("red");
  SemanticResultValue colorValue =
    new SemanticResultValue(colorBuilder, "#FF0000");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("green");
  colorValue = new SemanticResultValue(colorBuilder, "#00FF00");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("blue");
  colorValue = new SemanticResultValue(colorBuilder, "#0000FF");
  colorChoice.Add(new GrammarBuilder(colorValue));

  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // Create a Choices for the two alternative phrases.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  // Create the semantic key for referencing the color information.
  SemanticResultKey colorKey =
    new SemanticResultKey("ColorCode", bothPhrases);
  bothPhrases = new GrammarBuilder(colorKey);

  // Construct the grammar from the grammar builder.
  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Comentários

Ao criar uma GrammarBuilder instância de um SemanticResultValue objeto , você adiciona informações semânticas à gramática que podem ser retornadas no resultado do reconhecimento. Você pode acessar as informações semânticas no resultado do reconhecimento usando a Semantics propriedade de RecognizedPhrase, que está disponível no manipulador para o SpeechRecognized evento. Se o GrammarBuilder definir um SemanticResultKey, isso poderá ser usado para recuperar as informações semânticas em um resultado de reconhecimento associado à chave. Veja o exemplo de Append(SemanticResultKey), e também veja SemanticResultValue e SemanticResultKey.

Importante

Ao construir GrammarBuilder objetos que contêm SemanticResultValue instâncias ou SemanticResultKey , evite criar elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que poderiam modificar repetidamente a Value propriedade de um SemanticValue objeto . O reconhecedor de fala poderá lançar uma exceção se encontrar essas circunstâncias.

Confira também

Aplica-se a

GrammarBuilder(String)

Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs

Inicializa uma nova instância da classe GrammarBuilder de uma sequência de palavras.

public:
 GrammarBuilder(System::String ^ phrase);
public GrammarBuilder (string phrase);
new System.Speech.Recognition.GrammarBuilder : string -> System.Speech.Recognition.GrammarBuilder
Public Sub New (phrase As String)

Parâmetros

phrase
String

A sequência de palavras.

Exemplos

O exemplo a seguir usa GrammarBuilder objetos e Choices para construir uma gramática que pode reconhecer uma das duas frases, "Make background colorChoice" ou "Set background to colorChoice".

Depois de criar uma lista de valores aceitáveis para colorChoice usando um Choices objeto , o exemplo inicializa dois GrammarBuilder objetos, makePhrase e setPhrase, usando uma cadeia de caracteres como argumento.

O exemplo finalmente cria um Grammar objeto de um Choices objeto convertido em um GrammarBuilder objeto .

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the Grammar object from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);
  grammar.Name = "backgroundColor";
  return grammar;
}

Comentários

A frase representa uma frase falada exata que a gramática de reconhecimento de fala pode reconhecer. Para obter mais informações sobre como criar uma gramática de reconhecimento de fala que contém cadeias de caracteres, consulte Usando cadeias de caracteres para criar uma gramática GrammarBuilder.

Confira também

Aplica-se a

GrammarBuilder(String, SubsetMatchingMode)

Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs

Inicializa uma nova instância da classe GrammarBuilder para um subconjunto de uma sequência de palavras.

public:
 GrammarBuilder(System::String ^ phrase, System::Speech::Recognition::SubsetMatchingMode subsetMatchingCriteria);
public GrammarBuilder (string phrase, System.Speech.Recognition.SubsetMatchingMode subsetMatchingCriteria);
new System.Speech.Recognition.GrammarBuilder : string * System.Speech.Recognition.SubsetMatchingMode -> System.Speech.Recognition.GrammarBuilder
Public Sub New (phrase As String, subsetMatchingCriteria As SubsetMatchingMode)

Parâmetros

phrase
String

A sequência de palavras.

subsetMatchingCriteria
SubsetMatchingMode

O modo correspondente que a gramática de reconhecimento de fala usa para reconhecer a frase.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala para cada SubsetMatchingMode valor e uma gramática para escolher entre as gramáticas do modo correspondente. Se o valor de phrase for "um dois três quatro cinco seis sete", a gramática Subsequence reconhecerá a entrada "dois três quatro", mas não a entrada "um três cinco". No entanto, a gramática subconjunto ordenado reconhece ambas as entradas.

private static IEnumerable<Grammar>
  CreateMatchingModeGrammars(string phrase)
{
  List<Grammar> grammars = new List<Grammar>(5);

  Choices modeChoice = new Choices();
  Type enumType = typeof(SubsetMatchingMode);
  foreach (SubsetMatchingMode mode in Enum.GetValues(enumType))
  {
    string modeName = Enum.GetName(enumType, mode);
    modeName = BreakAtCaps(modeName);

    GrammarBuilder builder = new GrammarBuilder(phrase, mode);
    Grammar modeGrammar = new Grammar(builder);
    modeGrammar.Name = modeName;
    modeGrammar.Enabled = false;
    grammars.Add(modeGrammar);

    modeChoice.Add(modeName);
  }

  Grammar choiceGrammar = new Grammar(modeChoice);
  choiceGrammar.Name = "choice";
  grammars.Add(choiceGrammar);

  return grammars;
}

// Insert spaces preceding each uppercase letter in a string.
private static string BreakAtCaps(string item)
{
  if (item == null || item.Length == 0)
  {
    return item;
  }

  StringBuilder sb = new StringBuilder(item[0].ToString());
  for (int i = 1; i < item.Length; i++)
  {
    char c = item[i];
    if (char.IsUpper(c))
    {
      sb.Append(" ");
    }
    sb.Append(c);
  }

  return sb.ToString();
}

Comentários

O phrase parâmetro representa a frase que a gramática de reconhecimento de fala pode reconhecer. O subsetMatchingMode parâmetro especifica um subconjunto da frase que pode ser falado para obter o reconhecimento bem-sucedido de toda a frase. Você pode usar isso para criar uma gramática com uma lista de entradas que têm nomes longos, sem exigir que os usuários falem um nome inteiro para corresponder a um item.

Para obter mais informações sobre os modos correspondentes, consulte SubsetMatchingMode. Para obter mais informações sobre como criar uma gramática de reconhecimento de fala que contém cadeias de caracteres, consulte Usando cadeias de caracteres para criar uma gramática GrammarBuilder.

Confira também

Aplica-se a

GrammarBuilder(GrammarBuilder, Int32, Int32)

Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs

Inicializa uma nova instância da classe GrammarBuilder de um elemento repetido.

public:
 GrammarBuilder(System::Speech::Recognition::GrammarBuilder ^ builder, int minRepeat, int maxRepeat);
public GrammarBuilder (System.Speech.Recognition.GrammarBuilder builder, int minRepeat, int maxRepeat);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.GrammarBuilder * int * int -> System.Speech.Recognition.GrammarBuilder
Public Sub New (builder As GrammarBuilder, minRepeat As Integer, maxRepeat As Integer)

Parâmetros

builder
GrammarBuilder

O elemento repetido.

minRepeat
Int32

O número mínimo de vezes que a entrada correspondente ao elemento definido por builder deve ocorrer para constituir uma correspondência.

maxRepeat
Int32

O número máximo de vezes que a entrada correspondente ao elemento definido por builder pode ocorrer para constituir uma correspondência.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala para pedir uma pizza. Ele começa com uma frase de abertura opcional, seguida de uma a quatro coberturas e fecha com a palavra "pizza".

private static Grammar CreatePizzaGrammar()
{

  // Create a Choices object from a string array of alternative toppings.
  Choices toppings = new Choices(new string[] {
    "cheese", "mushroom", "tomato", "onion",
    "anchovy", "chicken", "pepperoni"});

  // Create a GrammarBuilder and append the Choices object.
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);
  andToppings.Append(toppings);

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);
  gb.Append(toppings);
  gb.Append(new GrammarBuilder(andToppings, 0, 3));
  gb.Append("pizza");

  // Create the Grammar from the GrammarBuilder.
  Grammar grammar = new Grammar(gb);
  grammar.Name = "Pizza Order";

  return grammar;
}

Comentários

Se o valor de minRepeat for 0, o novo GrammarBuilder representará um elemento opcional.

O valor de minRepeat deve ser maior ou igual a 0 e menor ou igual ao valor de maxRepeat.

Importante

Ao especificar repetições para GrammarBuilder objetos que contêm SemanticResultValue instâncias ou SemanticResultKey , evite criar elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que poderiam modificar repetidamente a Value propriedade de um SemanticValue objeto . O reconhecedor de fala poderá lançar uma exceção se encontrar essas circunstâncias.

Confira também

Aplica-se a

GrammarBuilder(String, Int32, Int32)

Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs
Origem:
GrammarBuilder.cs

Inicializa uma nova instância da classe GrammarBuilder da sequência de palavras em uma String e especifica quantas vezes a String pode ser repetida.

public:
 GrammarBuilder(System::String ^ phrase, int minRepeat, int maxRepeat);
public GrammarBuilder (string phrase, int minRepeat, int maxRepeat);
new System.Speech.Recognition.GrammarBuilder : string * int * int -> System.Speech.Recognition.GrammarBuilder
Public Sub New (phrase As String, minRepeat As Integer, maxRepeat As Integer)

Parâmetros

phrase
String

A sequência de palavras repetida.

minRepeat
Int32

O número mínimo de vezes que a entrada correspondente à frase deve ocorrer para constituir uma correspondência.

maxRepeat
Int32

O número máximo de vezes que a entrada correspondente à frase pode ocorrer para constituir uma correspondência.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala para pedir uma pizza. Ele começa com uma frase de abertura opcional, seguida de uma a quatro coberturas e fecha com a palavra "pizza".

private static Grammar CreatePizzaGrammar()
{

  // Create a Choices object with alternatives for toppings.
  Choices toppings = new Choices(new string[] {
    "cheese", "mushroom", "tomato", "onion",
    "anchovy", "chicken", "pepperoni"});

  // Create a GrammarBuilder and append the Choices object.
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);
  andToppings.Append(toppings);

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);
  gb.Append(toppings);
  gb.Append(new GrammarBuilder(andToppings, 0, 3));
  gb.Append("pizza");

  // Create the Grammar from the GrammarBuilder.
  Grammar grammar = new Grammar(gb);
  grammar.Name = "Pizza Order";

  return grammar;
}

Comentários

Se o valor de minRepeat for 0, o novo GrammarBuilder representará um elemento opcional.

O valor de minRepeat deve ser maior ou igual a 0 e menor ou igual ao valor de maxRepeat. Para obter mais informações sobre como criar uma gramática de reconhecimento de fala que contenha cadeias de caracteres, consulte Usando cadeias de caracteres para criar uma gramática GrammarBuilder.

Confira também

Aplica-se a