Choices Konstruktoren

Definition

Initialisiert eine neue Instanz der Choices-Klasse.

Überlädt

Choices()

Initialisiert eine neue Instanz der Choices-Klasse, die einen leeren Satz von Alternativen enthält.

Choices(GrammarBuilder[])

Initialisiert eine neue Instanz der Choices-Klasse aus einem Array von einem oder mehreren GrammarBuilder-Objekten.

Choices(String[])

Initialisiert eine neue Instanz der Choices-Klasse aus einem Array von einem oder mehreren String-Objekten.

Beispiele

Im folgenden Beispiel werden Objekte verwendet Choices , um zwei Listen von Alternativen zu erstellen.

Das erste Choices Objekt wird aus einem Array von String Objekten erstellt. Das andere Choices Objekt wird aus einem Array von GrammarBuilder Objekten erstellt, die implizit von einem Cast konvertiert wurden.

Im Beispiel wird ein Objekt verwendet, um einen GrammarBuilder Ausdruck mit den Choices Objekten und zwei zusätzlichen Zeichenfolgen zusammenzustellen, die verwendet werden können, um Spracheingaben in Form von "Anruf [contactlList] auf [phoneType]-Telefon" zu erkennen, z. B. "Call Jane on cell phone".

public GrammarBuilder ChoicesConstructor2 ()  
{  
    GrammarBuilder gb = new GrammarBuilder ();  
    Choices phoneType = new Choices (new string[] {"cell", "home", "work"});  
    Choices contactList = new Choices (new GrammarBuilder[] {(GrammarBuilder) "Mark", (GrammarBuilder) "Jane", (GrammarBuilder) "Frank"});  
    gb.Append ("Call");  
    gb.Append (contactList);  
    gb.Append ("on");  
    gb.Append (phoneType);  
    gb.Append ("phone");  
    return gb;  
}  

Hinweise

Sie können ein Choices Objekt mithilfe eines parameterlosen Konstruktors erstellen (der ein leeres Objekt zurückgibt), aus einer Gruppe von Objekten oder einer Gruppe von String GrammarBuilder Objekten.

Da das GrammarBuilder Objekt implizite Konvertierungen aus SemanticResultValue und SemanticResultKeyunterstützt, kann ein Choices Array dieser Objekte mithilfe eines Casts erstellt werden.

Choices()

Initialisiert eine neue Instanz der Choices-Klasse, die einen leeren Satz von Alternativen enthält.

public:
 Choices();
public Choices ();
Public Sub New ()

Beispiele

Das folgende Beispiel verwendet Choices und Objekte, um einen Ausdruck zu erstellen, der verwendet werden kann, um Spracheingaben wie "Anruf Anne auf ihrer Zelle" und GrammarBuilder "Anruf James auf seinem Arbeitstelefon" zu erkennen. Das Beispiel verwendet implizite Casts von Choices und String zu GrammarBuilder.

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

Dieser Konstruktor gibt einen gültigen, leeren Satz von Alternativen zurück. Sie können Alternativen mithilfe einer der Add Methoden hinzufügen.

Siehe auch

Gilt für

Choices(GrammarBuilder[])

Initialisiert eine neue Instanz der Choices-Klasse aus einem Array von einem oder mehreren GrammarBuilder-Objekten.

public:
 Choices(... cli::array <System::Speech::Recognition::GrammarBuilder ^> ^ alternateChoices);
public Choices (params System.Speech.Recognition.GrammarBuilder[] alternateChoices);
new System.Speech.Recognition.Choices : System.Speech.Recognition.GrammarBuilder[] -> System.Speech.Recognition.Choices
Public Sub New (ParamArray alternateChoices As GrammarBuilder())

Parameter

alternateChoices
GrammarBuilder[]

Ein Array, das den Satz von Alternativen enthält.

Beispiele

Im folgenden Beispiel werden Choices Ausdrücke wie "Anruf Anne auf ihrer Zelle" und GrammarBuilder Grammar "Anruf James auf seinem Arbeitstelefon" erstellt. Das Beispiel verwendet implizite Casts von Choices und String zu GrammarBuilder.

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

Jeder GrammarBuilder in alternateChoices definiert eine Alternative. Wenn alternateChoices es sich um ein leeres Array handelt, gibt der Konstruktor eine leere Gruppe von Alternativen zurück. Sie können Alternativen mithilfe einer der Add Methoden hinzufügen.

Der Konstruktor löst einen ArgumentNullException Zeitpunkt alternateChoices null oder einen der Arrayelemente nullaus.

Da die GrammarBuilder Klasse implizite Konvertierung von Choices, SemanticResultValueund SemanticResultKey Objekten in GrammarBuilder Instanzen bereitstellt, kann dieser Konstruktor auch zum Erstellen eines Choices Objekts aus einer Liste dieser Objekte verwendet werden.

Siehe auch

Gilt für

Choices(String[])

Initialisiert eine neue Instanz der Choices-Klasse aus einem Array von einem oder mehreren String-Objekten.

public:
 Choices(... cli::array <System::String ^> ^ phrases);
public Choices (params string[] phrases);
new System.Speech.Recognition.Choices : string[] -> System.Speech.Recognition.Choices
Public Sub New (ParamArray phrases As String())

Parameter

phrases
String[]

Ein Array, das den Satz von Alternativen enthält.

Beispiele

Das folgende Beispiel verwendet Choices und Objekte, um eine Grammar für die Ausdrücke wie "Anruf Anne auf ihrer Zelle" und GrammarBuilder "Anruf James auf seinem Arbeitstelefon" zu erstellen. Das Beispiel verwendet implizite Casts von Choices und String zu GrammarBuilder.

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

Jeder String in phrases definiert eine Alternative. Das Spracherkennungsmodul kann eine der Elemente im Zeichenfolgenarray verwenden, um mit der Spracheingabe übereinzugleichen. Wenn phrases es sich um ein leeres Array handelt, gibt der Konstruktor eine leere Gruppe von Alternativen zurück. Sie können Alternativen mithilfe einer der Add Methoden hinzufügen.

Der Konstruktor löst einen Zeitpunkt phrases null oder eine ArgumentNullException der Arrayelemente nullaus. Der Konstruktor löst ein, wenn ein Element im Array eine ArgumentException leere Zeichenfolge ("") ist.

Siehe auch

Gilt für