GrammarBuilder GrammarBuilder GrammarBuilder GrammarBuilder Class

Definizione

Fornisce un meccanismo per la compilazione a livello di codice di vincoli per una grammatica di riconoscimento vocale.Provides a mechanism for programmatically building the constraints for a speech recognition grammar.

public ref class GrammarBuilder
public class GrammarBuilder
type GrammarBuilder = class
Public Class GrammarBuilder
Ereditarietà
GrammarBuilderGrammarBuilderGrammarBuilderGrammarBuilder

Esempi

Nell'esempio seguente vengono GrammarBuilder utilizzati Choices gli oggetti e per costruire una grammatica in grado di riconoscere una delle due frasi "make background colorChoice" o "set background to 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".

Nell'esempio viene utilizzato Choices un oggetto per creare un elenco di valori accettabili per colorChoice da una String matrice di oggetti.The example uses a Choices object to create a list of acceptable values for colorChoice from an array of String objects. Un Choices oggetto è analogo one-of all'elemento nella specifica SRGS e contiene un set di frasi alternative, ciascuna delle quali può essere riconosciuta quando viene pronunciata.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. Nell'esempio viene inoltre utilizzato Choices un oggetto per raggruppare una matrice GrammarBuilder di due oggetti in una coppia di frasi alternative che la grammatica risultante può riconoscere.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. Parole o frasi alternative sono un componente della maggior parte delle grammatiche e Choices l'oggetto fornisce questa funzionalità per le grammatiche GrammarBuildercostruite con.Alternate words or phrases are a component of most grammars, and the Choices object provides this functionality for grammars constructed with GrammarBuilder.

Viene infine creato un Grammar oggetto da un GrammarBuilder oggetto 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

Le grammatiche di riconoscimento vocale vengono in genere create nel formato XML definito dalla specifica SRGS (Speech Recognition Grammar) versione 1,0.Speech recognition grammars are commonly authored in the XML format defined by the Speech Recognition Grammar Specification (SRGS) Version 1.0. Se si ha familiarità con SRGS, ma si vogliono generare le grammatiche a livello di codice, System.Speech.Recognition.SrgsGrammar è possibile usare lo spazio dei nomi, i cui membri corrispondono strettamente agli elementi e agli attributi definiti da SRGS.If you are familiar with SRGS but want to generate the grammars programmatically, you can use the System.Speech.Recognition.SrgsGrammar namespace, whose members correspond closely to the elements and attributes defined by SRGS. Se non si ha familiarità con SRGS o si vuole un approccio leggero e programmatico per la creazione di grammatiche con cui è possibile eseguire in modo efficiente molti scenari comuni; è possibile usare le GrammarBuilder classi Choices e.If you are unfamiliar with SRGS, or you want a lightweight, programmatic approach to authoring grammars with which you can efficiently accomplish many common scenarios; you can use the GrammarBuilder and Choices classes.

Usare GrammarBuilder gli oggetti per compilare una struttura ad albero gerarchica Choices composta da oggetti che contengono frasi alternative, sparpagliate con il preambolo e le frasi post-ambite in ogni nodo e con il seeding con valori semantici che riportano il significato al applicazione.Use GrammarBuilder objects to build a hierarchical tree composed of Choices objects that contain alternate phrases, interspersed with preamble and post-amble phrases at each node, and seeded with semantic values that convey meaning back to the application.

Per usare un GrammarBuilder oggetto per creare Grammar un oggetto, seguire questa procedura.To use a GrammarBuilder to create a Grammar object, use the following steps.

  1. Creare un oggetto GrammarBuilder.Create a GrammarBuilder object.

  2. GrammarBuilderAggiungere vincoli a, String ad esempio Choices SemanticResultKey GrammarBuilder oggetti, SemanticResultValue,,, e altri oggetti che definiscono i vincoli per la grammatica. DictationGrammarAppend constraints to the GrammarBuilder, such as String objects, Choices, SemanticResultKey, SemanticResultValue, DictationGrammar, and other GrammarBuilder objects that define the constraints for the grammar.

  3. Usare uno dei Grammar costruttori per creare un Grammar oggetto dalla grammatica completata GrammarBuilder .Use one of the Grammar constructors to create a Grammar object from the completed GrammarBuilder grammar.

La creazione di GrammarBuilder con è più adatta alle grammatiche con una singola regola contenente elenchi o elenchi di elenchi.Authoring with GrammarBuilder is best suited to grammars that have a single rule containing lists, or perhaps lists of lists. Per compilare a livello di codice grammatiche con più regole o che devono eseguire riferimenti a regole interne, usare le classi dello System.Speech.Recognition.SrgsGrammar spazio dei nomi.To programmatically build grammars that have multiple rules, or that need to make internal rule references, use the classes of the System.Speech.Recognition.SrgsGrammar namespace.

Le istanze GrammarBuilder di possono anche essere ottenute tramite conversioni implicite da determinate altre classi o combinando un GrammarBuilder oggetto con un secondo oggetto che contiene vincoli per una grammatica.Instances of GrammarBuilder can also be obtained by implicit conversions from certain other classes or by combining a GrammarBuilder with a second object that contains constraints for a grammar.. Per ulteriori informazioni, vedere gli Implicit operatori Addition e e i Add metodi.For more information, see the Implicit and Addition operators and the Add methods.

Per aggiungere regole a un oggetto GrammarBuilderesistente, usare Addi Appendmetodi AppendDictation, AppendRuleReference,, AppendWildcard e.To add rules to an existing GrammarBuilder, use the Add, Append, AppendDictation, AppendRuleReference, and AppendWildcard methods.

Importante

Il riconoscimento vocale può generare un'eccezione quando si usa una grammatica di riconoscimento vocale che contiene elementi semantici duplicati con lo stesso nome di chiave o più elementi semantici che potrebbero 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 semplificare il debug, la DebugShowPhrases proprietà restituisce lo stato corrente GrammarBuilder dell'oggetto sotto forma di stringa.To help with debugging, the DebugShowPhrases property returns the current status of the GrammarBuilder as a string.

Per ulteriori informazioni sulla compilazione e sull'utilizzo di grammatiche di riconoscimento vocale, vedere riconoscimento vocale e creazione di grammatiche GrammarBuilder.For more information about building and using speech recognition grammars, see Speech Recognition and Creating GrammarBuilder Grammars.

Costruttori

GrammarBuilder() 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(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(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, 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.

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.

Proprietà

Culture Culture Culture Culture

Ottiene o imposta le impostazioni cultura della grammatica di riconoscimento vocale.Gets or sets the culture of the speech recognition grammar.

DebugShowPhrases DebugShowPhrases DebugShowPhrases DebugShowPhrases

Ottiene una stringa che mostra il contenuto e la struttura della sintassi contenuta da GrammarBuilder.Gets a string that shows the contents and structure of the grammar contained by the GrammarBuilder.

Metodi

Add(Choices, GrammarBuilder) Add(Choices, GrammarBuilder) Add(Choices, GrammarBuilder) Add(Choices, GrammarBuilder)

Crea un nuovo GrammarBuilder che contiene un oggetto Choices seguito da un oggetto GrammarBuilder.Creates a new GrammarBuilder that contains a Choices object followed by a GrammarBuilder object.

Add(GrammarBuilder, Choices) Add(GrammarBuilder, Choices) Add(GrammarBuilder, Choices) Add(GrammarBuilder, Choices)

Crea un nuovo GrammarBuilder che contiene un oggetto GrammarBuilder seguito da un oggetto Choices.Creates a new GrammarBuilder that contains a GrammarBuilder object followed by a Choices object.

Add(GrammarBuilder, GrammarBuilder) Add(GrammarBuilder, GrammarBuilder) Add(GrammarBuilder, GrammarBuilder) Add(GrammarBuilder, GrammarBuilder)

Crea un nuovo oggetto GrammarBuilder contenente una sequenza di due oggetti GrammarBuilder.Creates a new GrammarBuilder that contains a sequence of two GrammarBuilder objects.

Add(GrammarBuilder, String) Add(GrammarBuilder, String) Add(GrammarBuilder, String) Add(GrammarBuilder, String)

Crea un nuovo oggetto GrammarBuilder contenente un oggetto GrammarBuilder seguito da una frase.Creates a new GrammarBuilder that contains a GrammarBuilder object followed by a phrase.

Add(String, GrammarBuilder) Add(String, GrammarBuilder) Add(String, GrammarBuilder) Add(String, GrammarBuilder)

Crea un nuovo oggetto GrammarBuilder contenente una frase seguita da un oggetto GrammarBuilder .Creates a new GrammarBuilder that contains a phrase followed by a GrammarBuilder object.

Append(Choices) Append(Choices) Append(Choices) Append(Choices)

Aggiunge un set di alternative alla sequenza corrente di elementi di grammatica.Appends a set of alternatives to the current sequence of grammar elements.

Append(GrammarBuilder) Append(GrammarBuilder) Append(GrammarBuilder) Append(GrammarBuilder)

Aggiunge un elemento di grammatica alla sequenza corrente di elementi di grammatica.Appends a grammar element to the current sequence of grammar elements.

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

Aggiunge un elemento di grammatica ripetuto alla sequenza corrente di elementi di grammatica.Appends a repeated grammar element to the current sequence of grammar elements.

Append(SemanticResultKey) Append(SemanticResultKey) Append(SemanticResultKey) Append(SemanticResultKey)

Aggiunge una chiave semantica alla sequenza corrente di elementi di grammatica.Appends a semantic key to the current sequence of grammar elements.

Append(SemanticResultValue) Append(SemanticResultValue) Append(SemanticResultValue) Append(SemanticResultValue)

Aggiunge un valore semantico alla sequenza corrente di elementi di grammatica.Appends a semantic value to the current sequence of grammar elements.

Append(String) Append(String) Append(String) Append(String)

Aggiunge una frase alla sequenza corrente di elementi di grammatica.Appends a phrase to the current sequence of grammar elements.

Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32)

Aggiunge una frase ripetuta alla sequenza corrente di elementi di grammatica.Appends a repeated phrase to the current sequence of grammar elements.

Append(String, SubsetMatchingMode) Append(String, SubsetMatchingMode) Append(String, SubsetMatchingMode) Append(String, SubsetMatchingMode)

Aggiunge un elemento per un subset di una frase alla sequenza corrente di elementi di grammatica.Appends an element for a subset of a phrase to the current sequence of grammar elements.

AppendDictation() AppendDictation() AppendDictation() AppendDictation()

Aggiunge la grammatica di dettatura predefinita alla sequenza corrente di elementi di grammatica.Appends the default dictation grammar to the current sequence of grammar elements.

AppendDictation(String) AppendDictation(String) AppendDictation(String) AppendDictation(String)

Aggiunge la grammatica di dettatura specificata alla sequenza corrente di elementi di grammatica.Appends the specified dictation grammar to the current sequence of grammar elements.

AppendRuleReference(String) AppendRuleReference(String) AppendRuleReference(String) AppendRuleReference(String)

Aggiunge un file di definizione della grammatica alla sequenza corrente di elementi di grammatica.Appends a grammar definition file to the current sequence of grammar elements.

AppendRuleReference(String, String) AppendRuleReference(String, String) AppendRuleReference(String, String) AppendRuleReference(String, String)

Aggiunge la regola specificata di un file di definizione della grammatica alla sequenza corrente di elementi di grammatica.Appends the specified rule of a grammar definition file to the current sequence of grammar elements.

AppendWildcard() AppendWildcard() AppendWildcard() AppendWildcard()

Aggiunge un elemento della grammatica di riconoscimento che corrisponde a qualsiasi input nella sequenza corrente di elementi di grammatica.Appends a recognition grammar element that matches any input to the current sequence of grammar elements.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Operatori

Addition(Choices, GrammarBuilder) Addition(Choices, GrammarBuilder) Addition(Choices, GrammarBuilder) Addition(Choices, GrammarBuilder)

Crea un nuovo GrammarBuilder che contiene un oggetto Choices seguito da un oggetto GrammarBuilder.Creates a new GrammarBuilder that contains a Choices object followed by a GrammarBuilder object.

Addition(GrammarBuilder, Choices) Addition(GrammarBuilder, Choices) Addition(GrammarBuilder, Choices) Addition(GrammarBuilder, Choices)

Crea un nuovo oggetto GrammarBuilder contenente un oggetto GrammarBuilder seguito da Choices.Creates a new GrammarBuilder that contains a GrammarBuilder followed by a Choices.

Addition(GrammarBuilder, GrammarBuilder) Addition(GrammarBuilder, GrammarBuilder) Addition(GrammarBuilder, GrammarBuilder) Addition(GrammarBuilder, GrammarBuilder)

Crea un nuovo oggetto GrammarBuilder contenente una sequenza di due oggetti GrammarBuilder.Creates a new GrammarBuilder that contains a sequence of two GrammarBuilder objects.

Addition(GrammarBuilder, String) Addition(GrammarBuilder, String) Addition(GrammarBuilder, String) Addition(GrammarBuilder, String)

Crea un nuovo oggetto GrammarBuilder contenente un oggetto GrammarBuilder seguito da una frase.Creates a new GrammarBuilder that contains a GrammarBuilder followed by a phrase.

Addition(String, GrammarBuilder) Addition(String, GrammarBuilder) Addition(String, GrammarBuilder) Addition(String, GrammarBuilder)

Crea un nuovo oggetto GrammarBuilder contenente una frase seguita da GrammarBuilder .Creates a new GrammarBuilder that contains a phrase followed by a GrammarBuilder.

Implicit(Choices to GrammarBuilder) Implicit(Choices to GrammarBuilder) Implicit(Choices to GrammarBuilder) Implicit(Choices to GrammarBuilder)

Converte un oggetto Choices in un oggetto GrammarBuilder.Converts a Choices object to a GrammarBuilder object.

Implicit(SemanticResultKey to GrammarBuilder) Implicit(SemanticResultKey to GrammarBuilder) Implicit(SemanticResultKey to GrammarBuilder) Implicit(SemanticResultKey to GrammarBuilder)

Converte un oggetto SemanticResultKey in un oggetto GrammarBuilder.Converts a SemanticResultKey object to a GrammarBuilder object.

Implicit(SemanticResultValue to GrammarBuilder) Implicit(SemanticResultValue to GrammarBuilder) Implicit(SemanticResultValue to GrammarBuilder) Implicit(SemanticResultValue to GrammarBuilder)

Converte un oggetto SemanticResultValue in un oggetto GrammarBuilder.Converts a SemanticResultValue object to a GrammarBuilder object.

Implicit(String to GrammarBuilder) Implicit(String to GrammarBuilder) Implicit(String to GrammarBuilder) Implicit(String to GrammarBuilder)

Converte una stringa in un oggetto GrammarBuilder.Converts a string to a GrammarBuilder object.

Si applica a

Vedi anche