Choices.Add Methode

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

Parameters

Voorbeelden

In het volgende voorbeeld wordt een grammatica voor spraakherkenning gemaakt voor zinnen zoals 'Call Anne on her cell' en 'Call James on his work phone'. In het voorbeeld worden beide overbelastingen van de Add methode gebruikt om de grammatica te bouwen.

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

Opmerkingen

Vanwege ondersteuning voor impliciete conversie van Choices, SemanticResultKeyen SemanticResultValue objecten naar GrammarBuilder, kunnen deze drie klassen ook worden toegevoegd aan een Choices exemplaar.

Als alternateChoices dit een lege matrix is, werkt deze methode de set alternatieven niet bij.

Toepassingen kunnen beide Add(String[]) gebruiken en Add(GrammarBuilder[]) alternatieven voor een Choices object toevoegen.

Deze methode genereert een ArgumentNullException wanneer alternateChoices of null een van de matrixelementen.null

Zie ook

• GrammarBuilder
• Grammar

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

Parameters

Voorbeelden

In het volgende voorbeeld wordt een grammatica voor spraakherkenning gemaakt voor zinnen die vergelijkbaar zijn met 'Call Anne on her cell' en 'Call James on his work phone'. In het voorbeeld worden beide overbelastingen van de Add methode gebruikt om de grammatica te bouwen.

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

Opmerkingen

Toepassingen kunnen beide Add(String[]) gebruiken en Add(GrammarBuilder[]) alternatieven voor een Choices object toevoegen.

Als phrases dit een lege matrix is, werkt deze methode de set alternatieven niet bij.

Deze methode genereert een ArgumentNullException wanneer phrases of null een van de matrixelementen.null Met deze methode wordt een if-element ArgumentException in de matrix veroorzaakt door de lege tekenreeks ("").

Zie ook

• Grammar
• GrammarBuilder