SpeechRecognitionEngine.UnloadGrammar(Grammar) Metod

Definition

Namnområde:
System.Speech.Recognition
Sammansättning:
System.Speech.dll
Paket:
System.Speech v11.0.0-preview.4.26230.115
Källa:
SpeechRecognitionEngine.cs
Källa:
SpeechRecognitionEngine.cs
Källa:
SpeechRecognitionEngine.cs
Källa:
SpeechRecognitionEngine.cs

Tar bort ett angivet Grammar objekt från instansen SpeechRecognitionEngine .

public:
 void UnloadGrammar(System::Speech::Recognition::Grammar ^ grammar);
public void UnloadGrammar(System.Speech.Recognition.Grammar grammar);
member this.UnloadGrammar : System.Speech.Recognition.Grammar -> unit
Public Sub UnloadGrammar (grammar As Grammar)

Parametrar

grammar
Grammar

Grammatikobjektet som ska tas bort.

Undantag

ArgumentNullException

Grammar är null.

InvalidOperationException

Grammatiken läses inte in i den här identifieraren, eller så läser den här identifieraren in grammatiken asynkront.

Exempel

I följande exempel visas en del av ett konsolprogram som visar synkron inläsning och avlastning av taligenkännings grammatik.

Loading grammars...
Loaded grammars:
 - Grammar1
 - Grammar2
 - Grammar3

Unloading Grammar1...
Loaded grammars:
 - Grammar2
 - Grammar3

Unloading all grammars...
No grammars loaded.

Press any key to exit...

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Speech.Recognition;

namespace UnloadGrammars
{
  class Program
  {
    static void Main(string[] args)
    {
      using (SpeechRecognitionEngine recognizer =
        new SpeechRecognitionEngine(new CultureInfo("en-US")))
      {
        Console.WriteLine("Loading grammars...");

        // Create and load a number of grammars.
        Grammar grammar1 = new Grammar(new GrammarBuilder("first grammar"));
        grammar1.Name = "Grammar1";
        recognizer.LoadGrammar(grammar1);

        Grammar grammar2 = new Grammar(new GrammarBuilder("second grammar"));
        grammar2.Name = "Grammar2";
        recognizer.LoadGrammar(grammar2);

        Grammar grammar3 = new Grammar(new GrammarBuilder("third grammar"));
        grammar3.Name = "Grammar3";
        recognizer.LoadGrammar(grammar3);

        // List the recognizer's loaded grammars.
        ListGrammars(recognizer);

        // Unload one grammar and list the loaded grammars.
        Console.WriteLine("Unloading Grammar1...");
        recognizer.UnloadGrammar(grammar1);
        ListGrammars(recognizer);

        // Unload all grammars and list the loaded grammars.
        Console.WriteLine("Unloading all grammars...");
        recognizer.UnloadAllGrammars();
        ListGrammars(recognizer);
      }

      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }

    private static void ListGrammars(SpeechRecognitionEngine recognizer)
    {
      // Make a copy of the recognizer's grammar collection.
      List<Grammar> loadedGrammars = new List<Grammar>(recognizer.Grammars);

      if (loadedGrammars.Count > 0)
      {
        Console.WriteLine("Loaded grammars:");
        foreach (Grammar g in recognizer.Grammars)
        {
          Console.WriteLine(" - {0}", g.Name);
        }
      }
      else
      {
        Console.WriteLine("No grammars loaded.");
      }
      Console.WriteLine();
    }
  }
}

Kommentarer

Om identifieraren körs måste program använda RequestRecognizerUpdate för att pausa instansen innan de SpeechRecognitionEngine läser in, tar bort, aktiverar eller inaktiverar ett Grammar objekt. Om du vill ta bort alla Grammar objekt använder du UnloadAllGrammars metoden .

Gäller för

Se även