Grammar Grammar Grammar Grammar Class

Definizione

Un oggetto runtime che fa riferimento a una grammatica di riconoscimento vocale, che un'applicazione può utilizzare per definire vincoli per il riconoscimento vocale.A runtime object that references a speech recognition grammar, which an application can use to define the constraints for speech recognition.

public ref class Grammar
public class Grammar
type Grammar = class
Public Class Grammar
Ereditarietà
GrammarGrammarGrammarGrammar
Derivato

Esempi

Nell'esempio seguente viene costruito un Grammar oggetto da una grammatica di riconoscimento vocale definita in un file XML (Cities. Xml).The following example constructs a Grammar object from a speech recognition grammar defined in a XML file (cities.xml). Il contenuto del file cities. XML viene visualizzato nell'esempio di codice XML seguente.The content of the cities.xml file appears in the following XML example.

// Load a cities grammar from a local file and return the grammar object.   
private static Grammar CreateGrammarFromFile()  
{  
  Grammar citiesGrammar = new Grammar(@"c:\temp\cities.xml");  
  citiesGrammar.Name = "SRGS File Cities Grammar";  
  return citiesGrammar;  
}  

<?xml version="1.0" encoding="UTF-8" ?>  
<grammar version="1.0" xml:lang="en-US"  
         xmlns="http://www.w3.org/2001/06/grammar"  
         tag-format="semantics/1.0" root="Main">  

  <!-- cities.xml:   
    Defines an SRGS grammar for requesting a flight. This grammar includes  
    a Cities rule that lists the cities that can be used for departures  
    and destinations. -->  

  <rule id="Main">  
    <item>  
      I would like to fly from <ruleref uri="#Cities"/>  
      to <ruleref uri="#Cities"/>  
    </item>  
  </rule>  

  <rule id="Cities" scope="public">  
    <one-of>  
      <item> Seattle </item>  
      <item> Los Angeles </item>  
      <item> New York </item>  
      <item> Miami </item>  
    </one-of>  
  </rule>  
</grammar>  

Commenti

Una grammatica di riconoscimento vocale è un set di regole o vincoli che definiscono ciò che un motore di riconoscimento vocale è in grado di riconoscere come input significativo.A speech recognition grammar is a set of rules or constraints that define what a speech recognition engine can recognize as meaningful input. Per altre informazioni sulla creazione e l'uso di grammatiche di riconoscimento vocale, vedere riconoscimento vocale, creare grammatiche con XML, creare grammatiche con GrammarBuildere creare grammatiche con SrgsGrammar.For more information about creating and using speech recognition grammars, see Speech Recognition, Create Grammars Using XML, Create Grammars Using GrammarBuilder, and Create Grammars Using SrgsGrammar.

Dopo aver creato una grammatica, è necessario compilarla in Grammar un oggetto che un motore di riconoscimento vocale possa caricare e che l'applicazione possa usare in fase di esecuzione per gestire il riconoscimento vocale.After you author a grammar, you must build it into a Grammar object that a speech recognition engine can load and that your application can use at runtime to manage speech recognition. È possibile utilizzare un Grammar costruttore per creare un' Grammar SrgsDocument istanza da un GrammarBuilder oggetto o oppure da un file o Stream da un oggetto che contiene una descrizione di una grammatica in un formato supportato.You can use a Grammar constructor to create a Grammar instance from a GrammarBuilder or a SrgsDocument object, or from a file or a Stream that contains a description of a grammar in a supported format. I formati supportati sono i seguenti:Supported formats include the following:

I costruttori di grammatica che accettano i file di grammatica in formato XML nei rispettivi argomenti compilano le grammatiche XML in un formato binario per ottimizzarle per il caricamento e l'utilizzo da parte di un motore di riconoscimento vocale.Grammar constructors that accept XML-format grammar files in their arguments compile the XML grammars to a binary format to optimize them for loading and consumption by a speech recognition engine. È possibile ridurre la quantità di tempo necessaria per costruire un Grammar oggetto da una grammatica in formato XML compilando la grammatica in anticipo, usando uno Compile dei metodi.You can reduce the amount of time required to construct a Grammar object from an XML-format grammar by compiling the grammar in advance, using one of the Compile methods.

Il motore di riconoscimento vocale di un'applicazione, gestito da SpeechRecognizer un SpeechRecognitionEngine oggetto o, può caricare più grammatiche di riconoscimento vocale.An application's speech recognition engine, as managed by a SpeechRecognizer or SpeechRecognitionEngine object, can load multiple speech recognition grammars. L'applicazione può abilitare o disabilitare le singole grammatiche in modo indipendente Enabled impostando la proprietà e modificare il comportamento di riconoscimento tramite Grammar proprietà, ad Weight esempio le Priority proprietà e.The application can independently enable or disable individual grammars by setting the Enabled property, and modify recognition behavior through Grammar properties, such as the Priority and Weight properties.

L' SpeechRecognized evento della grammatica viene generato quando l'input corrisponde a un percorso attraverso la grammatica.The grammar's SpeechRecognized event is raised when input matches a path through the grammar.

Nota

È consigliabile verificare la sicurezza di qualsiasi URI o dll usato per compilare un Grammar oggetto.It is a best practice to verify the safety of any URI or DLL used to build a Grammar object.

Windows e la piattaforma di riconoscimento vocale forniscono sicurezza per le applicazioni Grammar che creano un'istanza da una dll o da una grammatica che supporta lo scripting.Windows and the Speech platform provide security for applications constructing a Grammar instance from a DLL or from a grammar that supports scripting.

Gli script Grammar negli oggetti vengono sempre eseguiti come se scaricati da una pagina Internet ZoneWeb del.Scripts in Grammar objects are always run as if downloaded from a web page in the Internet Zone. Common Language Runtime (CLR) isola tutte le DLL caricate per ottenere una definizione di grammatica.The Common Language Runtime (CLR) isolates any DLL loaded to obtain a grammar definition.

Costruttori

Grammar() Grammar() Grammar() Grammar()

Inizializza una nuova istanza della classe Grammar.Initializes a new instance of the Grammar class

Grammar(GrammarBuilder) Grammar(GrammarBuilder) Grammar(GrammarBuilder) Grammar(GrammarBuilder)

Inizializza una nuova istanza della classe Grammar da un oggetto GrammarBuilder.Initializes a new instance of the Grammar class from a GrammarBuilder object.

Grammar(SrgsDocument) Grammar(SrgsDocument) Grammar(SrgsDocument) Grammar(SrgsDocument)

Inizializza una nuova istanza di una classe Grammar da un oggetto SrgsDocument.Initializes a new instance of a Grammar class from an SrgsDocument object.

Grammar(SrgsDocument, String) Grammar(SrgsDocument, String) Grammar(SrgsDocument, String) Grammar(SrgsDocument, String)

Inizializza una nuova istanza di una classe Grammar da un oggetto SrgsDocument e specifica una regola radice.Initializes a new instance of a Grammar class from an SrgsDocument object and specifies a root rule.

Grammar(SrgsDocument, String, Object[]) Grammar(SrgsDocument, String, Object[]) Grammar(SrgsDocument, String, Object[]) Grammar(SrgsDocument, String, Object[])

Inizializza una nuova istanza della classe Grammar da un'istanza dell'oggetto SrgsDocument e specifica il nome di una regola affinché sia il punto di ingresso della grammatica.Initializes a new instance of the Grammar class from an instance of SrgsDocument, and specifies the name of a rule to be the entry point to the grammar.

Grammar(SrgsDocument, String, Uri) Grammar(SrgsDocument, String, Uri) Grammar(SrgsDocument, String, Uri) Grammar(SrgsDocument, String, Uri)

Inizializza una nuova istanza di una classe Grammar da un oggetto SrgsDocument, specifica una regola radice e definisce un URI (Uniform Resource Identifier) di base per risolvere i relativi riferimenti della regola.Initializes a new instance of a Grammar class from an SrgsDocument object, specifies a root rule, and defines a base Uniform Resource Identifier (URI) to resolve relative rule references.

Grammar(SrgsDocument, String, Uri, Object[]) Grammar(SrgsDocument, String, Uri, Object[]) Grammar(SrgsDocument, String, Uri, Object[]) Grammar(SrgsDocument, String, Uri, Object[])

Inizializza una nuova istanza della classe Grammar da un'istanza dell'oggetto SrgsDocument e specifica il nome di una regola affinché sia il punto di ingresso della grammatica e un URI di base per risolvere i relativi riferimenti.Initializes a new instance of the Grammar class from an instance of SrgsDocument, and specifies the name of a rule to be the entry point to the grammar and a base URI to resolve relative references.

Grammar(Stream) Grammar(Stream) Grammar(Stream) Grammar(Stream)

Inizializza una nuova istanza della classe Grammar da un oggetto Stream.Initializes a new instance of the Grammar class from a Stream.

Grammar(Stream, String) Grammar(Stream, String) Grammar(Stream, String) Grammar(Stream, String)

Inizializza una nuova istanza della classe Grammar da Stream e specifica una regola radice.Initializes a new instance of the Grammar class from a Stream and specifies a root rule.

Grammar(Stream, String, Object[]) Grammar(Stream, String, Object[]) Grammar(Stream, String, Object[]) Grammar(Stream, String, Object[])

Inizializza una nuova istanza della classe Grammar da Stream e specifica una regola radice.Initializes a new instance of the Grammar class from a Stream and specifies a root rule.

Grammar(Stream, String, Uri) Grammar(Stream, String, Uri) Grammar(Stream, String, Uri) Grammar(Stream, String, Uri)

Inizializza una nuova istanza della classe Grammar da un flusso, specifica una regola radice e definisce un URI (Uniform Resource Identifier) di base per risolvere i relativi riferimenti della regola.Initializes a new instance of the Grammar class from a stream, specifies a root rule, and defines a base Uniform Resource Identifier (URI) to resolve relative rule references.

Grammar(Stream, String, Uri, Object[]) Grammar(Stream, String, Uri, Object[]) Grammar(Stream, String, Uri, Object[]) Grammar(Stream, String, Uri, Object[])

Inizializza una nuova istanza delle classi Grammar e Stream e specifica una regola radice e un URI di base per risolvere i riferimenti relativi.Initializes a new instance of the Grammar class a Stream and specifies a root rule and a base URI to resolve relative references.

Grammar(String) Grammar(String) Grammar(String) Grammar(String)

Inizializza una nuova istanza della classe Grammar da un file.Initializes a new instance of the Grammar class from a file.

Grammar(String, String) Grammar(String, String) Grammar(String, String) Grammar(String, String)

Inizializza una nuova istanza della classe Grammar da un file e specifica una regola radice.Initializes a new instance of the Grammar class from a file and specifies a root rule.

Grammar(String, String, Object[]) Grammar(String, String, Object[]) Grammar(String, String, Object[]) Grammar(String, String, Object[])

Inizializza una nuova istanza della classe Grammar da un file contenente una definizione di grammatica e specifica il nome di una regola che sarà il punto di ingresso della grammatica.Initializes a new instance of the Grammar class from a file that contains a grammar definition, and specifies the name of a rule to be the entry point to the grammar.

Proprietà

Enabled Enabled Enabled Enabled

Ottiene o imposta un valore che controlla se Grammar può essere utilizzato da un riconoscimento vocale per eseguire il riconoscimento.Gets or sets a value that controls whether a Grammar can be used by a speech recognizer to perform recognition.

IsStg IsStg IsStg IsStg

Ottiene un valore che indica se una grammatica è fortemente tipizzata.Gets whether a grammar is strongly typed.

Loaded Loaded Loaded Loaded

Ottiene un valore che indica se Grammar è stato caricato da un riconoscimento vocale.Gets whether a Grammar has been loaded by a speech recognizer.

Name Name Name Name

Ottiene o imposta il nome di un oggetto Grammar.Gets or sets the name of a Grammar object.

Priority Priority Priority Priority

Ottiene o imposta il valore di priorità di un oggetto Grammar.Gets or sets the priority value of a Grammar object.

ResourceName ResourceName ResourceName ResourceName

Ottiene o imposta un valore con il nome di una risorsa binaria utilizzata per caricare l'oggetto Grammar corrente.Gets or sets a value with the name of a binary resource that was used to load the current Grammar.

RuleName RuleName RuleName RuleName

Ottiene il nome del punto di ingresso o della regola radice di un oggetto Grammar.Gets the name of the root rule or entry point of a Grammar object.

Weight Weight Weight Weight

Ottiene o imposta il valore della larghezza di un oggetto Grammar.Gets or sets the weight value of a Grammar object.

Metodi

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)
LoadLocalizedGrammarFromType(Type, Object[]) LoadLocalizedGrammarFromType(Type, Object[]) LoadLocalizedGrammarFromType(Type, Object[]) LoadLocalizedGrammarFromType(Type, Object[])

Il metodo LoadLocalizedGrammarFromType restituisce un'istanza localizzata di un oggetto Grammar derivato da Type.The LoadLocalizedGrammarFromType method returns a localized instance of a Grammar object derived from Type.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
StgInit(Object[]) StgInit(Object[]) StgInit(Object[]) StgInit(Object[])

Il metodo StgInit inizializza una grammatica fortemente tipizzata.The StgInit method initializes a strongly-typed grammar.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Eventi

SpeechRecognized SpeechRecognized SpeechRecognized SpeechRecognized

Generato quando il riconoscimento vocale esegue il riconoscimento utilizzando l'oggetto Grammar.Raised when a speech recognizer performs recognition using the Grammar object.

Si applica a

Vedi anche