Choices Constructores

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Paquete:

System.Speech v9.0.0-rc.2.24473.5

Inicializa una nueva instancia de la clase Choices.

Sobrecargas

Choices()	Inicializa una nueva instancia de la clase Choices que contiene un conjunto vacío de alternativas.
Choices(GrammarBuilder[])	Inicializa una nueva instancia de la clase Choices desde una matriz que contiene uno o más objetos GrammarBuilder.
Choices(String[])	Inicializa una nueva instancia de la clase Choices desde una matriz que contiene uno o más objetos String.

Ejemplos

En el ejemplo siguiente se usan Choices objetos para crear dos listas de alternativas.

El primer Choices objeto se construye a partir de una matriz de String objetos . El otro Choices objeto se construye a partir de una matriz de GrammarBuilder objetos que se han convertido implícitamente mediante una conversión.

En el ejemplo se usa un GrammarBuilder objeto para ensamblar una frase, mediante los Choices objetos y dos cadenas adicionales, que se pueden usar para reconocer la entrada de voz en forma de "Llamar a [contactlList] en el teléfono [phoneType], por ejemplo, "Llamar a Jane en el teléfono móvil".

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

Comentarios

Puede construir un Choices objeto mediante un constructor sin parámetros (que devuelve un objeto vacío), a partir de un grupo de String objetos o de un conjunto de GrammarBuilder objetos.

Dado que el objeto admite la GrammarBuilder conversión implícita de SemanticResultValue y SemanticResultKey, se puede construir a Choices partir de una matriz de estos objetos mediante una conversión.

Choices()

Inicializa una nueva instancia de la clase Choices que contiene un conjunto vacío de alternativas.

public:
 Choices();

public Choices ();

Public Sub New ()

Ejemplos

En el ejemplo siguiente se usan Choices objetos y GrammarBuilder para crear una frase que se puede usar para reconocer la entrada de voz, como "Llamar a Anne en su celda" y "Llamar a James en su teléfono laboral". En el ejemplo se usan conversiones implícitas de Choices y String a 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);  
}  

Comentarios

Este constructor devuelve un conjunto válido y vacío de alternativas. Puede agregar alternativas mediante cualquiera de los Add métodos .

Consulte también

• Grammar
• GrammarBuilder

Choices(GrammarBuilder[])

Inicializa una nueva instancia de la clase Choices desde una matriz que contiene uno o más objetos 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())

Parámetros

alternateChoices

GrammarBuilder[]

Una matriz que contiene el conjunto de alternativas.

Ejemplos

En el ejemplo siguiente se usan Choices objetos y GrammarBuilder para crear para Grammar frases como "Llamar a Anne en su celda" y "Llamar a James en su teléfono laboral". En el ejemplo se usan conversiones implícitas de Choices y String a 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);  
}  

Comentarios

Cada GrammarBuilder elemento alternateChoices de define una alternativa. Si alternateChoices es una matriz vacía, el constructor devuelve un conjunto vacío de alternativas. Puede agregar alternativas mediante cualquiera de los Add métodos .

El constructor produce un ArgumentNullException cuando alternateChoices es null o cuando cualquiera de los elementos de matriz es null.

Dado que la clase proporciona compatibilidad con la GrammarBuilder conversión implícita de Choicesobjetos , SemanticResultValuey SemanticResultKey en GrammarBuilder instancias, mediante conversiones correctamente, este constructor también se puede usar para crear un Choices objeto a partir de una lista de cualquier combinación de estos objetos.

Consulte también

• Grammar
• GrammarBuilder

Choices(String[])

Inicializa una nueva instancia de la clase Choices desde una matriz que contiene uno o más objetos 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())

Parámetros

phrases

String[]

Una matriz que contiene el conjunto de alternativas.

Ejemplos

En el ejemplo siguiente se usan Choices objetos y GrammarBuilder para crear para Grammar las frases como "Llamar a Anne en su celda" y "Llamar a James en su teléfono laboral". En el ejemplo se usan conversiones implícitas de Choices y String a 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);  
}  

Comentarios

Cada String elemento phrases de define una alternativa. El motor de reconocimiento de voz puede usar cualquiera de los elementos de la matriz de cadenas para que coincidan con la entrada de voz. Si phrases es una matriz vacía, el constructor devuelve un conjunto vacío de alternativas. Puede agregar alternativas mediante cualquiera de los Add métodos .

El constructor produce una ArgumentNullException excepción cuando phrases es null o cualquiera de los elementos de la matriz son null. El constructor produce si ArgumentException algún elemento de la matriz es una cadena vacía ("").

Consulte también

• Grammar
• GrammarBuilder