Choices Класс

Определение

Представляет набор вариантов в ограничениях грамматики распознавания речи.Represents a set of alternatives in the constraints of a speech recognition grammar.

public ref class Choices
public class Choices
type Choices = class
Public Class Choices
Наследование
Choices

Примеры

В следующем примере создается Грамматика распознавания речи для фразы «Set Background to колорчоице», где колорчоице может быть одним из определенных цветов.The following example creates a speech recognition grammar for the phrase, "Set background to colorChoice", where colorChoice can be one of the defined colors. Объект GrammarBuilder используется для определения ограничений грамматики.The GrammarBuilder is used to define the constraints for the grammar.

  
private Grammar CreateColorGrammar()  
{  
  
  // Create a Choices object that contains a set of alternative colors.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  colorChoice.Add(new string[] {"cyan", "yellow", "magenta"});  
  
  // Construct the phrase.  
  GrammarBuilder builder = new GrammarBuilder("Set background to");  
  builder.Append(colorChoice);  
  
  // Create a grammar for the phrase.  
  Grammar colorGrammar = new Grammar(builder);  
  colorGrammar.Name = "SetBackground";  
  
  return colorGrammar;  
}  

Комментарии

Choices Объект представляет компонент фразы, который может иметь одно из нескольких значений.A Choices object represents a component of a phrase that can have one of several values. Используйте этот класс при создании грамматики распознавания речи из GrammarBuilder объекта.Use this class when creating a speech recognition grammar from a GrammarBuilder object.

Например Choices , объект может представлять компонент колорчоице в фразе «изменить цвет на колорчоице», где допустимыми значениями для колорчоице являются «Red», «Green» или «Blue».For example, a Choices object could represent the component colorChoice in the phrase, "Change the color to colorChoice", where acceptable values for colorChoice are "red", or "green", or "blue".

Примечание

Чтобы Choices использовать объект в качестве необязательного компонента в фразе, GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) Choices создайте объект и добавьте его в объект с параметром maxRepeat minRepeat и установите в значение 0 и 1 соответственно.To use a Choices object as an optional component in a phrase, create the Choices object and add it to a GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) object with minRepeat and maxRepeat set to 0 and 1, respectively. Фразы, содержащие дополнительные компоненты, могут быть распознаны независимо от того, является ли необязательным компонент.Phrases containing optional components can be recognized whether or not the optional component is spoken.

System.Speech.Recognition.SrgsGrammar one-of SrgsOneOf Класс выполняет ту же функцию, что и элемент XML, определенный в спецификации грамматики распознавания речи (SRGS) версии 1,0, и аналогичен классу в пространстве имен. ChoicesThe Choices class serves the same function as the one-of XML element defined by the Speech Recognition Grammar Specification (SRGS) Version 1.0 and is similar to the SrgsOneOf class in the System.Speech.Recognition.SrgsGrammar namespace.

Дополнительные сведения об определении грамматики распознавания речи см. в разделе Распознавание речи и Создание грамматик граммарбуилдер.For more information about defining a speech recognition grammar, see Speech Recognition and Creating GrammarBuilder Grammars.

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

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.

Методы

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.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToGrammarBuilder()

Возвращает объект GrammarBuilder из данного объекта Choices.Returns a GrammarBuilder object from this Choices object.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

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

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