Choices.Add Метод

Определение

Добавляет элементы в набор вариантов.Adds items to the set of alternatives.

Перегрузки

Add(GrammarBuilder[])

Добавляет массив, содержащий один или несколько объектов GrammarBuilder, в набор вариантов.Adds an array containing one or more GrammarBuilder objects to the set of alternatives.

Add(String[])

Добавляет массив, содержащий один или несколько объектов String, в набор вариантов.Adds an array containing one or more String objects to the set of alternatives.

Add(GrammarBuilder[])

Добавляет массив, содержащий один или несколько объектов GrammarBuilder, в набор вариантов.Adds an array containing one or more GrammarBuilder objects to the set of alternatives.

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

Параметры

alternateChoices
GrammarBuilder[]

Объект GrammarBuilder, добавляемый в данный объект Choices.The GrammarBuilder objects to add to this Choices object.

Примеры

В следующем примере создается Грамматика распознавания речи для таких фраз, как "Вызов Anne в своей ячейке" и "вызов Джеймс на своем рабочем телефоне".The following example creates a speech recognition grammar for phrases such as "Call Anne on her cell" and "Call James on his work phone". В примере используются обе перегрузки Add метода для создания грамматики.The example uses both overloads of the Add method to build the grammar.

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

Комментарии

Из-за поддержки неявного Choicesпреобразования SemanticResultKeyиз объектов SemanticResultValue , и GrammarBuilderв в эти три класса также могут быть добавлены Choices в экземпляр.Because of support for implicit conversion from Choices, SemanticResultKey, and SemanticResultValue objects to GrammarBuilder, these three classes may be added to a Choices instance as well.

Если alternateChoices является пустым массивом, этот метод не обновляет набор альтернатив.If alternateChoices is an empty array, this method does not update the set of alternatives.

Приложения могут использовать Add(String[]) и, Add(GrammarBuilder[]) и Choices для добавления альтернативных вариантов к объекту.Applications can use both Add(String[]) and Add(GrammarBuilder[]) to add alternatives to a Choices object.

Этот метод создает исключение ArgumentNullException , alternateChoices если null имеет значение или любой из элементов массива null—.This method throws an ArgumentNullException when alternateChoices is null or any of the array elements are null.

Дополнительно

Add(String[])

Добавляет массив, содержащий один или несколько объектов String, в набор вариантов.Adds an array containing one or more String objects to the set of alternatives.

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

Параметры

phrases
String[]

Строки для добавления в этот объект Choices.The strings to add to this Choices object.

Примеры

В следующем примере создается Грамматика распознавания речи для фраз, похожих на "Вызов Anne в своей ячейке" и "вызове Джеймс на своем рабочем телефоне".The following example creates a speech recognition grammar for phrases similar to "Call Anne on her cell" and "Call James on his work phone". В примере используются обе перегрузки Add метода для создания грамматики.The example uses both overloads of the Add method to build the grammar.

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

Комментарии

Приложения могут использовать Add(String[]) и, Add(GrammarBuilder[]) и Choices для добавления альтернативных вариантов к объекту.Applications can use both Add(String[]) and Add(GrammarBuilder[]) to add alternatives to a Choices object.

Если phrases является пустым массивом, этот метод не обновляет набор вариантов.If phrases is an empty array, this method does not update the set of alternates.

Этот метод создает исключение ArgumentNullException , phrases если null имеет значение или любой из элементов массива null—.This method throws an ArgumentNullException when phrases is null or any of the array elements are null. Этот метод создает исключение ArgumentException , если любой элемент массива является пустой строкой ("").This method throws an ArgumentException if any element in the array is the empty string ("").

Дополнительно

Применяется к