GrammarBuilder.Add Método

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Crea un nuevo GrammarBuilder que contiene una secuencia de dos elementos de gramática.

Sobrecargas

Add(Choices, GrammarBuilder)	Crea un nuevo GrammarBuilder que contiene un objeto Choices seguido por un objeto GrammarBuilder.
Add(GrammarBuilder, Choices)	Crea un nuevo GrammarBuilder que contiene un objeto GrammarBuilder seguido por un objeto Choices.
Add(GrammarBuilder, GrammarBuilder)	Crea un nuevo GrammarBuilder que contiene una secuencia de dos objetos GrammarBuilder.
Add(GrammarBuilder, String)	Crea un nuevo GrammarBuilder que contiene un objeto GrammarBuilder seguido de una frase.
Add(String, GrammarBuilder)	Crea un nuevo GrammarBuilder que contiene una frase seguida de un objeto GrammarBuilder.

Comentarios

Los métodos estáticos Add proporcionan otro mecanismo mediante el cual se pueden combinar varios tipos para crear diversidad y flexibilidad en las gramáticas compiladas con GrammarBuilder . Estos métodos se corresponden con los Addition métodos estáticos, que también se definen en la GrammarBuilder clase. El orden de los parámetros determina el orden de los elementos de la nueva GrammarBuilder .

GrammarBuilderTambién se puede obtener un objeto a partir de los Choices SemanticResultKey objetos de cadena,, SemanticResultValue y. Para obtener más información, vea Implicit los Addition operadores y.

Importante

El reconocedor de voz puede producir una excepción cuando se usa una gramática de reconocimiento de voz que contiene elementos semánticos duplicados con el mismo nombre de clave o varios elementos semánticos que podrían modificar repetidamente el valor del mismo elemento semántico.

Para obtener más información sobre la creación y el uso de las gramáticas de reconocimiento de voz, consulte reconocimiento de voz.

Add(Choices, GrammarBuilder)

Crea un nuevo GrammarBuilder que contiene un objeto Choices seguido por un 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

El primer elemento grammar, que representa un conjunto de alternativas.

builder

GrammarBuilder

El segundo elemento grammar.

Devoluciones

GrammarBuilder

Un GrammarBuilder para la secuencia del elemento choices seguido por el elemento builder.

Comentarios

GrammarBuilder admite conversiones implícitas de las siguientes clases:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

Este método acepta los objetos enumerados anteriormente para el builder parámetro.

Para obtener más información, vea Implicit los Addition operadores y.

Importante

Cuando combine Choices objetos y GrammarBuilder que contengan SemanticResultValue instancias de o, asegúrese de SemanticResultKey evitar crear elementos semánticos duplicados con el mismo nombre de clave o varios elementos semánticos que podrían modificar repetidamente la Value propiedad de un SemanticValue objeto. El reconocedor de voz puede producir una excepción si encuentra estas circunstancias. Para obtener más información sobre cómo crear una gramática de reconocimiento de voz que contenga información semántica, consulte Agregar semántica a una gramática de GrammarBuilder.

Consulte también

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

Add(GrammarBuilder, Choices)

Crea un nuevo GrammarBuilder que contiene un objeto GrammarBuilder seguido por un 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

El primer elemento de gramática.

choices

Choices

El segundo elemento de la gramática, que representa un conjunto de alternativas.

Devoluciones

GrammarBuilder

Un GrammarBuilder para la secuencia del elemento builder seguido por el elemento choices.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz que puede reconocer las dos frases "hacer color de fondo" y "establecer fondo en color", donde el color está seleccionado en un conjunto de colores. Se usan varios tipos para compilar la gramática final, como los objetos String, Choices y GrammarBuilder . Los operadores de conversión explícitos en las llamadas a los Add métodos son opcionales.

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;  
}  

Comentarios

GrammarBuilder admite conversiones implícitas de las siguientes clases:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

Este método acepta los objetos enumerados anteriormente para el builder parámetro.

Para obtener más información, vea Implicit los Addition operadores y.

Importante

Cuando combine Choices objetos y GrammarBuilder que contengan SemanticResultValue SemanticResultKey instancias de o con otros elementos de gramática, asegúrese de evitar crear elementos semánticos duplicados con el mismo nombre de clave o varios elementos semánticos que podrían modificar repetidamente la Value propiedad de un SemanticValue objeto. El reconocedor de voz puede producir una excepción si encuentra estas circunstancias.

Consulte también

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

Add(GrammarBuilder, GrammarBuilder)

Crea un nuevo GrammarBuilder que contiene una secuencia de dos 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

El primer elemento de gramática.

builder2

GrammarBuilder

El segundo elemento grammar.

Devoluciones

GrammarBuilder

Un GrammarBuilder para la secuencia del elemento builder1 seguido por el elemento builder2.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz que puede reconocer las dos frases "hacer color de fondo" y "establecer fondo en color", donde el color está seleccionado en un conjunto de colores. Se usan varios tipos para compilar la gramática final, como los objetos String, Choices y GrammarBuilder . Los operadores de conversión explícitos en las llamadas a los Add métodos son opcionales.

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;  
}  

Comentarios

GrammarBuilder admite conversiones implícitas de las siguientes clases:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

Este método acepta los objetos enumerados anteriormente para builder1 el builder2 parámetro o.

Para obtener más información, vea Implicit los Addition operadores y.

Importante

Cuando combine Choices objetos y GrammarBuilder que contengan SemanticResultValue SemanticResultKey instancias de o con otros elementos de gramática, asegúrese de evitar crear elementos semánticos duplicados con el mismo nombre de clave o varios elementos semánticos que podrían modificar repetidamente la Value propiedad de un SemanticValue objeto. El reconocedor de voz puede producir una excepción si encuentra estas circunstancias.

Consulte también

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

Add(GrammarBuilder, String)

Crea un nuevo GrammarBuilder que contiene un objeto GrammarBuilder seguido de una 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

El primer elemento de gramática.

phrase

String

El segundo elemento de la gramática, que representa una secuencia de palabras.

Devoluciones

GrammarBuilder

Un GrammarBuilder para la secuencia del elemento builder seguido por el elemento phrase.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz que puede reconocer las dos frases "hacer color de fondo" y "establecer fondo en color", donde el color está seleccionado en un conjunto de colores. Se usan varios tipos para compilar la gramática final, como los objetos String, Choices y GrammarBuilder . Los operadores de conversión explícitos en las llamadas a los Add métodos son opcionales.

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;  
}  

Comentarios

GrammarBuilder admite conversiones implícitas de las siguientes clases:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

Este método acepta los objetos enumerados anteriormente para el builder parámetro.

Para obtener más información, vea Implicit los Addition operadores y.

Consulte también

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

Add(String, GrammarBuilder)

Crea un nuevo GrammarBuilder que contiene una frase seguida de un 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

El primer elemento de la gramática, que representa una secuencia de palabras.

builder

GrammarBuilder

El segundo elemento grammar.

Devoluciones

GrammarBuilder

Un GrammarBuilder para la secuencia del elemento phrase seguido por el elemento builder.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz que puede reconocer las dos frases "hacer color de fondo" y "establecer fondo en color", donde el color está seleccionado en un conjunto de colores. Se usan varios tipos para compilar la gramática final, como los objetos String, Choices y GrammarBuilder . Los operadores de conversión explícitos en las llamadas a los Add métodos son opcionales.

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;  
}  

Comentarios

GrammarBuilder admite conversiones implícitas de las siguientes clases:

• Choices

• SemanticResultKey

• SemanticResultValue

• String

Este método acepta los objetos enumerados anteriormente para el builder parámetro.

Para obtener más información, vea Implicit los Addition operadores y.

Consulte también

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