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

Определение

Пространство имен:

System.Speech.Recognition

Сборка:

System.Speech.dll

Инициализирует новый экземпляр класса Choices.

Перегрузки

Choices()	Инициализирует новый экземпляр класса Choices, содержащий пустой набор вариантов.
Choices(GrammarBuilder[])	Инициализирует экземпляр класса Choices из массива, содержащего один или несколько объектов GrammarBuilder.
Choices(String[])	Инициализирует экземпляр класса Choices из массива, содержащего один или несколько объектов String.

Примеры

В следующем примере объекты используются Choices для создания двух списков альтернативных вариантов.

Первый Choices объект создается из массива String объектов. Другой Choices объект создается из массива GrammarBuilder объектов, которые были неявно преобразованы приведением.

В примере используется GrammarBuilder объект для сборки фразы с помощью Choices объектов и двух дополнительных строк, которые можно использовать для распознавания голосовых данных в виде "Call [contactlList] на телефоне [phoneType], например "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 объектов.

GrammarBuilder Так как объект поддерживает неявное преобразование из SemanticResultValue иSemanticResultKey, Choices можно создать из массива этих объектов с помощью приведения.

Choices()

Инициализирует новый экземпляр класса Choices, содержащий пустой набор вариантов.

public:
 Choices();

public Choices ();

Public Sub New ()

Примеры

В следующем примере используются Choices и GrammarBuilder объекты для создания фразы, которую можно использовать для распознавания голосового ввода, например "Звонок Энн в ее ячейке" и "Звонок Джеймса на рабочем телефоне". В примере используются неявные приведения из Choices и String в 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);  
}  

Комментарии

Этот конструктор возвращает допустимый пустой набор альтернативных вариантов. Вы можете добавить альтернативные варианты с помощью любого из Add методов.

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

• Grammar
• GrammarBuilder

Choices(GrammarBuilder[])

Инициализирует экземпляр класса Choices из массива, содержащего один или несколько объектов GrammarBuilder.

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[]

Массив, содержащий набор альтернатив.

Примеры

В следующем примере используются Choices и GrammarBuilder объекты для создания Grammar фраз, таких как "Call Anne on her cell" и "Call James on his work phone". В примере используются неявные приведения из Choices и String в 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 определяет одну альтернативу. Если alternateChoices это пустой массив, конструктор возвращает пустой набор альтернативных вариантов. Вы можете добавить альтернативные варианты с помощью любого из Add методов.

Конструктор создает исключение ArgumentNullException when alternateChoices null или when any of the array elements are null.

GrammarBuilder Так как класс обеспечивает поддержку неявного преобразования SemanticResultValueChoicesобъектов и SemanticResultKey объектов в GrammarBuilder экземпляры, правильно используя приведения, этот конструктор также можно использовать для создания Choices объекта из списка любого сочетания этих объектов.

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

• Grammar
• GrammarBuilder

Choices(String[])

Инициализирует экземпляр класса Choices из массива, содержащего один или несколько объектов String.

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[]

Массив, содержащий набор альтернатив.

Примеры

В следующем примере используются Choices и GrammarBuilder объекты для создания Grammar фраз, таких как "Call Anne on her cell" и "Call James on the work phone". В примере используются неявные приведения из Choices и String в 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 определяет одну альтернативу. Подсистема распознавания речи может использовать любой из элементов в массиве строк для сопоставления входных данных речи. Если phrases это пустой массив, конструктор возвращает пустой набор альтернативных вариантов. Вы можете добавить альтернативные варианты с помощью любого из Add методов.

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

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

• Grammar
• GrammarBuilder