Choices Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe Choices.
Sobrecargas
| Choices() |
Inicializa uma nova instância da classe Choices que contém um conjunto vazio de alternativas. |
| Choices(GrammarBuilder[]) |
Inicializa uma nova instância da Choices classe de uma matriz que contém um ou mais objetos GrammarBuilder. |
| Choices(String[]) |
Inicializa uma nova instância da Choices classe de uma matriz que contém um ou mais objetos String. |
Exemplos
O exemplo a seguir usa Choices objetos para criar duas listas de alternativas.
O primeiro Choices objeto é construído a partir de uma matriz de String objetos. O outro Choices objeto é construído a partir de uma matriz de GrammarBuilder objetos que foram convertidos implicitamente por uma conversão.
O exemplo usa um GrammarBuilder objeto para montar uma frase, usando os Choices objetos e duas cadeias de caracteres adicionais, que podem ser usadas para reconhecer a entrada de fala na forma de "Call [contactlList] on [phoneType] phone", por exemplo, "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;
}
Comentários
Você pode construir um Choices objeto usando um construtor sem parâmetros (que retorna um objeto vazio), de um grupo de String objetos ou de um conjunto de GrammarBuilder objetos.
Como o GrammarBuilder objeto dá suporte à conversão implícita de SemanticResultValue e SemanticResultKey, um Choices pode ser construído a partir de uma matriz desses objetos usando uma conversão.
Choices()
Inicializa uma nova instância da classe Choices que contém um conjunto vazio de alternativas.
public:
Choices();public Choices ();Public Sub New ()Exemplos
O exemplo a seguir usa Choices e GrammarBuilder objetos para criar uma frase que pode ser usada para reconhecer entradas de fala, como "Chamar Anne em sua cela" e "Chamar James em seu telefone de trabalho". O exemplo usa conversões implícitas 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);
}
Comentários
Esse construtor retorna um conjunto válido e vazio de alternativas. Você pode adicionar alternativas usando qualquer um dos Add métodos.
Confira também
Aplica-se a
Choices(GrammarBuilder[])
Inicializa uma nova instância da Choices classe de uma matriz que contém um ou mais 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.ChoicesPublic Sub New (ParamArray alternateChoices As GrammarBuilder())Parâmetros
- alternateChoices
- GrammarBuilder[]
Uma matriz contendo o conjunto de alternativas.
Exemplos
O exemplo a seguir usa Choices e GrammarBuilder objetos para criar um Grammar for frases como, "Chame Anne em sua cela" e "Ligue para James em seu telefone de trabalho". O exemplo usa conversões implícitas 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);
}
Comentários
Cada GrammarBuilder um deles alternateChoices define uma alternativa. Se alternateChoices for uma matriz vazia, o construtor retornará um conjunto vazio de alternativas. Você 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 da matriz são null.
Como a GrammarBuilder classe fornece suporte para conversão implícita de Choices, SemanticResultValuee SemanticResultKey objetos em GrammarBuilder instâncias, usando corretamente conversões, esse construtor também pode ser usado para criar um Choices objeto a partir de uma lista de qualquer combinação desses objetos.
Confira também
Aplica-se a
Choices(String[])
public:
Choices(... cli::array <System::String ^> ^ phrases);public Choices (params string[] phrases);new System.Speech.Recognition.Choices : string[] -> System.Speech.Recognition.ChoicesPublic Sub New (ParamArray phrases As String())Parâmetros
- phrases
- String[]
Uma matriz contendo o conjunto de alternativas.
Exemplos
O exemplo a seguir usa Choices e GrammarBuilder objetos para criar um Grammar para as frases, como "Chamar Anne em seu celular" e "Ligue para James em seu telefone de trabalho". O exemplo usa conversões implícitas 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);
}
Comentários
Cada String um deles phrases define uma alternativa. O mecanismo de reconhecimento de fala pode usar qualquer um dos itens na matriz de cadeia de caracteres para corresponder à entrada de fala. Se phrases for uma matriz vazia, o construtor retornará um conjunto vazio de alternativas. Você pode adicionar alternativas usando qualquer um dos Add métodos.
O construtor lança um ArgumentNullException quando phrases é null ou qualquer um dos elementos de matriz são null. O construtor lança um ArgumentException elemento se algum elemento na matriz for uma cadeia de caracteres vazia ("").