GrammarBuilder.Add Método

Definição

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Pacote:

System.Speech v11.0.0-preview.2.26159.112

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

Sobrecargas

Nome	Description
Add(Choices, GrammarBuilder)	Cria um novo GrammarBuilder que contém um Choices objeto seguido por um GrammarBuilder objeto.
Add(GrammarBuilder, Choices)	Cria um novo GrammarBuilder que contém um GrammarBuilder objeto seguido por um Choices objeto.
Add(GrammarBuilder, GrammarBuilder)	Cria um novo GrammarBuilder que contém uma sequência de dois GrammarBuilder objetos.
Add(GrammarBuilder, String)	Cria um novo GrammarBuilder que contém um GrammarBuilder objeto seguido por uma frase.
Add(String, GrammarBuilder)	Cria uma nova GrammarBuilder que contém uma frase seguida por um GrammarBuilder objeto.

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 , SemanticResultKeye SemanticResultValueString. Para obter mais informações, consulte os operadores e Addition os Implicit operadores.

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

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

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 gramatical, que representa um conjunto de alternativas.

builder

GrammarBuilder

O segundo elemento gramatical.

Retornos

GrammarBuilder

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

Comentários

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

• Choices

• SemanticResultKey

• SemanticResultValue

• String

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

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

Importante

Ao combinar Choices e GrammarBuilder objetos 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 podem modificar repetidamente a Value propriedade de um SemanticValue objeto. O reconhecedor de fala pode 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

• Append(Choices)
• Implicit(Choices to GrammarBuilder)
• Addition(Choices, GrammarBuilder)

Add(GrammarBuilder, Choices)

Origem:

GrammarBuilder.cs

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

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 gramatical.

choices

Choices

O segundo elemento gramatical, que representa um conjunto de alternativas.

Retornos

GrammarBuilder

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

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 de um conjunto de cores. Vários tipos são usados para criar a gramática final, como Cadeia de CaracteresChoices e GrammarBuilder objetos. Os operadores de conversão explícitos nas chamadas aos 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:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

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

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

Importante

Ao combinar Choices e GrammarBuilder objetos 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 pode gerar uma exceção se encontrar essas circunstâncias.

Confira também

• Append(Choices)
• Implicit(Choices to GrammarBuilder)
• Addition(Choices, GrammarBuilder)

Add(GrammarBuilder, GrammarBuilder)

Origem:

GrammarBuilder.cs

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

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 gramatical.

builder2

GrammarBuilder

O segundo elemento gramatical.

Retornos

GrammarBuilder

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

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 de um conjunto de cores. Vários tipos são usados para criar a gramática final, como Cadeia de CaracteresChoices e GrammarBuilder objetos. Os operadores de conversão explícitos nas chamadas aos 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:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

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

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

Importante

Ao combinar Choices e GrammarBuilder objetos 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 pode gerar uma exceção se encontrar essas circunstâncias.

Confira também

• Append(Choices)
• Implicit(Choices to GrammarBuilder)
• Addition(Choices, GrammarBuilder)

Add(GrammarBuilder, String)

Origem:

GrammarBuilder.cs

Cria um novo GrammarBuilder que contém um GrammarBuilder objeto 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 gramatical.

phrase

String

O segundo elemento gramatical, que representa uma sequência de palavras.

Retornos

GrammarBuilder

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

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 de um conjunto de cores. Vários tipos são usados para criar a gramática final, como Cadeia de CaracteresChoices e GrammarBuilder objetos. Os operadores de conversão explícitos nas chamadas aos 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:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

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

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

Confira também

• Append(Choices)
• Implicit(Choices to GrammarBuilder)
• Addition(Choices, GrammarBuilder)

Add(String, GrammarBuilder)

Origem:

GrammarBuilder.cs

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

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 gramatical, que representa uma sequência de palavras.

builder

GrammarBuilder

O segundo elemento gramatical.

Retornos

GrammarBuilder

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

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 de um conjunto de cores. Vários tipos são usados para criar a gramática final, como Cadeia de CaracteresChoices e GrammarBuilder objetos. Os operadores de conversão explícitos nas chamadas aos 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:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

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

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

Confira também

• Append(Choices)
• Implicit(Choices to GrammarBuilder)
• Addition(Choices, GrammarBuilder)