LoadGrammarCompletedEventArgs Klasse

Definition

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paket:

System.Speech v9.0.0-preview.3.24172.9

Quelle:

LoadGrammarCompletedEventArgs.cs

Stellt Daten für das LoadGrammarCompleted Ereignis eines SpeechRecognizer- oder eines SpeechRecognitionEngine-Objekts bereit.

public ref class LoadGrammarCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs

public class LoadGrammarCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs

type LoadGrammarCompletedEventArgs = class
    inherit AsyncCompletedEventArgs

Public Class LoadGrammarCompletedEventArgs
Inherits AsyncCompletedEventArgs

Vererbung

Object

EventArgs

AsyncCompletedEventArgs

LoadGrammarCompletedEventArgs

Beispiele

Im folgenden Beispiel wird eine freigegebene Spracherkennung erstellt und dann zwei Grammatiktypen zum Erkennen bestimmter Wörter und zum Akzeptieren des freien Diktats erstellt. Im Beispiel werden alle erstellten Grammatiken asynchron in die Erkennung geladen. Handler für die Erkennung LoadGrammarCompleted und SpeechRecognized Ereignisse melden die Ergebnisse der Erkennung und welche Grammatik zum Ausführen der Erkennung verwendet wurde.

using System;  
using System.Speech.Recognition;  

namespace SampleRecognition  
{  
  class Program  
  {  
    private static SpeechRecognizer recognizer;  
    public static void Main(string[] args)  
    {  

      // Initialize a shared speech recognition engine.  
      recognizer = new SpeechRecognizer();  

        // Add a handler for the LoadGrammarCompleted event.  
        recognizer.LoadGrammarCompleted +=  
          new EventHandler<LoadGrammarCompletedEventArgs>(recognizer_LoadGrammarCompleted);  

        // Add a handler for the SpeechRecognized event.  
        recognizer.SpeechRecognized +=  
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);  

        // Add a handler for the StateChanged event.  
        recognizer.StateChanged +=  
          new EventHandler<StateChangedEventArgs>(recognizer_StateChanged);  

        // Create the "yesno" grammar and build it into a Grammar object.  
        Choices yesChoices = new Choices(new string[] { "yes", "yup", "yah}" });  
        SemanticResultValue yesValue =  
            new SemanticResultValue(yesChoices, (bool)true);  
        Choices noChoices = new Choices(new string[] { "no", "nope", "nah" });  
        SemanticResultValue noValue =  
            new SemanticResultValue(noChoices, (bool)false);  
        SemanticResultKey yesNoKey =  
            new SemanticResultKey("yesno", new Choices(new GrammarBuilder[] { yesValue, noValue }));  
        Grammar yesnoGrammar = new Grammar(yesNoKey);  
        yesnoGrammar.Name = "yesNo";  

        // Create the "done" grammar within the constructor of a Grammar object.  
        Grammar doneGrammar =  
        new Grammar(new GrammarBuilder(new Choices(new string[] { "done", "exit", "quit", "stop" })));  
        doneGrammar.Name = "Done";  

        // Create a dictation grammar.  
        Grammar dictation = new DictationGrammar();  
        dictation.Name = "Dictation";  

        // Load grammars to the recognizer.  
        recognizer.LoadGrammarAsync(yesnoGrammar);  
        recognizer.LoadGrammarAsync(doneGrammar);  
        recognizer.LoadGrammarAsync(dictation);  

        // Keep the console window open.  
        Console.ReadLine();  
      }  

    // Handle the SpeechRecognized event.  
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)  
    {  
      Console.WriteLine("Grammar({0}): {1}", e.Result.Grammar.Name, e.Result.Text);  

      // Add event handler code here.  
    }  

    // Handle the LoadGrammarCompleted event.   
    static void recognizer_LoadGrammarCompleted(object sender, LoadGrammarCompletedEventArgs e)  
    {  
      string grammarName = e.Grammar.Name;  
      bool grammarLoaded = e.Grammar.Loaded;  

      if (e.Error != null)  
      {  

        Console.WriteLine("LoadGrammar for {0} failed with a {1}.",  
        grammarName, e.Error.GetType().Name);  

        // Add exception handling code here.  
      }  

      Console.WriteLine("Grammar {0} {1} loaded.",  
      grammarName, (grammarLoaded) ? "is" : "is not");  
    }  

    // Put the shared speech recognizer into "listening" mode.   
    static void recognizer_StateChanged(object sender, StateChangedEventArgs e)  
    {  
      if (e.RecognizerState != RecognizerState.Stopped)  
      {  
        recognizer.EmulateRecognizeAsync("Start listening");  
      }  
    }  
  }  
}  

Hinweise

Eine instance von LoadGrammarCompletedEventArgs wird erstellt, wenn das SpeechRecognitionEngine -Objekt seinSpeechRecognitionEngine.LoadGrammarCompleted- oder -SpeechRecognizerEreignis auslöstLoadGrammarCompleted. Die Ereignisse werden ausgelöst, wenn die Aufrufe der LoadGrammarAsync Methoden abgeschlossen sind.

Um Informationen zum geladenen Grammar Objekt abzurufen, greifen Sie auf die Grammar Eigenschaft im Handler für das Ereignis zu.

Wenn die Erkennung während des Vorgangs auf eine Ausnahme stößt, wird die Error -Eigenschaft auf die Ausnahme festgelegt, und die Loaded -Eigenschaft des zugeordneten Grammar kann sein false.

Eigenschaften

Cancelled	Ruft einen Wert ab, der angibt, ob ein asynchroner Vorgang abgebrochen wurde. (Geerbt von AsyncCompletedEventArgs)
Error	Ruft einen Wert ab, der angibt, welcher Fehler während eines asynchronen Vorgangs aufgetreten ist. (Geerbt von AsyncCompletedEventArgs)
Grammar	Das Grammar-Objekt, das das Laden beendet hat.
UserState	Ruft den eindeutigen Bezeichner der asynchronen Aufgabe ab. (Geerbt von AsyncCompletedEventArgs)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
RaiseExceptionIfNecessary()	Löst eine benutzerdefinierte Ausnahme aus, wenn bei einem asynchronen Vorgang ein Fehler aufgetreten ist. (Geerbt von AsyncCompletedEventArgs)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• LoadGrammar(Grammar)
• LoadGrammarAsync(Grammar)
• LoadGrammar(Grammar)
• LoadGrammarAsync(Grammar)