Choices Costruttori

Definizione

Spazio dei nomi:

System.Speech.Recognition

Assembly:

System.Speech.dll

Pacchetto:

System.Speech v9.0.0-preview.4.24266.19

Inizializza una nuova istanza della classe Choices.

Overload

Choices()	Inizializza una nuova istanza della classe Choices contenente un set di alternative vuoto.
Choices(GrammarBuilder[])	Inizializza una nuova istanza della classe Choices da una matrice contenente uno o più oggetti GrammarBuilder.
Choices(String[])	Inizializza una nuova istanza della classe Choices da una matrice contenente uno o più oggetti String.

Esempio

Nell'esempio seguente vengono Choices usati oggetti per creare due elenchi di alternative.

Il primo Choices oggetto viene costruito da una matrice di String oggetti. L'altro Choices oggetto viene costruito da una matrice di GrammarBuilder oggetti che sono stati convertiti in modo implicito da un cast.

Nell'esempio viene usato un oggetto per assemblare una GrammarBuilder frase, usando gli Choices oggetti e due stringhe aggiuntive, che possono essere usate per riconoscere l'input vocale sotto forma di "Call [contactlList] on [phoneType] phone" , ad esempio "Chiama Jane sul cellulare".

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

Commenti

È possibile costruire un oggetto usando un Choices costruttore senza parametri (che restituisce un oggetto vuoto), da un gruppo di oggetti o da un set di GrammarBuilderString oggetti.

Poiché l'oggetto GrammarBuilder supporta la conversione implicita da SemanticResultValue e SemanticResultKey, un Choices oggetto può essere costruito da una matrice di questi oggetti usando un cast.

Choices()

Origine:

Choices.cs

Inizializza una nuova istanza della classe Choices contenente un set di alternative vuoto.

public:
 Choices();

public Choices ();

Public Sub New ()

Esempio

L'esempio seguente usa Choices e GrammarBuilder oggetti per creare una frase che può essere usata per riconoscere l'input vocale, ad esempio "Chiama Anne sulla sua cella" e "Chiama James sul suo telefono di lavoro". Nell'esempio vengono usati cast impliciti da Choices e 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);  
}  

Commenti

Questo costruttore restituisce un set di alternative valido e vuoto. È possibile aggiungere alternative usando uno qualsiasi dei Add metodi.

Vedi anche

• Grammar
• GrammarBuilder

Choices(GrammarBuilder[])

Origine:

Choices.cs

Inizializza una nuova istanza della classe Choices da una matrice contenente uno o più oggetti 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())

Parametri

alternateChoices

GrammarBuilder[]

Matrice contenente il set di alternative.

Esempio

L'esempio seguente usa Choices e GrammarBuilder oggetti per creare un Grammar oggetto per frasi come "Chiama Anne sulla sua cella" e "Chiama James sul suo telefono di lavoro". Nell'esempio vengono usati cast impliciti da Choices e 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);  
}  

Commenti

Ognuno GrammarBuilder di essi alternateChoices definisce un'alternativa. Se alternateChoices è una matrice vuota, il costruttore restituisce un set vuoto di alternative. È possibile aggiungere alternative usando uno qualsiasi dei Add metodi.

Il costruttore genera un ArgumentNullException valore quando alternateChoices è null o quando uno degli elementi della matrice è null.

Poiché la GrammarBuilder classe fornisce supporto per la conversione implicita di Choices, SemanticResultValuee SemanticResultKey oggetti in GrammarBuilder istanze, usando correttamente i cast, questo costruttore può essere usato anche per creare un oggetto da un Choices elenco di qualsiasi combinazione di questi oggetti.

Vedi anche

• Grammar
• GrammarBuilder

Choices(String[])

Origine:

Choices.cs

Inizializza una nuova istanza della classe Choices da una matrice contenente uno o più oggetti 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())

Parametri

phrases

String[]

Matrice contenente il set di alternative.

Esempio

Nell'esempio seguente vengono usati Choices e GrammarBuilder oggetti per creare un Grammar oggetto per le frasi, ad esempio "Chiama Anne sulla sua cella" e "Chiama James sul suo telefono di lavoro". Nell'esempio vengono usati cast impliciti da Choices e 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);  
}  

Commenti

Ognuno String di essi phrases definisce un'alternativa. Il motore di riconoscimento vocale può usare uno degli elementi nella matrice di stringhe per corrispondere all'input vocale. Se phrases è una matrice vuota, il costruttore restituisce un set vuoto di alternative. È possibile aggiungere alternative usando uno qualsiasi dei Add metodi.

Il costruttore genera un ArgumentNullException oggetto quando phrases è null o uno degli elementi della matrice è null. Il costruttore genera un ArgumentException elemento se qualsiasi elemento della matrice è una stringa vuota ("").

Vedi anche

• Grammar
• GrammarBuilder