Choices.Add Metodo

Definizione

Spazio dei nomi:
System.Speech.Recognition
Assembly:
System.Speech.dll
Pacchetto:
System.Speech v11.0.0-preview.5.26302.115

Aggiunge elementi al set di alternative.

Overload

Nome Descrizione
Add(GrammarBuilder[])

Aggiunge una matrice contenente uno o più GrammarBuilder oggetti al set di alternative.
Add(String[])

Aggiunge una matrice contenente uno o più String oggetti al set di alternative.

Add(GrammarBuilder[])

Origine:
Choices.cs
Origine:
Choices.cs
Origine:
Choices.cs
Origine:
Choices.cs

Aggiunge una matrice contenente uno o più GrammarBuilder oggetti al set di alternative.

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

Parametri

alternateChoices
GrammarBuilder[]

Oggetti GrammarBuilder da aggiungere a questo Choices oggetto.

Esempio

L'esempio seguente crea una grammatica di riconoscimento vocale per frasi come "Call Anne on her cell" e "Call James on his work phone". Nell'esempio vengono usati entrambi gli overload del Add metodo per compilare la grammatica.

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

Commenti

A causa del supporto per la conversione implicita da Choicesoggetti , SemanticResultKeye SemanticResultValue a GrammarBuilder, queste tre classi possono essere aggiunte anche a un'istanza Choices di .

Se alternateChoices è una matrice vuota, questo metodo non aggiorna il set di alternative.

Le applicazioni possono usare sia Add(String[]) che Add(GrammarBuilder[]) per aggiungere alternative a un Choices oggetto .

Questo metodo genera un'eccezione ArgumentNullException quando alternateChoices è null o uno degli elementi della matrice è null.

Vedi anche

Si applica a

Add(String[])

Origine:
Choices.cs
Origine:
Choices.cs
Origine:
Choices.cs
Origine:
Choices.cs

Aggiunge una matrice contenente uno o più String oggetti al set di alternative.

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

Parametri

phrases
String[]

Stringhe da aggiungere a questo Choices oggetto.

Esempio

L'esempio seguente crea una grammatica di riconoscimento vocale per frasi simili a "Call Anne on her cell" e "Call James on his work phone". Nell'esempio vengono usati entrambi gli overload del Add metodo per compilare la grammatica.

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

Commenti

Le applicazioni possono usare sia Add(String[]) che Add(GrammarBuilder[]) per aggiungere alternative a un Choices oggetto .

Se phrases è una matrice vuota, questo metodo non aggiorna il set di alternative.

Questo metodo genera un'eccezione ArgumentNullException quando phrases è null o uno degli elementi della matrice è null. Questo metodo genera un'eccezione ArgumentException se un elemento nella matrice è la stringa vuota ("").

Vedi anche

Si applica a