Choices Конструкторы

Определение

Инициализирует новый экземпляр класса Choices.Initializes a new instance of the Choices class.

Перегрузки

Choices()

Инициализирует новый экземпляр класса Choices, содержащий пустой набор вариантов.Initializes a new instance of the Choices class that contains an empty set of alternatives.

Choices(GrammarBuilder[])

Инициализирует экземпляр класса Choices из массива, содержащего один или несколько объектов GrammarBuilder.Initializes a new instance of the Choices class from an array containing one or more GrammarBuilder objects.

Choices(String[])

Инициализирует экземпляр класса Choices из массива, содержащего один или несколько объектов String.Initializes a new instance of the Choices class from an array containing one or more String objects.

Примеры

В следующем примере объекты Choices используются для создания двух списков альтернатив.The following example uses Choices objects to create two lists of alternatives.

Первый Choices объект создается из String массива объектов.The first Choices object is constructed from an array of String objects. Другой Choices объект создается из GrammarBuilder массива объектов, которые были неявно преобразованы путем приведения.The other Choices object is constructed from an array of GrammarBuilder objects which have been implicitly converted by a cast.

В примере используется GrammarBuilder объект для сборки фразы Choices с использованием объектов и двух дополнительных строк, которые можно использовать для распознавания речевого ввода в форме "Call [контактллист] On [фонетипе] Phone", например "позвонить на сотовый телефон".The example uses a GrammarBuilder object to assemble a phrase, using the Choices objects and two additional strings, that can be used to recognize speech input in the form of "Call [contactlList] on [phoneType] phone" , for example "Call Jane on cell phone".

public GrammarBuilder ChoicesConstructor2 ()  
{  
    GrammarBuilder gb = new GrammarBuilder ();  
    Choices phoneType = new Choices (new string[] {"cell", "home", "work"});  
    Choices contactList = new Choices (new GrammarBuilder[] {(GrammarBuilder) "Mark", (GrammarBuilder) "Jane", (GrammarBuilder) "Frank"});  
    gb.Append ("Call");  
    gb.Append (contactList);  
    gb.Append ("on");  
    gb.Append (phoneType);  
    gb.Append ("phone");  
    return gb;  
}  

Комментарии

Choices Объект можно создать с помощью конструктора без параметров (который возвращает пустой объект) из String группы объектов GrammarBuilder или из набора объектов.You can construct a Choices object using a parameterless constructor (which returns an empty object), from a group of String objects, or a from set of GrammarBuilder objects.

Поскольку объект поддерживает неявное преобразование SemanticResultValue из SemanticResultKeyи, Choices может быть создан из массива этих объектов с помощью приведения. GrammarBuilderBecause the GrammarBuilder object supports implicit conversion from SemanticResultValue and SemanticResultKey, a Choices can be constructed from an array of these objects using a cast.

Choices()

Инициализирует новый экземпляр класса Choices, содержащий пустой набор вариантов.Initializes a new instance of the Choices class that contains an empty set of alternatives.

public:
 Choices();
public Choices ();
Public Sub New ()

Примеры

В следующем примере объекты Choices и GrammarBuilder используются для создания фразы, которую можно использовать для распознавания речевого ввода, например «Call Anne On The Cell» и «Call Джеймс on the рабочий телефон».The following example uses Choices and GrammarBuilder objects to create a phrase that can be used to recognize speech input such as "Call Anne on her cell" and "Call James on his work phone". В примере используются неявные приведения String типов GrammarBuilderиз Choices и к.The example uses implicit casts from Choices and String to GrammarBuilder.

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

Комментарии

Этот конструктор возвращает допустимый пустой набор альтернатив.This constructor returns a valid, empty set of alternatives. Можно добавить альтернативные Add методы с помощью любого из методов.You can add alternatives using any of the Add methods.

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

Choices(GrammarBuilder[])

Инициализирует экземпляр класса Choices из массива, содержащего один или несколько объектов GrammarBuilder.Initializes a new instance of the Choices class from an array containing one or more GrammarBuilder objects.

public:
 Choices(... cli::array <System::Speech::Recognition::GrammarBuilder ^> ^ alternateChoices);
public Choices (params System.Speech.Recognition.GrammarBuilder[] alternateChoices);
new System.Speech.Recognition.Choices : System.Speech.Recognition.GrammarBuilder[] -> System.Speech.Recognition.Choices
Public Sub New (ParamArray alternateChoices As GrammarBuilder())

Параметры

alternateChoices
GrammarBuilder[]

Массив, содержащий набор альтернатив.An array containing the set of alternatives.

Примеры

В следующем примере используются Choices объекты GrammarBuilder и для создания Grammar таких фраз, как, «Call Anne In The Cell» и «Call Джеймс on the рабочий телефон».The following example uses Choices and GrammarBuilder objects to create a Grammar for phrases such as, "Call Anne on her cell" and "Call James on his work phone". В примере используются неявные приведения String типов GrammarBuilderиз Choices и к.The example uses implicit casts from Choices and String to GrammarBuilder.

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

Комментарии

Каждый GrammarBuilder вalternateChoices определяет одну альтернативу.Each GrammarBuilder in alternateChoices defines one alternative. Если alternateChoices является пустым массивом, конструктор возвращает пустой набор альтернативных вариантов.If alternateChoices is an empty array, the constructor returns an empty set of alternatives. Можно добавить альтернативные Add методы с помощью любого из методов.You can add alternatives using any of the Add methods.

Конструктор создает исключение, ArgumentNullException если alternateChoices имеет null значение nullили если какой-либо из элементов массива является.The constructor throws an ArgumentNullException when alternateChoices is null or when any of the array elements are null.

GrammarBuilder Choices Choices SemanticResultKey SemanticResultValueПоскольку класс обеспечивает поддержку неявного преобразования объектов, и в экземпляры, используя приведения, этот конструктор можно также использовать для создания GrammarBuilder объект из списка любых сочетаний этих объектов.Because the GrammarBuilder class provides support for implicit conversion of Choices, SemanticResultValue, and SemanticResultKey objects to GrammarBuilder instances, by properly using casts, this constructor can also be used to create a Choices object from a list of any combination of these objects.

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

Choices(String[])

Инициализирует экземпляр класса Choices из массива, содержащего один или несколько объектов String.Initializes a new instance of the Choices class from an array containing one or more String objects.

public:
 Choices(... cli::array <System::String ^> ^ phrases);
public Choices (params string[] phrases);
new System.Speech.Recognition.Choices : string[] -> System.Speech.Recognition.Choices
Public Sub New (ParamArray phrases As String())

Параметры

phrases
String[]

Массив, содержащий набор альтернатив.An array containing the set of alternatives.

Примеры

В следующем примере используются Choices объекты GrammarBuilder и, чтобы создать Grammar для таких фраз, как, «Call Anne In The Cell» и «Call Джеймс on the рабочий телефон».The following example uses Choices and GrammarBuilder objects to create a Grammar for the phrases such as, "Call Anne on her cell" and "Call James on his work phone". В примере используются неявные приведения String типов GrammarBuilderиз Choices и к.The example uses implicit casts from Choices and String to GrammarBuilder.

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

Комментарии

Каждый String вphrases определяет одну альтернативу.Each String in phrases defines one alternative. Модуль распознавания речи может использовать любой элемент в массиве строк для сопоставления речевого ввода.The speech recognition engine can use any one of the items in the string array to match speech input. Если phrases является пустым массивом, конструктор возвращает пустой набор альтернативных вариантов.If phrases is an empty array, the constructor returns an empty set of alternatives. Можно добавить альтернативные Add методы с помощью любого из методов.You can add alternatives using any of the Add methods.

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

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

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