Choices.Add Metoda

Definicja

Przestrzeń nazw:

System.Speech.Recognition

Zestaw:

System.Speech.dll

Pakiet:

System.Speech v9.0.0-preview.5.24306.7

Dodaje elementy do zestawu alternatyw.

Przeciążenia

Add(GrammarBuilder[])	Dodaje tablicę zawierającą co najmniej jeden GrammarBuilder obiekt do zestawu alternatyw.
Add(String[])	Dodaje tablicę zawierającą co najmniej jeden String obiekt do zestawu alternatyw.

Add(GrammarBuilder[])

Źródło:

Choices.cs

Dodaje tablicę zawierającą co najmniej jeden GrammarBuilder obiekt do zestawu alternatyw.

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

Parametry

alternateChoices

GrammarBuilder[]

Obiekty GrammarBuilder do dodania do tego Choices obiektu.

Przykłady

Poniższy przykład tworzy gramatykę rozpoznawania mowy dla fraz, takich jak "Call Anne on her cell" i "Call James on his work phone". W przykładzie użyto obu przeciążeń Add metody do skompilowania gramatyki.

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

Uwagi

Ze względu na obsługę niejawnej konwersji z Choicesobiektów , SemanticResultKeyi SemanticResultValue na GrammarBuilder, te trzy klasy można również dodać do Choices wystąpienia.

Jeśli alternateChoices jest pustą tablicą, ta metoda nie aktualizuje zestawu alternatyw.

Aplikacje mogą używać obu metod Add(String[]) i Add(GrammarBuilder[]) do dodawania Choices alternatyw do obiektu.

Ta metoda zgłasza wartość ArgumentNullException , gdy alternateChoices element jest null lub którykolwiek z elementów tablicy to null.

Zobacz też

• GrammarBuilder
• Grammar

Add(String[])

Źródło:

Choices.cs

Dodaje tablicę zawierającą co najmniej jeden String obiekt do zestawu alternatyw.

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

Parametry

phrases

String[]

Ciągi do dodania do tego Choices obiektu.

Przykłady

Poniższy przykład tworzy gramatykę rozpoznawania mowy dla fraz podobnych do "Call Anne on her cell" i "Call James on his work phone" (Zadzwoń do Jamesa na telefon służbowy). W przykładzie użyto obu przeciążeń Add metody do skompilowania gramatyki.

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

Uwagi

Aplikacje mogą używać obu metod Add(String[]) i Add(GrammarBuilder[]) do dodawania Choices alternatyw do obiektu.

Jeśli phrases jest pustą tablicą, ta metoda nie aktualizuje zestawu alternatywnych.

Ta metoda zgłasza wartość ArgumentNullException , gdy phrases element jest null lub którykolwiek z elementów tablicy to null. Ta metoda zgłasza, ArgumentException czy jakikolwiek element w tablicy jest pustym ciągiem ("").

Zobacz też

• Grammar
• GrammarBuilder