GrammarBuilder.Add Método

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Paquete:

System.Speech v11.0.0-preview.2.26159.112

Crea un nuevo GrammarBuilder objeto que contiene una secuencia de dos elementos gramaticales.

Sobrecargas

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

Comentarios

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

También GrammarBuilder se puede obtener de Choicesobjetos , SemanticResultKey, SemanticResultValuey String . Para obtener más información, consulte los Implicit operadores y Addition .

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 cómo crear y usar gramáticas de reconocimiento de voz, consulte Reconocimiento de voz.

Add(Choices, GrammarBuilder)

Source:

GrammarBuilder.cs

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

Primer elemento de gramática, que representa un conjunto de alternativas.

builder

GrammarBuilder

Segundo elemento de gramática.

Devoluciones

GrammarBuilder

para GrammarBuilder la secuencia del choices elemento seguido del builder elemento .

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, consulte los Implicit operadores y Addition .

Importante

Al combinar Choices objetos y GrammarBuilder que contienen SemanticResultValue instancias o SemanticResultKey , asegúrese de evitar la creación de 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 la creación de una gramática de reconocimiento de voz que contiene información semántica, vea Agregar semántica a una gramática de GrammarBuilder.

Consulte también

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

Add(GrammarBuilder, Choices)

Source:

GrammarBuilder.cs

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

Primer elemento de gramática.

choices

Choices

Segundo elemento de gramática, que representa un conjunto de alternativas.

Devoluciones

GrammarBuilder

para GrammarBuilder la secuencia del builder elemento seguido del choices elemento .

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 se selecciona color a partir de un conjunto de colores. Se usan varios tipos para crear la gramática final, como string, Choicesy GrammarBuilder objetos . Los operadores de conversión explícitos de 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, consulte los Implicit operadores y Addition .

Importante

Al combinar Choices objetos y GrammarBuilder que contienen SemanticResultValue o SemanticResultKey instancias con otros elementos gramaticales, asegúrese de evitar la creación de 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)

Source:

GrammarBuilder.cs

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

Primer elemento de gramática.

builder2

GrammarBuilder

Segundo elemento de gramática.

Devoluciones

GrammarBuilder

para GrammarBuilder la secuencia del builder1 elemento seguido del builder2 elemento .

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 se selecciona color a partir de un conjunto de colores. Se usan varios tipos para crear la gramática final, como string, Choicesy GrammarBuilder objetos . Los operadores de conversión explícitos de 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 builder1 parámetro o builder2 .

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

Importante

Al combinar Choices objetos y GrammarBuilder que contienen SemanticResultValue o SemanticResultKey instancias con otros elementos gramaticales, asegúrese de evitar la creación de 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)

Source:

GrammarBuilder.cs

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

Primer elemento de gramática.

phrase

String

Segundo elemento de gramática, que representa una secuencia de palabras.

Devoluciones

GrammarBuilder

para GrammarBuilder la secuencia del builder elemento seguido del phrase elemento .

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 se selecciona color a partir de un conjunto de colores. Se usan varios tipos para crear la gramática final, como string, Choicesy GrammarBuilder objetos . Los operadores de conversión explícitos de 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, consulte los Implicit operadores y Addition .

Consulte también

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

Add(String, GrammarBuilder)

Source:

GrammarBuilder.cs

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

Primer elemento de gramática, que representa una secuencia de palabras.

builder

GrammarBuilder

Segundo elemento de gramática.

Devoluciones

GrammarBuilder

para GrammarBuilder la secuencia del phrase elemento seguido del builder elemento .

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 se selecciona color a partir de un conjunto de colores. Se usan varios tipos para crear la gramática final, como string, Choicesy GrammarBuilder objetos . Los operadores de conversión explícitos de 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, consulte los Implicit operadores y Addition .

Consulte también

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