Choices.Add Método

Origem:

Choices.cs

Origem:

Choices.cs

Origem:

Choices.cs

Origem:

Choices.cs

public:
 void Add(... cli::array <System::Speech::Recognition::GrammarBuilder ^> ^ alternateChoices);

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

member this.Add : System.Speech.Recognition.GrammarBuilder[] -> unit

Public Sub Add (ParamArray alternateChoices As GrammarBuilder())

Parâmetros

Exemplos

O exemplo seguinte cria uma gramática de reconhecimento de fala para frases como "Ligue à Anne para o telemóvel dela" e "Ligue ao James para o telefone do trabalho". O exemplo usa ambas as sobrecargas do Add método para construir a gramática.

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

Observações

Devido ao suporte para conversão implícita de Choices, , e SemanticResultKey objetos para SemanticResultValue, estas três classes podem também ser adicionadas a uma GrammarBuilder instânciaChoices.

Se alternateChoices for um array vazio, este método não atualiza o conjunto de alternativas.

As aplicações podem usar ambos Add(String[]) para Add(GrammarBuilder[]) adicionar alternativas a um Choices objeto.

Este método lança um ArgumentNullException quando alternateChoices é null ou qualquer um dos elementos do array são null.

Ver também

• GrammarBuilder
• Grammar

Origem:

Choices.cs

Origem:

Choices.cs

Origem:

Choices.cs

Origem:

Choices.cs

public:
 void Add(... cli::array <System::String ^> ^ phrases);

public void Add(params string[] phrases);

member this.Add : string[] -> unit

Public Sub Add (ParamArray phrases As String())

Parâmetros

Exemplos

O exemplo seguinte cria uma gramática de reconhecimento de fala para frases semelhantes a "Ligar à Anne no telemóvel dela" e "Ligar ao James no telefone do trabalho". O exemplo usa ambas as sobrecargas do Add método para construir a gramática.

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

Observações

As aplicações podem usar ambos Add(String[]) para Add(GrammarBuilder[]) adicionar alternativas a um Choices objeto.

Se phrases for um array vazio, este método não atualiza o conjunto de alternativas.

Este método lança um ArgumentNullException quando phrases é null ou qualquer um dos elementos do array são null. Este método lança um ArgumentException se qualquer elemento no array for a cadeia vazia ("").

Ver também

• Grammar
• GrammarBuilder