Choices Constructores

Definición

Inicializa una nueva instancia de la clase Choices.

Sobrecargas

Nombre Description
Choices()

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

Choices(GrammarBuilder[])

Inicializa una nueva instancia de la Choices clase a partir de una matriz que contiene uno o varios GrammarBuilder objetos.

Choices(String[])

Inicializa una nueva instancia de la Choices clase a partir de una matriz que contiene uno o varios String objetos.

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 "Call [contactlList] on [phoneType] phone", por ejemplo "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;
}

Comentarios

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

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

Choices()

Source:
Choices.cs
Source:
Choices.cs
Source:
Choices.cs
Source:
Choices.cs

Inicializa una nueva instancia de la Choices clase 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 de trabajo". 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

Se aplica a

Choices(GrammarBuilder[])

Source:
Choices.cs
Source:
Choices.cs
Source:
Choices.cs
Source:
Choices.cs

Inicializa una nueva instancia de la Choices clase a partir de una matriz que contiene uno o varios GrammarBuilder objetos.

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

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 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 una ArgumentNullException excepción when 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 el uso correcto de conversiones, 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

Se aplica a

Choices(String[])

Source:
Choices.cs
Source:
Choices.cs
Source:
Choices.cs
Source:
Choices.cs

Inicializa una nueva instancia de la Choices clase a partir de una matriz que contiene uno o varios String objetos.

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

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 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 matriz son null. El constructor produce un ArgumentException si algún elemento de la matriz es una cadena vacía ("").

Consulte también

Se aplica a