Choices Clase

Definición

Representa un conjunto de alternativas en las restricciones de una gramática de reconocimiento de voz.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
Herencia
Choices

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz para la frase "Set Background to colorChoice", donde colorChoice puede ser uno de los colores definidos.The following example creates a speech recognition grammar for the phrase, "Set background to colorChoice", where colorChoice can be one of the defined colors. El GrammarBuilder se utiliza para definir las restricciones para la gramática.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;  
}  

Comentarios

Un objeto Choices representa un componente de una frase que puede tener uno de varios valores.A Choices object represents a component of a phrase that can have one of several values. Utilice esta clase al crear una gramática de reconocimiento de voz a partir de un objeto de GrammarBuilder.Use this class when creating a speech recognition grammar from a GrammarBuilder object.

Por ejemplo, un objeto Choices podría representar el componente colorChoice en la frase "cambiar el color a colorChoice", donde los valores aceptables para colorChoice son "rojo", "verde" o "azul".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".

Nota

Para usar un objeto de Choices como componente opcional en una frase, cree el objeto Choices y agréguelo a un objeto GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) con minRepeat y maxRepeat establecidos en 0 y 1, respectivamente.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. Se pueden reconocer frases que contengan componentes opcionales tanto si el componente opcional se pronuncia como si no.Phrases containing optional components can be recognized whether or not the optional component is spoken.

La clase Choices actúa como la misma función que el elemento XML one-of definido por la versión 1,0 de la especificación de la gramática de reconocimiento de voz (SRGS) y es similar a la clase SrgsOneOf del espacio de nombres System.Speech.Recognition.SrgsGrammar.The 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.

Para obtener más información acerca de cómo definir una gramática de reconocimiento de voz, consulte reconocimiento de voz.For more information about defining a speech recognition grammar, see Speech Recognition.

Constructores

Choices()

Inicializa una nueva instancia de la clase Choices que contiene un conjunto vacío de alternativas.Initializes a new instance of the Choices class that contains an empty set of alternatives.

Choices(GrammarBuilder[])

Inicializa una nueva instancia de la clase Choices desde una matriz que contiene uno o más objetos GrammarBuilder.Initializes a new instance of the Choices class from an array containing one or more GrammarBuilder objects.

Choices(String[])

Inicializa una nueva instancia de la clase Choices desde una matriz que contiene uno o más objetos String.Initializes a new instance of the Choices class from an array containing one or more String objects.

Métodos

Add(GrammarBuilder[])

Agrega una matriz que contiene uno o más objetos GrammarBuilder al conjunto de alternativas.Adds an array containing one or more GrammarBuilder objects to the set of alternatives.

Add(String[])

Agrega una matriz que contiene uno o más objetos String al conjunto de alternativas.Adds an array containing one or more String objects to the set of alternatives.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToGrammarBuilder()

Devuelve un objeto GrammarBuilder desde este objeto Choices.Returns a GrammarBuilder object from this Choices object.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a

Consulte también: