Choices Construtores

Definição

Inicializa uma nova instância da Choices classe.

Sobrecargas

Name Description
Choices()

Inicializa uma nova instância da Choices classe que contém um conjunto vazio de alternativas.

Choices(GrammarBuilder[])

Inicializa uma nova instância da Choices classe a partir de um array que contém um ou mais GrammarBuilder objetos.

Choices(String[])

Inicializa uma nova instância da Choices classe a partir de um array que contém um ou mais String objetos.

Exemplos

O exemplo seguinte utiliza Choices objetos para criar duas listas de alternativas.

O primeiro Choices objeto é construído a partir de um array de String objetos. O outro Choices objeto é construído a partir de um array de GrammarBuilder objetos que foram implicitamente convertidos por um cast.

O exemplo usa um GrammarBuilder objeto para montar uma frase, usando os Choices objetos e duas cadeias adicionais, que podem ser usadas para reconhecer entrada de fala na forma de "Chamar [ContactlList] no [phoneType] telefone", por exemplo "Chamar Jane no telemóvel".

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

Observações

Pode construir um Choices objeto usando um construtor sem parâmetros (que devolve um objeto vazio), a partir de um grupo de String objetos, ou um conjunto de objetos a partir de GrammarBuilder .

Como o GrammarBuilder objeto suporta conversão implícita de SemanticResultValue e SemanticResultKey, a Choices pode ser construído a partir de um array destes objetos usando um cast.

Choices()

Origem:
Choices.cs
Origem:
Choices.cs
Origem:
Choices.cs
Origem:
Choices.cs

Inicializa uma nova instância da Choices classe que contém um conjunto vazio de alternativas.

public:
 Choices();
public Choices();
Public Sub New ()

Exemplos

O exemplo seguinte utiliza Choices e GrammarBuilder pretende criar uma frase que pode ser usada para reconhecer a entrada da fala, como "Liga à Anne para o telemóvel dela" e "Liga ao James para o telefone do trabalho". O exemplo usa casts implícitos de Choices e String para 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);
}

Observações

Este construtor devolve um conjunto válido e vazio de alternativas. Pode adicionar alternativas usando qualquer um dos Add métodos.

Ver também

Aplica-se a

Choices(GrammarBuilder[])

Origem:
Choices.cs
Origem:
Choices.cs
Origem:
Choices.cs
Origem:
Choices.cs

Inicializa uma nova instância da Choices classe a partir de um array que contém um ou mais 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[]

Um array contendo o conjunto de alternativas.

Exemplos

O exemplo seguinte utiliza Choices e GrammarBuilder serve para criar Grammar frases como "Ligue à Anne para o telemóvel dela" e "Ligue ao James para o telefone do trabalho". O exemplo usa casts implícitos de Choices e String para 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);
}

Observações

Cada GrammarBuilder um em alternateChoices define uma alternativa. Se alternateChoices for um array vazio, o construtor devolve um conjunto vazio de alternativas. Pode adicionar alternativas usando qualquer um dos Add métodos.

O construtor lança um ArgumentNullException quando alternateChoices é null ou quando qualquer um dos elementos do array é null.

Como a GrammarBuilder classe fornece suporte para conversão implícita de Choices, SemanticResultValue, e SemanticResultKey objetos em GrammarBuilder instâncias, usando corretamente casts, este construtor também pode ser usado para criar um Choices objeto a partir de uma lista de qualquer combinação destes objetos.

Ver também

Aplica-se a

Choices(String[])

Origem:
Choices.cs
Origem:
Choices.cs
Origem:
Choices.cs
Origem:
Choices.cs

Inicializa uma nova instância da Choices classe a partir de um array que contém um ou mais 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[]

Um array contendo o conjunto de alternativas.

Exemplos

O exemplo seguinte utiliza Choices e GrammarBuilder serve para criar frases Grammar como "Liga à Anne para o telemóvel dela" e "Liga ao James para o telefone do trabalho". O exemplo usa casts implícitos de Choices e String para 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);
}

Observações

Cada String um em phrases define uma alternativa. O motor de reconhecimento de voz pode usar qualquer um dos itens do array de cadeias para corresponder à entrada de voz. Se phrases for um array vazio, o construtor devolve um conjunto vazio de alternativas. Pode adicionar alternativas usando qualquer um dos Add métodos.

O construtor lança um ArgumentNullException quando phrases é null ou qualquer um dos elementos do array é null. O construtor lança um ArgumentException se qualquer elemento do array for uma cadeia vazia ("").

Ver também

Aplica-se a