GrammarBuilder.Add Método

Definição

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Pacote:

System.Speech v9.0.0-rc.2.24473.5

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)

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

GrammarBuilder

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:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

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

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

Add(GrammarBuilder, Choices)

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

GrammarBuilder

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:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

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

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

Add(GrammarBuilder, GrammarBuilder)

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

GrammarBuilder

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:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

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

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

Add(GrammarBuilder, String)

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

GrammarBuilder

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:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

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

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

Add(String, GrammarBuilder)

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

GrammarBuilder

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:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

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

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