Ler en inglés

Compartir por


Choices.Add Método

Definición

Agrega elementos al conjunto de alternativas.

Sobrecargas

Add(GrammarBuilder[])

Agrega una matriz que contiene uno o más objetos GrammarBuilder al conjunto de alternativas.

Add(String[])

Agrega una matriz que contiene uno o más objetos String al conjunto de alternativas.

Add(GrammarBuilder[])

Source:
Choices.cs
Source:
Choices.cs
Source:
Choices.cs

Agrega una matriz que contiene uno o más objetos GrammarBuilder al conjunto de alternativas.

C#
public void Add(params System.Speech.Recognition.GrammarBuilder[] alternateChoices);

Parámetros

alternateChoices
GrammarBuilder[]

Objetos GrammarBuilder que se van a agregar a este objeto Choices.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz para frases como "Llamar a Anne en su celda" y "Llamar a James en su teléfono laboral". En el ejemplo se usan ambas sobrecargas del Add método para crear la gramática.

C#
public Grammar CreatePhonePhrase()
{

  // Create alternatives for female names and add a phrase.
  GrammarBuilder females = new Choices(new string[] { "Anne", "Mary" });
  females.Append("on her");

  // Create alternatives for male names and add a phrase.
  GrammarBuilder males = new Choices(new string[] { "James", "Sam" });
  males.Append("on his");

  // Create a Choices object that contains an array of alternative
  // GrammarBuilder objects.
  Choices people = new Choices();
  people.Add(new Choices(new GrammarBuilder[] {females, males}));

  // Create a Choices object that contains a set of alternative phone types.
  Choices phoneType = new Choices();
  phoneType.Add(new string[] { "cell", "home", "work" });

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder();
  gb.Append("call");
  gb.Append(people);
  gb.Append(phoneType);
  gb.Append(new GrammarBuilder("phone"), 0, 1);

  return new Grammar(gb);
}

Comentarios

Debido a la compatibilidad con la conversión implícita de Choicesobjetos , SemanticResultKeyy SemanticResultValue a GrammarBuilder, estas tres clases también se pueden agregar a una Choices instancia de .

Si alternateChoices es una matriz vacía, este método no actualiza el conjunto de alternativas.

Las aplicaciones pueden usar y Add(String[])Add(GrammarBuilder[]) para agregar alternativas a un Choices objeto .

Este método produce una ArgumentNullException excepción cuando alternateChoices es null o cualquiera de los elementos de matriz son null.

Consulte también

Se aplica a

.NET 10 (package-provided) e outras versións
Produto Versións
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

Add(String[])

Source:
Choices.cs
Source:
Choices.cs
Source:
Choices.cs

Agrega una matriz que contiene uno o más objetos String al conjunto de alternativas.

C#
public void Add(params string[] phrases);

Parámetros

phrases
String[]

Las cadenas para agregar a este objeto Choices.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz para frases similares a "Llamar a Anne en su celda" y "Llamar a James en su teléfono laboral". En el ejemplo se usan ambas sobrecargas del Add método para crear la gramática.

C#
public Grammar CreatePhonePhrase()
{

  // Create alternatives for female names and add a phrase.
  GrammarBuilder females = new Choices(new string[] { "Anne", "Mary" });
  females.Append("on her");

  // Create alternatives for male names and add a phrase.
  GrammarBuilder males = new Choices(new string[] { "James", "Sam" });
  males.Append("on his");

  // Create a Choices object that contains an array of alternative
  // GrammarBuilder objects.
  Choices people = new Choices();
  people.Add(new Choices(new GrammarBuilder[] {females, males}));

  // Create a Choices object that contains a set of alternative phone types.
  Choices phoneType = new Choices();
  phoneType.Add(new string[] { "cell", "home", "work" });

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder();
  gb.Append("call");
  gb.Append(people);
  gb.Append(phoneType);
  gb.Append(new GrammarBuilder("phone"), 0, 1);

  return new Grammar(gb);
}

Comentarios

Las aplicaciones pueden usar y Add(String[])Add(GrammarBuilder[]) para agregar alternativas a un Choices objeto .

Si phrases es una matriz vacía, este método no actualiza el conjunto de alternativas.

Este método produce una ArgumentNullException excepción cuando phrases es null o cualquiera de los elementos de matriz son null. Este método produce un ArgumentException si algún elemento de la matriz es la cadena vacía ("").

Consulte también

Se aplica a

.NET 10 (package-provided) e outras versións
Produto Versións
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)