Choices.Add Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Aggiunge elementi al set di alternative.
Overload
Add(GrammarBuilder[]) |
Aggiunge una matrice contenente uno o più oggetti GrammarBuilder al set di alternative. |
Add(String[]) |
Aggiunge una matrice contenente uno o più oggetti String al set di alternative. |
Add(GrammarBuilder[])
- Origine:
- Choices.cs
- Origine:
- Choices.cs
Aggiunge una matrice contenente uno o più oggetti GrammarBuilder 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 oggetto Choices.
Esempio
Nell'esempio seguente viene creata una grammatica di riconoscimento vocale per frasi come "Chiama Anne sulla sua cella" e "Chiama James sul suo telefono di lavoro". Nell'esempio Add vengono usati entrambi gli overload del 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 , e oggetti a GrammarBuilder, queste tre classi possono anche essere aggiunte a un'istanzaChoices.SemanticResultValueSemanticResultKeyChoices
Se alternateChoices
è una matrice vuota, questo metodo non aggiorna il set di alternative.
Le applicazioni possono usare entrambi Add(String[]) e Add(GrammarBuilder[]) per aggiungere alternative a un Choices oggetto.
Questo metodo genera un ArgumentNullException oggetto quando alternateChoices
è null
o uno degli elementi della matrice è null
.
Vedi anche
Si applica a
Add(String[])
- Origine:
- Choices.cs
- Origine:
- Choices.cs
Aggiunge una matrice contenente uno o più oggetti String 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
Esempio
Nell'esempio seguente viene creata una grammatica di riconoscimento vocale per frasi simili a "Chiama Anne sulla sua cella" e "Chiama James sul suo telefono di lavoro". Nell'esempio Add vengono usati entrambi gli overload del 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 entrambi Add(String[]) e 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 ArgumentNullException oggetto quando phrases
è null
o uno degli elementi della matrice è null
. Questo metodo genera un ArgumentException elemento se qualsiasi elemento della matrice è la stringa vuota ("").