Choices.Add Método

Definição

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Adiciona itens ao conjunto de alternativas.

Sobrecargas

Add(GrammarBuilder[])	Adiciona uma matriz que contém um ou mais objetos GrammarBuilder ao conjunto de alternativas.
Add(String[])	Adiciona uma matriz que contém um ou mais objetos String ao conjunto de alternativas.

Add(GrammarBuilder[])

Adiciona uma matriz que contém um ou mais objetos GrammarBuilder ao conjunto de alternativas.

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

alternateChoices

GrammarBuilder[]

Os objetos GrammarBuilder a serem adicionados a este objeto Choices.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala para frases como "Chame Anne em sua cela" e "Ligue para James em seu telefone de trabalho". O exemplo usa as duas sobrecargas do Add método para criar 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);  
}  

Comentários

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

Se alternateChoices for uma matriz vazia, esse método não atualizará o conjunto de alternativas.

Os aplicativos podem usar ambos Add(String[]) e Add(GrammarBuilder[]) adicionar alternativas a um Choices objeto.

Esse método lança um ArgumentNullException quando alternateChoices é null ou qualquer um dos elementos da matriz são null.

Confira também

• GrammarBuilder
• Grammar

Add(String[])

Adiciona uma matriz que contém um ou mais objetos String ao conjunto de alternativas.

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

phrases

String[]

As cadeias de caracteres a adicionar a este objeto Choices.

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala para frases semelhantes a "Chame Anne em sua cela" e "Ligue para James em seu telefone de trabalho". O exemplo usa as duas sobrecargas do Add método para criar 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);  
}  

Comentários

Os aplicativos podem usar ambos Add(String[]) e Add(GrammarBuilder[]) adicionar alternativas a um Choices objeto.

Se phrases for uma matriz vazia, esse método não atualizará o conjunto de alternativas.

Esse método lança um ArgumentNullException quando phrases é null ou qualquer um dos elementos da matriz são null. Esse método lança um ArgumentException elemento se qualquer elemento na matriz for a cadeia de caracteres vazia ("").

Confira também

• Grammar
• GrammarBuilder