Choices.Add Метод

Определение

Добавляет элементы в набор вариантов.

Перегрузки

Add(GrammarBuilder[])

Добавляет массив, содержащий один или несколько объектов GrammarBuilder, в набор вариантов.

Add(String[])

Добавляет массив, содержащий один или несколько объектов String, в набор вариантов.

Add(GrammarBuilder[])

Исходный код:
Choices.cs
Исходный код:
Choices.cs

Добавляет массив, содержащий один или несколько объектов GrammarBuilder, в набор вариантов.

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.

Примеры

В следующем примере создается грамматика распознавания речи для таких фраз, как "Позвонить Анне в ячейку" и "Позвонить Джеймсу по рабочему телефону". В примере используются обе перегрузки метода для Add построения грамматики.

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 экземпляр .

Если alternateChoices является пустым массивом, этот метод не обновляет набор альтернатив.

Приложения могут использовать как для добавления альтернатив объектуChoices, так Add(String[]) и Add(GrammarBuilder[]) .

Этот метод вызывает исключение , ArgumentNullException если alternateChoices имеет значение null или любой из элементов массива имеет значение null.

См. также раздел

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

Add(String[])

Исходный код:
Choices.cs
Исходный код:
Choices.cs

Добавляет массив, содержащий один или несколько объектов String, в набор вариантов.

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.

Примеры

В следующем примере создается грамматика распознавания речи для фраз, похожих на "Позвонить Анне в ячейку" и "Позвонить Джеймсу по рабочему телефону". В примере используются обе перегрузки метода для Add построения грамматики.

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, так Add(String[]) и Add(GrammarBuilder[]) .

Если phrases является пустым массивом, этот метод не обновляет набор вариантов.

Этот метод вызывает исключение , ArgumentNullException если phrases имеет значение null или любой из элементов массива имеет значение null. Этот метод вызывает исключение , ArgumentException если какой-либо элемент в массиве является пустой строкой ("").

См. также раздел

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