Freigeben über


Choices.Add Methode

Definition

Fügt dem Satz von Alternativen Elemente hinzu.

Überlädt

Add(GrammarBuilder[])

Fügt der Gruppe von Alternativen ein Array hinzu, das ein oder mehrere GrammarBuilder-Objekte enthält.

Add(String[])

Fügt der Gruppe von Alternativen ein Array hinzu, das ein oder mehrere String-Objekte enthält.

Add(GrammarBuilder[])

Quelle:
Choices.cs
Quelle:
Choices.cs
Quelle:
Choices.cs

Fügt der Gruppe von Alternativen ein Array hinzu, das ein oder mehrere GrammarBuilder-Objekte enthält.

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

Parameter

alternateChoices
GrammarBuilder[]

Die GrammarBuilder-Objekte, die diesem Choices-Objekt hinzugefügt werden sollen.

Beispiele

Im folgenden Beispiel wird eine Spracherkennungsgrammatik für Ausdrücke wie "Call Anne on her cell" und "Call James on his work phone" erstellt. Im Beispiel werden beide Überladungen der Add -Methode verwendet, um die Grammatik zu erstellen.

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

Hinweise

Aufgrund der Unterstützung für die implizite Konvertierung von Choices, SemanticResultKeyund SemanticResultValue -Objekten in GrammarBuilderkönnen diese drei Klassen auch einer Choices -Instanz hinzugefügt werden.

Wenn alternateChoices ein leeres Array ist, aktualisiert diese Methode den Satz von Alternativen nicht.

Anwendungen können sowohl als auch Add(String[])Add(GrammarBuilder[]) verwenden, um Alternativen zu einem Choices Objekt hinzuzufügen.

Diese Methode löst eine aus ArgumentNullException , wenn alternateChoices oder null eines der Arrayelemente ist null.

Weitere Informationen

Gilt für:

Add(String[])

Quelle:
Choices.cs
Quelle:
Choices.cs
Quelle:
Choices.cs

Fügt der Gruppe von Alternativen ein Array hinzu, das ein oder mehrere String-Objekte enthält.

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

Parameter

phrases
String[]

Die Zeichenfolgen, die diesem Choices-Objekt hinzugefügt werden sollen.

Beispiele

Im folgenden Beispiel wird eine Spracherkennungsgrammatik für Ausdrücke wie "Call Anne on her cell" und "Call James on his work phone" erstellt. Im Beispiel werden beide Überladungen der Add -Methode verwendet, um die Grammatik zu erstellen.

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

Hinweise

Anwendungen können sowohl als auch Add(String[])Add(GrammarBuilder[]) verwenden, um Alternativen zu einem Choices Objekt hinzuzufügen.

Wenn phrases ein leeres Array ist, aktualisiert diese Methode den Satz von Alternativen nicht.

Diese Methode löst eine aus ArgumentNullException , wenn phrases oder null eines der Arrayelemente ist null. Diese Methode löst eine aus ArgumentException , wenn ein Element im Array die leere Zeichenfolge ("") ist.

Weitere Informationen

Gilt für: