Grammar Klasse

Definition

Ein Laufzeitobjekt, das auf eine Spracherkennungsgrammatik verweist, die eine Anwendung verwenden kann, um die Einschränkungen für Spracherkennung zu definieren.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
Vererbung
Grammar
Abgeleitet

Beispiele

Im folgenden Beispiel wird ein Grammar-Objekt aus einer sprach Erkennungs Grammatik erstellt, die in einer XML-Datei (Cities. Xml) definiert ist.The following example constructs a Grammar object from a speech recognition grammar defined in a XML file (cities.xml). Der Inhalt der Datei "Cities. xml" wird im folgenden XML-Beispiel angezeigt.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>  

Hinweise

Eine sprach Erkennungs Grammatik ist ein Satz von Regeln oder Einschränkungen, mit denen definiert wird, was eine Spracherkennungs-Engine als sinnvolle Eingaben erkennen kann.A speech recognition grammar is a set of rules or constraints that define what a speech recognition engine can recognize as meaningful input. Weitere Informationen zum Erstellen und Verwenden von sprach Erkennungs Grammatiken finden Sie unter Spracherkennung, Erstellen von Grammatiken mithilfe von XML, Erstellen von Grammatiken mithilfe von grammatimarbuilderund Erstellen von Grammatiken mithilfe von 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.

Nachdem Sie eine Grammatik erstellt haben, müssen Sie Sie in einem Grammar-Objekt erstellen, das von einer sprach Erkennungs-Engine geladen werden kann und die die Anwendung zur Laufzeit zur Verwaltung der Spracherkennung verwenden kann.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. Sie können einen Grammar-Konstruktor verwenden, um eine Grammar-Instanz aus einem GrammarBuilder-oder einem SrgsDocument-Objekt oder aus einer Datei oder einer Stream zu erstellen, die eine Beschreibung einer Grammatik in einem unterstützten Format enthält.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. Folgende Formate werden unterstützt:Supported formats include the following:

Grammatik Konstruktoren, die Grammatik Dateien im XML-Format in ihren Argumenten akzeptieren, kompilieren die XML-Grammatiken in ein binäres Format, um Sie für das Laden und die Verwendung durch eine Spracherkennungs-Engine zu optimieren.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. Sie können den Zeitaufwand für das Erstellen eines Grammar-Objekts aus einer Grammatik im XML-Format verringern, indem Sie die Grammatik im Vorfeld mithilfe einer der Compile-Methoden kompilieren.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.

Die sprach Erkennungs-Engine einer Anwendung, die von einem SpeechRecognizer-oder SpeechRecognitionEngine-Objekt verwaltet wird, kann mehrere sprach Erkennungs Grammatiken laden.An application's speech recognition engine, as managed by a SpeechRecognizer or SpeechRecognitionEngine object, can load multiple speech recognition grammars. Die Anwendung kann einzelne Grammatiken unabhängig aktivieren bzw. deaktivieren, indem Sie die Enabled-Eigenschaft festlegt und das Erkennungs Verhalten durch Grammar-Eigenschaften, wie z. b. die Priority-und Weight-Eigenschaften, ändern.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.

Das SpeechRecognized-Ereignis der Grammatik wird ausgelöst, wenn die Eingabe mit einem Pfad über die Grammatik übereinstimmt.The grammar's SpeechRecognized event is raised when input matches a path through the grammar.

Hinweis

Es ist eine bewährte Vorgehensweise, die Sicherheit von URI oder dll zu überprüfen, die zum Erstellen eines Grammar-Objekts verwendet werden.It is a best practice to verify the safety of any URI or DLL used to build a Grammar object.

Windows und die Sprachplattform bieten Sicherheit für Anwendungen, die eine Grammar-Instanz aus einer DLL oder einer Grammatik erstellen, die Skripterstellung unterstützt.Windows and the Speech platform provide security for applications constructing a Grammar instance from a DLL or from a grammar that supports scripting.

Skripts in Grammar-Objekten werden immer so ausgeführt, als ob Sie von einer Webseite in der Internet Zone heruntergeladen werden.Scripts in Grammar objects are always run as if downloaded from a web page in the Internet Zone. Die Common Language Runtime (CLR) isoliert alle geladenen DLL-Elemente, um eine Grammatik Definition zu erhalten.The Common Language Runtime (CLR) isolates any DLL loaded to obtain a grammar definition.

Konstruktoren

Grammar()

Initialisiert eine neue Instanz der Grammar-Klasse.Initializes a new instance of the Grammar class.

Grammar(GrammarBuilder)

Initialisiert eine neue Instanz der Grammar-Klasse mit einem GrammarBuilder-Objekt.Initializes a new instance of the Grammar class from a GrammarBuilder object.

Grammar(SrgsDocument)

Initialisiert eine neue Instanz einer Grammar-Klasse aus einem SrgsDocument-Objekt.Initializes a new instance of a Grammar class from an SrgsDocument object.

Grammar(SrgsDocument, String)

Initialisiert eine neue Instanz einer Grammar-Klasse von einem SrgsDocument-Objekt und gibt eine Stammregel an.Initializes a new instance of a Grammar class from an SrgsDocument object and specifies a root rule.

Grammar(SrgsDocument, String, Object[])

Initialisiert eine neue Instanz der Grammar-Klasse von einer Instanz von SrgsDocument und gibt den Namen einer Regel an, die der Einstiegspunkt der Grammatik sein soll.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)

Initialisiert eine neue Instanz einer Grammar-Klasse von einem SrgsDocument-Objekt, gibt eine Stammregel an und definiert einen grundlegenden Uniform Resource Identifier (URI), um relative Regelverweise aufzulösen.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[])

Initialisiert eine neue Instanz der Grammar-Klasse von einer Instanz von SrgsDocument und gibt den Namen einer Regel an, die der Einstiegspunkt der Grammatik sein soll, und einen Basis-URI, um relative Verweise aufzulösen.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)

Initialisiert eine neue Instanz der Grammar-Klasse mit einer Stream.Initializes a new instance of the Grammar class from a Stream.

Grammar(Stream, String)

Initialisiert eine neue Instanz der Grammar-Klasse aus Stream und gibt eine Stammregel an.Initializes a new instance of the Grammar class from a Stream and specifies a root rule.

Grammar(Stream, String, Object[])

Initialisiert eine neue Instanz der Grammar-Klasse aus Stream und gibt eine Stammregel an.Initializes a new instance of the Grammar class from a Stream and specifies a root rule.

Grammar(Stream, String, Uri)

Initialisiert eine neue Instanz der Grammar-Klasse von einem Stream, gibt eine Stammregel an und definiert einen grundlegenden Uniform Resource Identifier (URI), um relative Regelverweise aufzulösen.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[])

Initialisiert eine neue Instanz der Grammar-Klasse eines Stream und gibt eine Stammregel und einen Basis-URI an, um relative Verweise aufzulösen.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)

Initialisiert eine neue Instanz der Grammar-Klasse aus einer Datei.Initializes a new instance of the Grammar class from a file.

Grammar(String, String)

Initialisiert eine neue Instanz der Grammar-Klasse aus einer Datei und gibt eine Stammregel an.Initializes a new instance of the Grammar class from a file and specifies a root rule.

Grammar(String, String, Object[])

Initialisiert eine neue Instanz der Grammar-Klasse aus einer Datei, die eine Grammatikdefinition enthält, und gibt den Namen einer Regel an, die der Einstiegspunkt der Grammatik sein soll.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.

Eigenschaften

Enabled

Ruft einen Wert ab oder legt diesen fest, welcher steuert, ob eine Grammar von einem Spracherkennungsmodul verwendet werden kann, um eine Erkennung durchzuführen.Gets or sets a value that controls whether a Grammar can be used by a speech recognizer to perform recognition.

IsStg

Ruft ab, ob eine Grammatik stark typisiert ist.Gets whether a grammar is strongly typed.

Loaded

Ruft ab, ob Grammar von einer Spracherkennung geladen wurde.Gets whether a Grammar has been loaded by a speech recognizer.

Name

Ruft den Namen eines Grammar-Objekts ab oder legt ihn fest.Gets or sets the name of a Grammar object.

Priority

Ruft den Wert der Priorität eines Grammar-Objekts ab oder legt diesen fest.Gets or sets the priority value of a Grammar object.

ResourceName

Ruft einen Wert ab oder legt diesen fest mit einer binären Ressource, welche für das Laden der aktuellen Grammar verwendet wurde.Gets or sets a value with the name of a binary resource that was used to load the current Grammar.

RuleName

Ruft den Namen der Stammregel oder des Einstiegpunkts eines Grammar-Objekts ab.Gets the name of the root rule or entry point of a Grammar object.

Weight

Ruft den Wert der Stärke eines Grammar-Objekts ab oder legt diesen fest.Gets or sets the weight value of a Grammar object.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
LoadLocalizedGrammarFromType(Type, Object[])

Die LoadLocalizedGrammarFromType-Methode gibt eine lokalisierte Instanz eines Grammar-Objekts zurück, das von Type abgeleitet ist.The LoadLocalizedGrammarFromType method returns a localized instance of a Grammar object derived from Type.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
StgInit(Object[])

Die StgInit-Methode initialisiert eine stark typisierte Grammatik.The StgInit method initializes a strongly-typed grammar.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Ereignisse

SpeechRecognized

Wird ausgelöst, wenn eine Spracherkennung die Erkennung mithilfe des Grammar-Objekts ausführt.Raised when a speech recognizer performs recognition using the Grammar object.

Gilt für:

Siehe auch