Choices Classe

Definizione

Rappresenta un set di alternative ai vincoli di una grammatica di riconoscimento vocale.

public class Choices
Ereditarietà
Choices

Esempio

Nell'esempio seguente viene creata una grammatica di riconoscimento vocale per la frase "Impostare sfondo su colorChoice", dove colorChoice può essere uno dei colori definiti. Viene GrammarBuilder usato per definire i vincoli per la grammatica.

private Grammar CreateColorGrammar()  
{  

  // Create a Choices object that contains a set of alternative colors.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  colorChoice.Add(new string[] {"cyan", "yellow", "magenta"});  

  // Construct the phrase.  
  GrammarBuilder builder = new GrammarBuilder("Set background to");  
  builder.Append(colorChoice);  

  // Create a grammar for the phrase.  
  Grammar colorGrammar = new Grammar(builder);  
  colorGrammar.Name = "SetBackground";  

  return colorGrammar;  
}  

Commenti

Un Choices oggetto rappresenta un componente di una frase che può avere uno dei diversi valori. Usare questa classe durante la creazione di una grammatica di riconoscimento vocale da un GrammarBuilder oggetto.

Ad esempio, un Choices oggetto potrebbe rappresentare il colore componenteChoice nella frase "Modificare il colore in colorChoice", dove i valori accettabili per colorChoice sono "rosso", o "verde" o "blu".

Nota

Per usare un Choices oggetto come componente facoltativo in una frase, creare l'oggetto Choices e aggiungerlo a un GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) oggetto con minRepeat e maxRepeat impostare rispettivamente su 0 e 1. Le frasi contenenti componenti facoltativi possono essere riconosciute se il componente facoltativo è parlato o meno.

La Choices classe funge dalla stessa funzione dell'elemento one-of XML definito dalla Specifica grammatica riconoscimento vocale (SRGS) versione 1.0 e è simile alla SrgsOneOf classe nello System.Speech.Recognition.SrgsGrammar spazio dei nomi.

Per altre informazioni sulla definizione di una grammatica di riconoscimento vocale, vedere Riconoscimento vocale.

Costruttori

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.

Metodi

Add(GrammarBuilder[])

Aggiunge una matrice contenente uno o più oggetti GrammarBuilder al set di alternative.

Add(String[])

Aggiunge una matrice contenente uno o più oggetti String al set di alternative.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToGrammarBuilder()

Restituisce un oggetto GrammarBuilder dall'oggetto Choices.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Prodotto Versioni
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

Vedi anche