Compartilhar via


GrammarBuilder.Add Método

Definição

Cria um novo GrammarBuilder que contém uma sequência de dois elementos de gramática.

Sobrecargas

Add(Choices, GrammarBuilder)

Cria um novo GrammarBuilder que contém um objeto Choices seguido por um objeto GrammarBuilder.

Add(GrammarBuilder, Choices)

Cria um novo GrammarBuilder que contém um objeto GrammarBuilder seguido por um objeto Choices.

Add(GrammarBuilder, GrammarBuilder)

Cria um novo GrammarBuilder que contém uma sequência de dois objetos GrammarBuilder.

Add(GrammarBuilder, String)

Cria um novo GrammarBuilder que contém um objeto GrammarBuilder seguido por uma frase.

Add(String, GrammarBuilder)

Cria um novo GrammarBuilder que contém uma frase seguida por um objeto GrammarBuilder.

Comentários

Os métodos estáticos Add fornecem outro mecanismo pelo qual você pode combinar vários tipos para criar diversidade e flexibilidade em gramáticas criadas com GrammarBuilder. Esses métodos correspondem aos métodos estáticos Addition , que também são definidos na GrammarBuilder classe . A ordem dos parâmetros determina a ordem dos elementos no novo GrammarBuilder.

Um GrammarBuilder também pode ser obtido de Choicesobjetos , SemanticResultKey, SemanticResultValuee String . Para obter mais informações, consulte os Implicit operadores e Addition .

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.

Add(Choices, GrammarBuilder)

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

Cria um novo GrammarBuilder que contém um objeto Choices seguido por um objeto GrammarBuilder.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::Choices ^ choices, System::Speech::Recognition::GrammarBuilder ^ builder);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.Choices choices, System.Speech.Recognition.GrammarBuilder builder);
static member Add : System.Speech.Recognition.Choices * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (choices As Choices, builder As GrammarBuilder) As GrammarBuilder

Parâmetros

choices
Choices

O primeiro elemento de gramática, que representa um conjunto de alternativas.

builder
GrammarBuilder

O segundo elemento de gramática.

Retornos

Um GrammarBuilder para a sequência do elemento choices seguido pelo elemento builder.

Comentários

GrammarBuilder dá suporte a conversões implícitas das seguintes classes:

Esse método aceita os objetos listados acima para o builder parâmetro .

Para obter mais informações, consulte os Implicit operadores e Addition .

Importante

Ao combinar Choices objetos e GrammarBuilder que contêm SemanticResultValue ou SemanticResultKey instâncias, 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á gerar uma exceção se encontrar essas circunstâncias. Para obter mais informações sobre como criar uma gramática de reconhecimento de fala que contenha informações semânticas, consulte Adicionar Semântica a uma Gramática GrammarBuilder.

Confira também

Aplica-se a

Add(GrammarBuilder, Choices)

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

Cria um novo GrammarBuilder que contém um objeto GrammarBuilder seguido por um objeto Choices.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder, System::Speech::Recognition::Choices ^ choices);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.GrammarBuilder builder, System.Speech.Recognition.Choices choices);
static member Add : System.Speech.Recognition.GrammarBuilder * System.Speech.Recognition.Choices -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder As GrammarBuilder, choices As Choices) As GrammarBuilder

Parâmetros

builder
GrammarBuilder

O primeiro elemento de gramática.

choices
Choices

O segundo elemento de gramática, que representa um conjunto de alternativas.

Retornos

Um GrammarBuilder para a sequência do elemento builder seguido pelo elemento choices.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala que pode reconhecer as duas frases, "Tornar cor da tela de fundo" e "Definir plano de fundo como cor", em que a cor é selecionada em um conjunto de cores. Vários tipos são usados para criar a gramática final, como String, Choicese GrammarBuilder objetos. Os operadores de conversão explícitos nas chamadas para os Add métodos são opcionais.

private Grammar CreateColorGrammar()
{

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

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // 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});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Comentários

GrammarBuilder dá suporte a conversões implícitas das seguintes classes:

Esse método aceita os objetos listados acima para o builder parâmetro .

Para obter mais informações, consulte os Implicit operadores e Addition .

Importante

Ao combinar Choices objetos e GrammarBuilder que contêm SemanticResultValue ou SemanticResultKey instâncias com outros elementos gramaticais, 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á gerar uma exceção se encontrar essas circunstâncias.

Confira também

Aplica-se a

Add(GrammarBuilder, GrammarBuilder)

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

Cria um novo GrammarBuilder que contém uma sequência de dois objetos GrammarBuilder.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder1, System::Speech::Recognition::GrammarBuilder ^ builder2);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.GrammarBuilder builder1, System.Speech.Recognition.GrammarBuilder builder2);
static member Add : System.Speech.Recognition.GrammarBuilder * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder1 As GrammarBuilder, builder2 As GrammarBuilder) As GrammarBuilder

Parâmetros

builder1
GrammarBuilder

O primeiro elemento de gramática.

builder2
GrammarBuilder

O segundo elemento de gramática.

Retornos

Um GrammarBuilder para a sequência do elemento builder1 seguido pelo elemento builder2.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala que pode reconhecer as duas frases, "Tornar cor da tela de fundo" e "Definir plano de fundo como cor", em que a cor é selecionada em um conjunto de cores. Vários tipos são usados para criar a gramática final, como String, Choicese GrammarBuilder objetos. Os operadores de conversão explícitos nas chamadas para os Add métodos são opcionais.

private Grammar CreateColorGrammar()
{

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

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // 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});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Comentários

GrammarBuilder dá suporte a conversões implícitas das seguintes classes:

Esse método aceita os objetos listados acima para o builder1 parâmetro ou builder2 .

Para obter mais informações, consulte os Implicit operadores e Addition .

Importante

Ao combinar Choices objetos e GrammarBuilder que contêm SemanticResultValue ou SemanticResultKey instâncias com outros elementos gramaticais, 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á gerar uma exceção se encontrar essas circunstâncias.

Confira também

Aplica-se a

Add(GrammarBuilder, String)

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

Cria um novo GrammarBuilder que contém um objeto GrammarBuilder seguido por uma frase.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder, System::String ^ phrase);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.GrammarBuilder builder, string phrase);
static member Add : System.Speech.Recognition.GrammarBuilder * string -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder As GrammarBuilder, phrase As String) As GrammarBuilder

Parâmetros

builder
GrammarBuilder

O primeiro elemento de gramática.

phrase
String

O segundo elemento de gramática, que representa uma sequência de palavras.

Retornos

Um GrammarBuilder para a sequência do elemento builder seguido pelo elemento phrase.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala que pode reconhecer as duas frases, "Tornar cor da tela de fundo" e "Definir plano de fundo como cor", em que a cor é selecionada em um conjunto de cores. Vários tipos são usados para criar a gramática final, como String, Choicese GrammarBuilder objetos. Os operadores de conversão explícitos nas chamadas para os Add métodos são opcionais.

private Grammar CreateColorGrammar()
{

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

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // 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});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Comentários

GrammarBuilder dá suporte a conversões implícitas das seguintes classes:

Esse método aceita os objetos listados acima para o builder parâmetro .

Para obter mais informações, consulte os Implicit operadores e Addition .

Confira também

Aplica-se a

Add(String, GrammarBuilder)

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

Cria um novo GrammarBuilder que contém uma frase seguida por um objeto GrammarBuilder.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::String ^ phrase, System::Speech::Recognition::GrammarBuilder ^ builder);
public static System.Speech.Recognition.GrammarBuilder Add (string phrase, System.Speech.Recognition.GrammarBuilder builder);
static member Add : string * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (phrase As String, builder As GrammarBuilder) As GrammarBuilder

Parâmetros

phrase
String

O primeiro elemento de gramática, que representa uma sequência de palavras.

builder
GrammarBuilder

O segundo elemento de gramática.

Retornos

Um GrammarBuilder para a sequência do elemento phrase seguido pelo elemento builder.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala que pode reconhecer as duas frases, "Tornar cor da tela de fundo" e "Definir plano de fundo como cor", em que a cor é selecionada em um conjunto de cores. Vários tipos são usados para criar a gramática final, como String, Choicese GrammarBuilder objetos. Os operadores de conversão explícitos nas chamadas para os Add métodos são opcionais.

private Grammar CreateColorGrammar()
{

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

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // 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});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Comentários

GrammarBuilder dá suporte a conversões implícitas das seguintes classes:

Esse método aceita os objetos listados acima para o builder parâmetro .

Para obter mais informações, consulte os Implicit operadores e Addition .

Confira também

Aplica-se a