LoadGrammarCompletedEventArgs Sınıf

Tanım

Ad Alanı:

System.Speech.Recognition

Bütünleştirilmiş Kod:

System.Speech.dll

Paket:

System.Speech v9.0.0-preview.3.24172.9

Kaynak:

LoadGrammarCompletedEventArgs.cs

Bir SpeechRecognizer veya SpeechRecognitionEngine nesnesinin LoadGrammarCompleted olayı için veri sağlar.

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

public class LoadGrammarCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs

type LoadGrammarCompletedEventArgs = class
    inherit AsyncCompletedEventArgs

Public Class LoadGrammarCompletedEventArgs
Inherits AsyncCompletedEventArgs

Devralma

Object

EventArgs

AsyncCompletedEventArgs

LoadGrammarCompletedEventArgs

Örnekler

Aşağıdaki örnek, paylaşılan bir konuşma tanıyıcısı oluşturur ve ardından belirli sözcükleri tanımak ve ücretsiz dikteyi kabul etmek için iki tür dil bilgisi oluşturur. Örnek, oluşturulan tüm dil bilgisini zaman uyumsuz olarak tanıyıcıya yükler. Tanıyıcının LoadGrammarCompleted ve SpeechRecognized olaylarının işleyicileri tanımanın sonuçlarını ve tanımayı gerçekleştirmek için hangi dil bilgisinin kullanıldığını bildirir.

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");  
      }  
    }  
  }  
}  

Açıklamalar

nesnesi veya nesnesi olayını yükselttiğinde SpeechRecognitionEngineSpeechRecognitionEngine.LoadGrammarCompletedSpeechRecognizerLoadGrammarCompleted bir örneği LoadGrammarCompletedEventArgs oluşturulur. Yöntemlere LoadGrammarAsync yapılan çağrılar tamamlandığında olaylar tetiklenir.

Yüklenen nesne hakkında Grammar bilgi edinmek için olay işleyicisindeki özelliğine erişin Grammar .

Tanıyıcı işlem sırasında bir özel durumla karşılaşırsa, Error özelliği özel duruma ayarlanır ve Loaded ilişkili Grammar özelliği olabilir false.

Özellikler

Cancelled	Zaman uyumsuz işlemin iptal edilip edilmediğini belirten bir değer alır. (Devralındığı yer: AsyncCompletedEventArgs)
Error	Zaman uyumsuz bir işlem sırasında hangi hatanın oluştuğunu belirten bir değer alır. (Devralındığı yer: AsyncCompletedEventArgs)
Grammar	Yüklemeyi Grammar tamamlayan nesne.
UserState	Zaman uyumsuz görevin benzersiz tanımlayıcısını alır. (Devralındığı yer: AsyncCompletedEventArgs)

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
RaiseExceptionIfNecessary()	Zaman uyumsuz bir işlem başarısız olursa kullanıcı tarafından sağlanan bir özel durum oluşturur. (Devralındığı yer: AsyncCompletedEventArgs)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

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