GrammarBuilder GrammarBuilder GrammarBuilder GrammarBuilder Constructors

Definizione

Overload

GrammarBuilder() GrammarBuilder() GrammarBuilder()

Inizializza una nuova istanza vuota della classe GrammarBuilder.Initializes a new, empty instance of the GrammarBuilder class.

GrammarBuilder(Choices) GrammarBuilder(Choices) GrammarBuilder(Choices) GrammarBuilder(Choices)

Inizializza una nuova istanza della classe GrammarBuilder da un set di alternative.Initializes a new instance of the GrammarBuilder class from a set of alternatives.

GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey)

Inizializza una nuova istanza della classe GrammarBuilder a partire da una chiave semantica.Initializes a new instance of the GrammarBuilder class from a semantic key.

GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue)

Inizializza una nuova istanza della classe GrammarBuilder a partire da un valore semantico.Initializes a new instance of the GrammarBuilder class from a semantic value.

GrammarBuilder(String) GrammarBuilder(String) GrammarBuilder(String) GrammarBuilder(String)

Inizializza una nuova istanza della classe GrammarBuilder da una sequenza di parole.Initializes a new instance of the GrammarBuilder class from a sequence of words.

GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode)

Inizializza una nuova istanza della classe GrammarBuilder per un subset di una sequenza di parole.Initializes a new instance of the GrammarBuilder class for a subset of a sequence of words.

GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32)

Inizializza una nuova istanza della classe GrammarBuilder da un elemento ripetuto.Initializes a new instance of the GrammarBuilder class from a repeated element.

GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32)

Inizializza una nuova istanza della classe GrammarBuilder dalla sequenza di parole in un oggetto String e specifica quante volte può essere ripetuto l'oggetto String.Initializes a new instance of the GrammarBuilder class from the sequence of words in a String and specifies how many times the String can be repeated.

Commenti

Istanze di questa classe possono anche essere ottenute da conversioni implicite da altre classi o combinando un GrammarBuilder con un oggetto al secondo da un nuovo GrammarBuilder.Instances of this class can also be obtained by implicit conversions from other classes or by combining a GrammarBuilder object with a second object to from a new GrammarBuilder. Per altre informazioni, vedere la Implicit e Addition metodi.For more information, see the Implicit and Addition methods.

Per aggiungere vincoli a un oggetto esistente GrammarBuilder, usare il Add, Append, AppendDictation, AppendRuleReference, e AppendWildcard metodi e il Addition operatore.To add constraints to an existing GrammarBuilder, use the Add, Append, AppendDictation, AppendRuleReference, and AppendWildcard methods, and the Addition operator.

Importante

Il riconoscimento vocale può generare un'eccezione quando si usa una grammatica di riconoscimento vocale che contiene gli elementi semantici duplicati con lo stesso nome di chiave o più elementi semantici che è stato possibile modificare ripetutamente il valore dello stesso elemento semantico.The speech recognizer can throw an exception when using a speech recognition grammar that contains duplicate semantic elements with the same key name or multiple semantic elements that could repeatedly modify the value of the same semantic element.

Per altre informazioni sulla creazione e uso grammatiche di riconoscimento vocale, vedere riconoscimento vocale e creare grammatiche GrammarBuilder.For more information about building and using speech recognition grammars, see Speech Recognition and Creating GrammarBuilder Grammars.

GrammarBuilder() GrammarBuilder() GrammarBuilder()

Inizializza una nuova istanza vuota della classe GrammarBuilder.Initializes a new, empty instance of the GrammarBuilder class.

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

Esempi

L'esempio seguente usa GrammarBuilder e Choices gli oggetti per costruire una grammatica che può riconoscere una delle due frasi, "sfondo colorChoice" o "impostato in background su colorChoice".The following example uses GrammarBuilder and Choices objects to construct a grammar that can recognize either of the two phrases, "Make background colorChoice" or "Set background to colorChoice".

L'esempio Usa un' Choices oggetto per creare un elenco di valori accettabili per colorChoice da una matrice di String oggetti.The example uses a Choices object to create a list of acceptable values for colorChoice from an array of String objects. Oggetto Choices è analogo all'oggetto di one-of elemento nella specifica di SRGS e contiene un set di frasi alternative, ciascuno dei quali può essere riconosciuto pronuncia.A Choices object is analogous to the one-of element in the SRGS specification, and contains a set of alternate phrases, any one of which can be recognized when spoken. L'esempio Usa anche un Choices oggetto per raggruppare un array di due GrammarBuilder gli oggetti in una coppia di frasi alternative in grado di riconoscere la grammatica risultante.The example also uses a Choices object to group an array of two GrammarBuilder objects into a pair of alternative phrases that the resultant grammar can recognize. Le frasi o le parole alternative sono un componente della maggior parte delle grammatiche e il Choices oggetto fornisce questa funzionalità per le grammatiche costruiti con GrammarBuilder.Alternate words or phrases are a component of most grammars, and the Choices object provides this functionality for grammars constructed with GrammarBuilder.

Nell'esempio viene infine creato un Grammar dell'oggetto da un GrammarBuilder costruito da un Choices oggetto.The example finally creates a Grammar object from a GrammarBuilder constructed from a Choices object.


private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices for the two alternative phrases, convert the Choices  
  // to a GrammarBuilder, and construct the Grammar object from the result.  
  GrammarBuilder bothPhrases = new GrammarBuilder();  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  bothPhrases.Append(bothChoices);  
  Grammar grammar = new Grammar(bothPhrases);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Commenti

Per aggiungere regole a un oggetto esistente GrammarBuilder dell'oggetto, usare il Add, Append, AppendDictation, AppendRuleReference, e AppendWildcard metodi e il Addition operatore.To add rules to an existing GrammarBuilder object, use the Add, Append, AppendDictation, AppendRuleReference, and AppendWildcard methods, and the Addition operator.

Importante

Il riconoscimento vocale può generare un'eccezione quando si usa una grammatica di riconoscimento vocale che contiene gli elementi semantici duplicati con lo stesso nome di chiave o più elementi semantici che è stato possibile modificare ripetutamente il valore dello stesso elemento semantico.The speech recognizer can throw an exception when using a speech recognition grammar that contains duplicate semantic elements with the same key name or multiple semantic elements that could repeatedly modify the value of the same semantic element.

Vedi anche

GrammarBuilder(Choices) GrammarBuilder(Choices) GrammarBuilder(Choices) GrammarBuilder(Choices)

Inizializza una nuova istanza della classe GrammarBuilder da un set di alternative.Initializes a new instance of the GrammarBuilder class from a set of alternatives.

public:
 GrammarBuilder(System::Speech::Recognition::Choices ^ alternateChoices);
public GrammarBuilder (System.Speech.Recognition.Choices alternateChoices);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.Choices -> System.Speech.Recognition.GrammarBuilder
Public Sub New (alternateChoices As Choices)

Parametri

alternateChoices
Choices Choices Choices Choices

Set di alternative.The set of alternatives.

Esempi

L'esempio seguente usa GrammarBuilder e Choices gli oggetti per costruire una grammatica che può riconoscere una delle due frasi, "sfondo colorChoice" o "impostato in background su colorChoice".The following example uses GrammarBuilder and Choices objects to construct a grammar that can recognize either of the two phrases, "Make background colorChoice" or "Set background to colorChoice".

L'esempio Usa un' Choices oggetto per creare un elenco di valori accettabili per colorChoice da una matrice di String oggetti.The example uses a Choices object to create a list of acceptable values for colorChoice from an array of String objects. Oggetto Choices è analogo all'oggetto di one-of elemento nella specifica di SRGS e contiene un set di frasi alternative, ognuna delle quali possono essere riconosciuti pronuncia.A Choices object is analogous to the one-of element in the SRGS specification, and contains a set of alternate phrases, any of which can be recognized when spoken. L'esempio Usa anche un Choices oggetto per raggruppare un array di due GrammarBuilder gli oggetti in una coppia di frasi alternative in grado di riconoscere la grammatica risultante.The example also uses a Choices object to group an array of two GrammarBuilder objects into a pair of alternative phrases that the resultant grammar can recognize. Le frasi o le parole alternative sono un componente della maggior parte delle grammatiche e il Choices oggetto fornisce questa funzionalità per le grammatiche costruiti con GrammarBuilder.Alternate words or phrases are a component of most grammars, and the Choices object provides this functionality for grammars constructed with GrammarBuilder.

Nell'esempio viene infine creato un Grammar dell'oggetto da un GrammarBuilder costruito da un Choices oggetto.The example finally creates a Grammar object from a GrammarBuilder constructed from a Choices object.


private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices for the two alternative phrases, convert the Choices  
  // to a GrammarBuilder, and construct the grammar from the result.  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Commenti

Per altre informazioni sulla creazione di una grammatica di riconoscimento vocale che contiene alternative, vedere usando le opzioni per creare una grammatica GrammarBuilder.For more information about building a speech recognition grammar that contains alternatives, see Using Choices to Create a GrammarBuilder Grammar.

Vedi anche

GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey)

Inizializza una nuova istanza della classe GrammarBuilder a partire da una chiave semantica.Initializes a new instance of the GrammarBuilder class from a semantic key.

public:
 GrammarBuilder(System::Speech::Recognition::SemanticResultKey ^ key);
public GrammarBuilder (System.Speech.Recognition.SemanticResultKey key);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultKey -> System.Speech.Recognition.GrammarBuilder
Public Sub New (key As SemanticResultKey)

Parametri

key
SemanticResultKey SemanticResultKey SemanticResultKey SemanticResultKey

La chiave semantica.The semantic key.

Esempi

L'esempio seguente crea una grammatica di riconoscimento vocale in grado di riconoscere le due frasi, "rendere lo sfondo colorChoice" e "impostata in background colorChoice", dove colorChoice viene selezionato da un set di colori.The following example creates a speech recognition grammar that can recognize the two phrases, "Make background colorChoice" and "Set background to colorChoice", where colorChoice is selected from a set of colors. La grammatica consente a un utente di pronunciare diversi nomi di colore e restituisce informazioni semantiche sul nome del colore riconosciuto per l'applicazione.The grammar lets a user speak any of several color names, and returns semantic information about the recognized color name to the application.

L'esempio Usa un unico SemanticResultKey con cui è possibile recuperare il SemanticValue che è associato con il colore parlato dall'utente.The example uses a single SemanticResultKey with which you can retrieve the SemanticValue that is associated with the color spoken by the user. Ad esempio, se l'input contiene la frase "Set di background su red", il risultato del riconoscimento contiene il valore semantico del "#ff0000", che è possibile recuperare usando un gestore per il SpeechRecognized evento.For example, if the input contains the phrase, "Set background to red", the recognition result contains the semantic value of "#FF0000", which you can retrieve using a handler for the SpeechRecognized event.

Nell'esempio viene usato String, Choices, SemanticResultKey, SemanticResultValue, e GrammarBuilder oggetti per compilare i vincoli che sono tutte contenuti nell'ultimo GrammarBuilder oggetto bothPhrases.The example uses String, Choices, SemanticResultKey, SemanticResultValue, and GrammarBuilder objects to build the constraints that are all contained in the last GrammarBuilder object, bothPhrases. Infine, nell'esempio si costruisce una Grammar oggetto dal completato GrammarBuilder.Finally, the example constructs a Grammar object from the completed GrammarBuilder.


private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  // Include semantic information about each of the colors.  
  Choices colorChoice = new Choices();  

  GrammarBuilder colorBuilder = new GrammarBuilder("red");  
  SemanticResultValue colorValue =  
    new SemanticResultValue(colorBuilder, "#FF0000");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  colorBuilder = new GrammarBuilder("green");  
  colorValue = new SemanticResultValue(colorBuilder, "#00FF00");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  colorBuilder = new GrammarBuilder("blue");  
  colorValue = new SemanticResultValue(colorBuilder, "#0000FF");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices object for the two alternative phrases.  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);  

  // Create the semantic key for referencing the color information.  
  SemanticResultKey colorKey =  
    new SemanticResultKey("ColorCode", bothPhrases);  
  bothPhrases = new GrammarBuilder(colorKey);  

  // Construct the Grammar object from the GrammarBuilder.  
  Grammar grammar = new Grammar(bothPhrases);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Commenti

Quando si crea una GrammarBuilder dell'istanza da un SemanticResultValue dell'oggetto, aggiungere informazioni semantiche per la grammatica che può essere restituita nel risultato del riconoscimento.When you create a GrammarBuilder instance from a SemanticResultValue object, you add semantic information to the grammar that can be returned in the recognition result. È possibile accedere alle informazioni semantiche nel risultato il riconoscimento utilizzando il Semantics proprietà di RecognizedPhrase, disponibile nel gestore per il SpeechRecognized evento.You can access the semantic information in the recognition result using the Semantics property of RecognizedPhrase, which is available in the handler for the SpeechRecognized event. Se il GrammarBuilder definisce un SemanticResultKey, può essere utilizzato per recuperare le informazioni semantiche in un risultato del riconoscimento che viene associato alla chiave.If the GrammarBuilder defines a SemanticResultKey, this can be used to retrieve the semantic information in a recognition result that is associated with the key. Vedere l'esempio relativo Append(SemanticResultKey)e vedere anche SemanticResultValue e SemanticResultKey.See the example for Append(SemanticResultKey), and also see SemanticResultValue and SemanticResultKey.

Importante

Quando si costruisce GrammarBuilder oggetti che contengono SemanticResultValue oppure SemanticResultKey istanze, verificare che si evita la creazione di duplicati semantici elementi con lo stesso nome di chiave o più elementi semantici che è stato possibile modificare ripetutamente il Value proprietà di un SemanticValue oggetto.When you construct GrammarBuilder objects that contain SemanticResultValue or SemanticResultKey instances, make sure you avoid creating duplicate semantic elements with the same key name or multiple semantic elements that could repeatedly modify the Value property of a SemanticValue object. Il riconoscimento vocale può generare un'eccezione se si verificano queste situazioni.The speech recognizer can throw an exception if it encounters these circumstances.

Vedi anche

GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue)

Inizializza una nuova istanza della classe GrammarBuilder a partire da un valore semantico.Initializes a new instance of the GrammarBuilder class from a semantic value.

public:
 GrammarBuilder(System::Speech::Recognition::SemanticResultValue ^ value);
public GrammarBuilder (System.Speech.Recognition.SemanticResultValue value);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultValue -> System.Speech.Recognition.GrammarBuilder
Public Sub New (value As SemanticResultValue)

Parametri

value
SemanticResultValue SemanticResultValue SemanticResultValue SemanticResultValue

Il valore semantico o la coppia nome/valore.The semantic value or name/value pair.

Esempi

L'esempio seguente crea una grammatica di riconoscimento vocale in grado di riconoscere le due frasi, "rendere lo sfondo colorChoice" e "impostata in background colorChoice", dove colorChoice viene selezionato da un set di colori.The following example creates a speech recognition grammar that can recognize the two phrases, "Make background colorChoice" and "Set background to colorChoice", where colorChoice is selected from a set of colors. La grammatica consente a un utente di pronunciare diversi nomi di colore e restituisce informazioni semantiche sul nome del colore riconosciuto per l'applicazione.The grammar lets a user speak any of several color names, and returns semantic information about the recognized color name to the application.

L'esempio Usa un unico SemanticResultKey con cui è possibile recuperare il SemanticValue che è associato con il colore parlato dall'utente.The example uses a single SemanticResultKey with which you can retrieve the SemanticValue that is associated with the color spoken by the user. Ad esempio, se l'input contiene la frase "Set di background su red", il risultato del riconoscimento contiene il valore semantico del "#ff0000", che è possibile recuperare usando un gestore per il SpeechRecognized evento.For example, if the input contains the phrase, "Set background to red", the recognition result contains the semantic value of "#FF0000", which you can retrieve using a handler for the SpeechRecognized event.

Nell'esempio viene usato String, Choices, SemanticResultKey, SemanticResultValue, e GrammarBuilder oggetti per compilare i vincoli che sono tutte contenuti nell'ultimo GrammarBuilder oggetto bothPhrases.The example uses String, Choices, SemanticResultKey, SemanticResultValue, and GrammarBuilder objects to build the constraints that are all contained in the last GrammarBuilder object, bothPhrases. Infine, nell'esempio si costruisce una Grammar oggetto dal completato GrammarBuilder.Finally, the example constructs a Grammar object from the completed GrammarBuilder.


private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  // Include semantic information about each of the colors.  
  Choices colorChoice = new Choices();  

  GrammarBuilder colorBuilder = new GrammarBuilder("red");  
  SemanticResultValue colorValue =  
    new SemanticResultValue(colorBuilder, "#FF0000");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  colorBuilder = new GrammarBuilder("green");  
  colorValue = new SemanticResultValue(colorBuilder, "#00FF00");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  colorBuilder = new GrammarBuilder("blue");  
  colorValue = new SemanticResultValue(colorBuilder, "#0000FF");  
  colorChoice.Add(new GrammarBuilder(colorValue));  

  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices for the two alternative phrases.  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);  

  // Create the semantic key for referencing the color information.  
  SemanticResultKey colorKey =  
    new SemanticResultKey("ColorCode", bothPhrases);  
  bothPhrases = new GrammarBuilder(colorKey);  

  // Construct the grammar from the grammar builder.  
  Grammar grammar = new Grammar(bothPhrases);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Commenti

Quando si crea una GrammarBuilder dell'istanza da un SemanticResultValue dell'oggetto, aggiungere informazioni semantiche per la grammatica che può essere restituita nel risultato del riconoscimento.When you create a GrammarBuilder instance from a SemanticResultValue object, you add semantic information to the grammar that can be returned in the recognition result. È possibile accedere alle informazioni semantiche nel risultato il riconoscimento utilizzando il Semantics proprietà di RecognizedPhrase, disponibile nel gestore per il SpeechRecognized evento.You can access the semantic information in the recognition result using the Semantics property of RecognizedPhrase, which is available in the handler for the SpeechRecognized event. Se il GrammarBuilder definisce un SemanticResultKey, può essere utilizzato per recuperare le informazioni semantiche in un risultato del riconoscimento che viene associato alla chiave.If the GrammarBuilder defines a SemanticResultKey, this can be used to retrieve the semantic information in a recognition result that is associated with the key. Vedere l'esempio relativo Append(SemanticResultKey)e vedere anche SemanticResultValue e SemanticResultKey.See the example for Append(SemanticResultKey), and also see SemanticResultValue and SemanticResultKey.

Importante

Quando si costruisce GrammarBuilder oggetti che contengono SemanticResultValue oppure SemanticResultKey istanze, verificare che si evita la creazione di duplicati semantici elementi con lo stesso nome di chiave o più elementi semantici che è stato possibile modificare ripetutamente il Value proprietà di un SemanticValue oggetto.When you construct GrammarBuilder objects that contain SemanticResultValue or SemanticResultKey instances, make sure you avoid creating duplicate semantic elements with the same key name or multiple semantic elements that could repeatedly modify the Value property of a SemanticValue object. Il riconoscimento vocale può generare un'eccezione se si verificano queste situazioni.The speech recognizer can throw an exception if it encounters these circumstances.

Vedi anche

GrammarBuilder(String) GrammarBuilder(String) GrammarBuilder(String) GrammarBuilder(String)

Inizializza una nuova istanza della classe GrammarBuilder da una sequenza di parole.Initializes a new instance of the GrammarBuilder class from a sequence of words.

public:
 GrammarBuilder(System::String ^ phrase);
public GrammarBuilder (string phrase);
new System.Speech.Recognition.GrammarBuilder : string -> System.Speech.Recognition.GrammarBuilder
Public Sub New (phrase As String)

Parametri

phrase
String String String String

La sequenza di parole.The sequence of words.

Esempi

L'esempio seguente usa GrammarBuilder e Choices gli oggetti per costruire una grammatica che può riconoscere una delle due frasi, "sfondo colorChoice" o "impostato in background su colorChoice".The following example uses GrammarBuilder and Choices objects to construct a grammar that can recognize either of the two phrases, "Make background colorChoice" or "Set background to colorChoice".

Dopo aver creato un elenco di valori accettabili per colorChoice usando un Choices dell'oggetto, nell'esempio viene inizializzato due GrammarBuilder oggetti makePhrase e setPhrase, usando una stringa come argomento.After creating a list of acceptable values for colorChoice using a Choices object, the example initializes two GrammarBuilder objects, makePhrase and setPhrase, using a string as an argument.

Nell'esempio viene infine creato un Grammar dell'oggetto da un Choices cast dell'oggetto a un GrammarBuilder oggetto.The example finally creates a Grammar object from a Choices object cast to a GrammarBuilder object.


private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices for the two alternative phrases, convert the Choices  
  // to a GrammarBuilder, and construct the Grammar object from the result.  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Commenti

La frase rappresenta una frase pronunciata esatta in grado di riconoscere la grammatica di riconoscimento vocale.The phrase represents an exact spoken phrase that the speech recognition grammar can recognize. Per altre informazioni sulla creazione di una grammatica di riconoscimento vocale che contiene le stringhe, vedere uso di stringhe per creare una grammatica GrammarBuilder.For more information about building a speech recognition grammar that contains strings, see Using Strings to Create a GrammarBuilder Grammar.

Vedi anche

GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode)

Inizializza una nuova istanza della classe GrammarBuilder per un subset di una sequenza di parole.Initializes a new instance of the GrammarBuilder class for a subset of a sequence of words.

public:
 GrammarBuilder(System::String ^ phrase, System::Speech::Recognition::SubsetMatchingMode subsetMatchingCriteria);
public GrammarBuilder (string phrase, System.Speech.Recognition.SubsetMatchingMode subsetMatchingCriteria);
new System.Speech.Recognition.GrammarBuilder : string * System.Speech.Recognition.SubsetMatchingMode -> System.Speech.Recognition.GrammarBuilder
Public Sub New (phrase As String, subsetMatchingCriteria As SubsetMatchingMode)

Parametri

phrase
String String String String

La sequenza di parole.The sequence of words.

subsetMatchingCriteria
SubsetMatchingMode SubsetMatchingMode SubsetMatchingMode SubsetMatchingMode

La modalità di corrispondenza che la grammatica di riconoscimento vocale utilizza per riconoscere la frase.The matching mode the speech recognition grammar uses to recognize the phrase.

Esempi

L'esempio seguente crea una grammatica di riconoscimento vocale per ogni SubsetMatchingMode valore e una grammatica per la scelta tra le grammatiche di modalità di corrispondenza.The following example creates a speech recognition grammar for each SubsetMatchingMode value and a grammar for choosing between the matching mode grammars. Se il valore di phrase è "uno due tre quattro cinque sei sette", quindi la grammatica sottosequenza riconosce l'input "due tre quattro", ma non l'input "uno tre cinque".If the value of phrase is "one two three four five six seven", then the Subsequence grammar recognizes the input "two three four", but not the input "one three five". La grammatica ordinati Subset riconosce tuttavia entrambi i dati di input.However, the Ordered Subset grammar recognizes both of these inputs.


private static IEnumerable<Grammar>  
  CreateMatchingModeGrammars(string phrase)  
{  
  List<Grammar> grammars = new List<Grammar>(5);  

  Choices modeChoice = new Choices();  
  Type enumType = typeof(SubsetMatchingMode);  
  foreach (SubsetMatchingMode mode in Enum.GetValues(enumType))  
  {  
    string modeName = Enum.GetName(enumType, mode);  
    modeName = BreakAtCaps(modeName);  

    GrammarBuilder builder = new GrammarBuilder(phrase, mode);  
    Grammar modeGrammar = new Grammar(builder);  
    modeGrammar.Name = modeName;  
    modeGrammar.Enabled = false;  
    grammars.Add(modeGrammar);  

    modeChoice.Add(modeName);  
  }  

  Grammar choiceGrammar = new Grammar(modeChoice);  
  choiceGrammar.Name = "choice";  
  grammars.Add(choiceGrammar);  

  return grammars;  
}  

// Insert spaces preceding each uppercase letter in a string.   
private static string BreakAtCaps(string item)  
{  
  if (item == null || item.Length == 0)  
  {  
    return item;  
  }  

  StringBuilder sb = new StringBuilder(item[0].ToString());  
  for (int i = 1; i < item.Length; i++)  
  {  
    char c = item[i];  
    if (char.IsUpper(c))  
    {  
      sb.Append(" ");  
    }  
    sb.Append(c);  
  }  

  return sb.ToString();  
}  

Commenti

Il phrase parametro rappresenta la posizione in cui è in grado di riconoscere la grammatica di riconoscimento vocale.The phrase parameter represents the phrase that the speech recognition grammar can recognize. Il subsetMatchingMode parametro specifica un subset della frase di cui può essere presentato per ottenere il riconoscimento ha esito positivo dell'intera frase.The subsetMatchingMode parameter specifies a subset of the phrase that can be spoken to achieve successful recognition of the entire phrase. È possibile utilizzare questo per creare una grammatica contenente un elenco di voci con nomi lunghi, senza richiedere agli utenti di pronunciare un intero nome venga trovata una corrispondenza.You can use this to create a grammar with a list of entries that have long names, without requiring users to speak an entire name to match an item.

Per altre informazioni sulle modalità di corrispondenza, vedere SubsetMatchingMode.For more information about the matching modes, see SubsetMatchingMode. Per altre informazioni sulla creazione di una grammatica di riconoscimento vocale che contiene le stringhe, vedere uso di stringhe per creare una grammatica GrammarBuilder.For more information about building a speech recognition grammar that contains strings, see Using Strings to Create a GrammarBuilder Grammar.

Vedi anche

GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32)

Inizializza una nuova istanza della classe GrammarBuilder da un elemento ripetuto.Initializes a new instance of the GrammarBuilder class from a repeated element.

public:
 GrammarBuilder(System::Speech::Recognition::GrammarBuilder ^ builder, int minRepeat, int maxRepeat);
public GrammarBuilder (System.Speech.Recognition.GrammarBuilder builder, int minRepeat, int maxRepeat);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.GrammarBuilder * int * int -> System.Speech.Recognition.GrammarBuilder
Public Sub New (builder As GrammarBuilder, minRepeat As Integer, maxRepeat As Integer)

Parametri

builder
GrammarBuilder GrammarBuilder GrammarBuilder GrammarBuilder

Elemento ripetuto.The repeated element.

minRepeat
Int32 Int32 Int32 Int32

Il numero minimo di volte in cui deve verificarsi un input che corrisponde all'elemento definito da builder per costituire una corrispondenza.The minimum number of times that input matching the element defined by builder must occur to constitute a match.

maxRepeat
Int32 Int32 Int32 Int32

Il numero massimo di volte in cui può verificarsi un input che corrisponde all'elemento definito da builder per costituire una corrispondenza.The maximum number of times that input matching the element defined by builder can occur to constitute a match.

Esempi

L'esempio seguente crea una grammatica di riconoscimento vocale per ordinare una pizza.The following example creates a speech recognition grammar for ordering a pizza. Inizia con una frase facoltativa, aprire, seguita da una a quattro condimenti e si chiude con la parola "pizza".It starts with an optional, opening phrase, followed by one to four toppings, and closes with the word "pizza".


private static Grammar CreatePizzaGrammar()  
{  

  // Create a Choices object from a string array of alternative toppings.  
  Choices toppings = new Choices(new string[] {  
    "cheese", "mushroom", "tomato", "onion",  
    "anchovy", "chicken", "pepperoni"});  

  // Create a GrammarBuilder and append the Choices object.  
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);  
  andToppings.Append(toppings);  

  // Construct the phrase.  
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);  
  gb.Append(toppings);  
  gb.Append(new GrammarBuilder(andToppings, 0, 3));  
  gb.Append("pizza");  

  // Create the Grammar from the GrammarBuilder.  
  Grammar grammar = new Grammar(gb);  
  grammar.Name = "Pizza Order";  

  return grammar;  
}  

Commenti

Se il valore di minRepeat è 0, il nuovo GrammarBuilder rappresenta un elemento facoltativo.If the value of minRepeat is 0, then the new GrammarBuilder represents an optional element.

Il valore di minRepeat deve essere maggiore o uguale a 0 e minore o uguale al valore di maxRepeat.The value of minRepeat must be greater than or equal to 0 and less than or equal to the value of maxRepeat.

Importante

Quando si specifica deve essere ripetuto per GrammarBuilder oggetti che contengono SemanticResultValue o SemanticResultKey istanze, verificare che si evita la creazione di duplicati semantici elementi con lo stesso nome di chiave o più elementi semantici che è stato possibile modificare ripetutamente il Value proprietà di un SemanticValue oggetto.When you specify repeats for GrammarBuilder objects that contain SemanticResultValue or SemanticResultKey instances, make sure you avoid creating duplicate semantic elements with the same key name or multiple semantic elements that could repeatedly modify the Value property of a SemanticValue object. Il riconoscimento vocale può generare un'eccezione se si verificano queste situazioni.The speech recognizer can throw an exception if it encounters these circumstances.

Vedi anche

GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32)

Inizializza una nuova istanza della classe GrammarBuilder dalla sequenza di parole in un oggetto String e specifica quante volte può essere ripetuto l'oggetto String.Initializes a new instance of the GrammarBuilder class from the sequence of words in a String and specifies how many times the String can be repeated.

public:
 GrammarBuilder(System::String ^ phrase, int minRepeat, int maxRepeat);
public GrammarBuilder (string phrase, int minRepeat, int maxRepeat);
new System.Speech.Recognition.GrammarBuilder : string * int * int -> System.Speech.Recognition.GrammarBuilder
Public Sub New (phrase As String, minRepeat As Integer, maxRepeat As Integer)

Parametri

phrase
String String String String

La sequenza ripetuta di parole.The repeated sequence of words.

minRepeat
Int32 Int32 Int32 Int32

Il numero minimo di volte in cui deve verificarsi l'input che corrisponde alla frase per costituire una corrispondenza.The minimum number of times that input matching the phrase must occur to constitute a match.

maxRepeat
Int32 Int32 Int32 Int32

Il numero massimo di volte in cui può verificarsi un input che corrisponde alla frase per costituire una corrispondenza.The maximum number of times that input matching the phrase can occur to constitute a match.

Esempi

L'esempio seguente crea una grammatica di riconoscimento vocale per ordinare una pizza.The following example creates a speech recognition grammar for ordering a pizza. Inizia con una frase facoltativa, aprire, seguita da una a quattro condimenti e si chiude con la parola "pizza".It starts with an optional, opening phrase, followed by one to four toppings, and closes with the word "pizza".


private static Grammar CreatePizzaGrammar()  
{  

  // Create a Choices object with alternatives for toppings.  
  Choices toppings = new Choices(new string[] {  
    "cheese", "mushroom", "tomato", "onion",  
    "anchovy", "chicken", "pepperoni"});  

  // Create a GrammarBuilder and append the Choices object.  
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);  
  andToppings.Append(toppings);  

  // Construct the phrase.  
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);  
  gb.Append(toppings);  
  gb.Append(new GrammarBuilder(andToppings, 0, 3));  
  gb.Append("pizza");  

  // Create the Grammar from the GrammarBuilder.  
  Grammar grammar = new Grammar(gb);  
  grammar.Name = "Pizza Order";  

  return grammar;  
}  

Commenti

Se il valore di minRepeat è 0, il nuovo GrammarBuilder rappresenta un elemento facoltativo.If the value of minRepeat is 0, then the new GrammarBuilder represents an optional element.

Il valore di minRepeat deve essere maggiore o uguale a 0 e minore o uguale al valore di maxRepeat.The value of minRepeat must be greater than or equal to 0 and less than or equal to the value of maxRepeat. Per altre informazioni sulla creazione di una grammatica di riconoscimento vocale che contiene le stringhe, vedere uso di stringhe per creare una grammatica GrammarBuilder.For more information about building a speech recognition grammar that contains strings, see Using Strings to Create a GrammarBuilder Grammar.

Vedi anche

Si applica a