GrammarBuilder.Add Método

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Paquete:

System.Speech v9.0.0-preview.5.24306.7

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 por el que puede combinar varios tipos para crear diversidad y flexibilidad en 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 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, 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 cómo crear una gramática de reconocimiento de voz que contenga información semántica, vea Agregar semántica a una gramática grammarBuilder.

Consulte también

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

Add(GrammarBuilder, Choices)

Source:

GrammarBuilder.cs

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 se selecciona de un conjunto de colores. Varios tipos se usan 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 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)

Source:

GrammarBuilder.cs

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 se selecciona de un conjunto de colores. Varios tipos se usan 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 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)

Source:

GrammarBuilder.cs

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 se selecciona de un conjunto de colores. Varios tipos se usan 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 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 se selecciona de un conjunto de colores. Varios tipos se usan 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)