Choices Construtores
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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 ("").