Choices.Add Metodo

Definizione

Aggiunge elementi al set di alternative.

Overload

Add(GrammarBuilder[])

Aggiunge una matrice contenente uno o più oggetti GrammarBuilder al set di alternative.

Add(String[])

Aggiunge una matrice contenente uno o più oggetti String al set di alternative.

Add(GrammarBuilder[])

Origine:
Choices.cs
Origine:
Choices.cs

Aggiunge una matrice contenente uno o più oggetti GrammarBuilder al set di alternative.

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())

Parametri

alternateChoices
GrammarBuilder[]

Oggetti GrammarBuilder da aggiungere a questo oggetto Choices.

Esempio

Nell'esempio seguente viene creata una grammatica di riconoscimento vocale per frasi come "Chiama Anne sulla sua cella" e "Chiama James sul suo telefono di lavoro". Nell'esempio Add vengono usati entrambi gli overload del metodo per compilare la grammatica.

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

Commenti

A causa del supporto per la conversione implicita da , e oggetti a GrammarBuilder, queste tre classi possono anche essere aggiunte a un'istanzaChoices.SemanticResultValueSemanticResultKeyChoices

Se alternateChoices è una matrice vuota, questo metodo non aggiorna il set di alternative.

Le applicazioni possono usare entrambi Add(String[]) e Add(GrammarBuilder[]) per aggiungere alternative a un Choices oggetto.

Questo metodo genera un ArgumentNullException oggetto quando alternateChoices è null o uno degli elementi della matrice è null.

Vedi anche

Si applica a

Add(String[])

Origine:
Choices.cs
Origine:
Choices.cs

Aggiunge una matrice contenente uno o più oggetti String al set di alternative.

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())

Parametri

phrases
String[]

Le stringhe da aggiungere a questo oggetto Choices.

Esempio

Nell'esempio seguente viene creata una grammatica di riconoscimento vocale per frasi simili a "Chiama Anne sulla sua cella" e "Chiama James sul suo telefono di lavoro". Nell'esempio Add vengono usati entrambi gli overload del metodo per compilare la grammatica.

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

Commenti

Le applicazioni possono usare entrambi Add(String[]) e Add(GrammarBuilder[]) per aggiungere alternative a un Choices oggetto.

Se phrases è una matrice vuota, questo metodo non aggiorna il set di alternative.

Questo metodo genera un ArgumentNullException oggetto quando phrases è null o uno degli elementi della matrice è null. Questo metodo genera un ArgumentException elemento se qualsiasi elemento della matrice è la stringa vuota ("").

Vedi anche

Si applica a