Choices.Add Metod

Definition

Namnområde:
System.Speech.Recognition
Sammansättning:
System.Speech.dll
Paket:
System.Speech v11.0.0-preview.4.26230.115

Lägger till objekt i uppsättningen med alternativ.

Överlagringar

Name Description
Add(GrammarBuilder[])

Lägger till en matris som innehåller ett eller flera GrammarBuilder objekt i uppsättningen med alternativ.
Add(String[])

Lägger till en matris som innehåller ett eller flera String objekt i uppsättningen med alternativ.

Add(GrammarBuilder[])

Källa:
Choices.cs
Källa:
Choices.cs
Källa:
Choices.cs
Källa:
Choices.cs

Lägger till en matris som innehåller ett eller flera GrammarBuilder objekt i uppsättningen med alternativ.

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

Parametrar

alternateChoices
GrammarBuilder[]

De GrammarBuilder objekt som ska läggas till i det här Choices objektet.

Exempel

I följande exempel skapas en grammatik för taligenkänning för fraser som "Call Anne on her cell" och "Call James on his work phone". I exemplet används båda överlagringarna av Add metoden för att skapa grammatiken.

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

Kommentarer

På grund av stöd för implicit konvertering från Choices, SemanticResultKeyoch SemanticResultValue objekt till GrammarBuilder, kan även dessa tre klasser läggas till i en Choices instans.

Om alternateChoices är en tom matris uppdaterar den här metoden inte uppsättningen med alternativ.

Program kan använda både Add(String[]) och Add(GrammarBuilder[]) för att lägga till alternativ till ett Choices objekt.

Den här metoden genererar ett ArgumentNullException när alternateChoices är null eller något av matriselementen är null.

Se även

Gäller för

Add(String[])

Källa:
Choices.cs
Källa:
Choices.cs
Källa:
Choices.cs
Källa:
Choices.cs

Lägger till en matris som innehåller ett eller flera String objekt i uppsättningen med alternativ.

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

Parametrar

phrases
String[]

De strängar som ska läggas till i det här Choices objektet.

Exempel

I följande exempel skapas en grammatik för taligenkänning för fraser som liknar "Call Anne on her cell" och "Call James on his work phone". I exemplet används båda överlagringarna av Add metoden för att skapa grammatiken.

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

Kommentarer

Program kan använda både Add(String[]) och Add(GrammarBuilder[]) för att lägga till alternativ till ett Choices objekt.

Om phrases är en tom matris uppdaterar den här metoden inte uppsättningen med alternativ.

Den här metoden genererar ett ArgumentNullException när phrases är null eller något av matriselementen är null. Den här metoden genererar ett ArgumentException om något element i matrisen är den tomma strängen ("").

Se även

Gäller för