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())
Параметры
Примеры
В следующем примере создается грамматика распознавания речи для фраз, похожих на "Позвонить Анне в ячейку" и "Позвонить Джеймсу по рабочему телефону". В примере используются обе перегрузки метода для 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 если какой-либо элемент в массиве является пустой строкой ("").