GrammarBuilder.Append Methode

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

public:
 void Append(System::String ^ phrase, int minRepeat, int maxRepeat);

public void Append (string phrase, int minRepeat, int maxRepeat);

member this.Append : string * int * int -> unit

Public Sub Append (phrase As String, minRepeat As Integer, maxRepeat As Integer)

Parameter

Beispiele

Im folgenden Beispiel wird eine Spracherkennungsgrammatik für Ausdrücke wie "Call James at work" und "Call Anne on her cell phone" erstellt, wobei das Wort "phone" optional ist. GrammarBuilder und Choices -Objekte werden verwendet, um die Grammatik zu erstellen. Im Beispiel wird die Verwendung der Append -Methode hervorgehoben.

public static Grammar CreatePhonePhrase()
{
  // Create alternatives for person names, locations, devices, and pronouns.
  Choices personChoice = new Choices(new string[] {"Anne", "James", "Mary", "Sam"});
  Choices locationChoice = new Choices(new string[] {"home", "work"});
  Choices deviceChoice = new Choices(new string[] {"home", "work", "cell"});
  Choices pronounChoice = new Choices(new string[] {"his", "her"});

  // Create a phrase for the receiving device, which optionally contains the word "phone".
  GrammarBuilder devicePhrase = new GrammarBuilder(pronounChoice);
  devicePhrase.Append(deviceChoice);
  devicePhrase.Append("phone", 0, 1);

  // Create alternatives for phrases specifying a device or a location.
  GrammarBuilder atLocation = new GrammarBuilder("at");
  atLocation.Append(locationChoice);

  GrammarBuilder onDevice = new GrammarBuilder("on");
  onDevice.Append(devicePhrase);

  Choices howChoice = new Choices(new GrammarBuilder[] {atLocation, onDevice});

  // Build the final phrase.
  GrammarBuilder callWho = new GrammarBuilder("Call");
  callWho.Append(personChoice);
  callWho.Append(howChoice);

  // Create the Grammar object.
  Grammar callGrammar = new Grammar(callWho);
  callGrammar.Name = "Call Grammar";

  return callGrammar;
}

Hinweise

Der Wert von minRepeat muss größer oder gleich 0 und kleiner oder gleich dem Wert von maxRepeatsein.

Weitere Informationen

• AppendDictation()
• AppendRuleReference(String)
• AppendWildcard()

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

public:
 void Append(System::Speech::Recognition::GrammarBuilder ^ builder, int minRepeat, int maxRepeat);

public void Append (System.Speech.Recognition.GrammarBuilder builder, int minRepeat, int maxRepeat);

member this.Append : System.Speech.Recognition.GrammarBuilder * int * int -> unit

Public Sub Append (builder As GrammarBuilder, minRepeat As Integer, maxRepeat As Integer)

Parameter

Beispiele

Im folgenden Beispiel wird eine Spracherkennungsgrammatik für Ausdrücke wie "Call James at work" und "Call Anne on her cell phone" erstellt, wobei das Wort "phone" optional ist. GrammarBuilder und Choices -Objekte werden verwendet, um die Grammatik zu erstellen. Im Beispiel wird die Verwendung der Append -Methode hervorgehoben.

public static Grammar CreatePhonePhrase()
{
  // Create alternatives for person names, locations, devices, and pronouns.
  Choices personChoice = new Choices(new string[] {"Anne", "James", "Mary", "Sam"});
  Choices locationChoice = new Choices(new string[] {"home", "work"});
  Choices deviceChoice = new Choices(new string[] {"home", "work", "cell"});
  Choices pronounChoice = new Choices(new string[] {"his", "her"});

  // Create a phrase for the receiving device, which optionally contains the word "phone".
  GrammarBuilder devicePhrase = new GrammarBuilder(pronounChoice);
  devicePhrase.Append(deviceChoice);
  devicePhrase.Append("phone", 0, 1);

  // Create alternatives for phrases specifying a device or a location.
  GrammarBuilder atLocation = new GrammarBuilder("at");
  atLocation.Append(locationChoice);

  GrammarBuilder onDevice = new GrammarBuilder("on");
  onDevice.Append(devicePhrase);

  Choices howChoice = new Choices(new GrammarBuilder[] {atLocation, onDevice});

  // Build the final phrase.
  GrammarBuilder callWho = new GrammarBuilder("Call");
  callWho.Append(personChoice);
  callWho.Append(howChoice);

  // Create the Grammar object.
  Grammar callGrammar = new Grammar(callWho);
  callGrammar.Name = "Call Grammar";

  return callGrammar;
}

Hinweise

Der Wert von minRepeat muss größer oder gleich 0 und kleiner oder gleich dem Wert von maxRepeatsein.

Weitere Informationen

• AppendDictation()
• AppendRuleReference(String)
• AppendWildcard()

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

public:
 void Append(System::String ^ phrase);

public void Append (string phrase);

member this.Append : string -> unit

Public Sub Append (phrase As String)

Parameter

Hinweise

phrase wird am Ende der aktuellen Sequenz von Elementen hinzugefügt.

Weitere Informationen

• AppendDictation()
• AppendRuleReference(String)
• AppendWildcard()

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

public:
 void Append(System::String ^ phrase, System::Speech::Recognition::SubsetMatchingMode subsetMatchingCriteria);

public void Append (string phrase, System.Speech.Recognition.SubsetMatchingMode subsetMatchingCriteria);

member this.Append : string * System.Speech.Recognition.SubsetMatchingMode -> unit

Public Sub Append (phrase As String, subsetMatchingCriteria As SubsetMatchingMode)

Parameter

Beispiele

Im folgenden Beispiel wird für jeden SubsetMatchingMode Wert eine Spracherkennungsgrammatik erstellt. Beispielsweise erkennt die generierte Grammatik OrderedSubset die Ausdrücke "three four five" und "one three five", und die Grammatik Subsequence erkennt den Ausdruck "three four five", aber nicht den Ausdruck "one three five".

private Grammar[] CreateSubsetMatchTest()
{
  List<Grammar> grammars = new List<Grammar>(4);

  string phrase = "one two three four five six";
  foreach (SubsetMatchingMode mode in
    Enum.GetValues(typeof(SubsetMatchingMode)))
  {
    GrammarBuilder gb = new GrammarBuilder();
    gb.Append(phrase, mode);

    Grammar grammar = new Grammar(gb);
    grammar.Name = mode.ToString();
    grammars.Add(grammar);
  }

  return grammars.ToArray();
}

Hinweise

Das Teilmengenelement wird am Ende der aktuellen Sequenz von Elementen hinzugefügt. Weitere Informationen zum Erstellen einer Spracherkennungsgrammatik mithilfe von Zeichenfolgen finden Sie unter Verwenden von Zeichenfolgen zum Erstellen einer GrammarBuilder-Grammatik.

Ausführliche Informationen zur Verwendung von Teilmengenübereinstimmungsmodi finden Sie unter System.Speech.Recognition.SubsetMatchingMode.

Weitere Informationen

• AppendDictation()
• AppendRuleReference(String)
• AppendWildcard()

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

public:
 void Append(System::Speech::Recognition::SemanticResultKey ^ key);

public void Append (System.Speech.Recognition.SemanticResultKey key);

member this.Append : System.Speech.Recognition.SemanticResultKey -> unit

Public Sub Append (key As SemanticResultKey)

Parameter

Beispiele

Das folgende Beispiel ist Teil einer Konsolenanwendung zum Auswählen von Ursprungs- und Zielstädten für einen Flug. Die Anwendung erkennt Ausdrücke wie "Ich möchte von Miami nach Chicago fliegen". Der Handler für das SpeechRecognized -Ereignis verwendet den SemanticResultKey flughafenspezifischen Code, der in der SemanticResultValue für die Ursprungs- und Zielstädte angegeben ist.

using System;
using System.Speech.Recognition;

namespace SampleRecognition
{
  class Program
  {
    static void Main(string[] args)

    // Initialize an in-process speech recognition engine.
    {
      using (SpeechRecognitionEngine recognizer =
         new SpeechRecognitionEngine())
      {

        // Create a Choices object and add  cities and airport codes
        // using SemanticResultValue objects.
        Choices cities = new Choices();
        cities.Add(new SemanticResultValue("Chicago", "ORD"));
        cities.Add(new SemanticResultValue("Boston", "BOS"));
        cities.Add(new SemanticResultValue("Miami", "MIA"));
        cities.Add(new SemanticResultValue("Dallas", "DFW"));

        // Build the phrase and add SemanticResultKeys.
        GrammarBuilder chooseCities = new GrammarBuilder();
        chooseCities.Append("I want to fly from");
        chooseCities.Append(new SemanticResultKey("origin", cities));
        chooseCities.Append("to");
        chooseCities.Append(new SemanticResultKey("destination", cities));

        // Build a Grammar object from the GrammarBuilder.
        Grammar bookFlight = new Grammar(chooseCities);
        bookFlight.Name = "Book Flight";

        // 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);

        // Configure the input to the recognizer.
        recognizer.SetInputToDefaultAudioDevice();

        // Load the grammar object and start recognition.
        recognizer.LoadGrammarAsync(bookFlight);
        recognizer.RecognizeAsync();

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

    // Handle the LoadGrammarCompleted event.
    static void recognizer_LoadGrammarCompleted(object sender, LoadGrammarCompletedEventArgs e)
    {
      Console.WriteLine("Grammar loaded: " + e.Grammar.Name);
      Console.WriteLine();
    }

    // Handle the SpeechRecognized event.
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)
    {
      Console.WriteLine("Speech recognized:  " + e.Result.Text);
      Console.WriteLine();
      Console.WriteLine("Semantic results:");
      Console.WriteLine("  The flight origin is " + e.Result.Semantics["origin"].Value);
      Console.WriteLine("  The flight destination is " + e.Result.Semantics["destination"].Value);
    }
  }
}

Hinweise

key wird am Ende der aktuellen Sequenz von Elementen hinzugefügt.

Weitere Informationen

• AppendDictation()
• AppendRuleReference(String)
• AppendWildcard()

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

public:
 void Append(System::Speech::Recognition::SemanticResultValue ^ value);

public void Append (System.Speech.Recognition.SemanticResultValue value);

member this.Append : System.Speech.Recognition.SemanticResultValue -> unit

Public Sub Append (value As SemanticResultValue)

Parameter

Beispiele

Das folgende Beispiel ist Teil einer Konsolenanwendung zum Auswählen von Ursprungs- und Zielstädten für einen Flug. Die Anwendung erkennt Ausdrücke wie "Ich möchte von Miami nach Chicago fliegen". Der Handler für das SpeechRecognized -Ereignis verwendet den SemanticResultKey flughafenspezifischen Code, der in der SemanticResultValue für die Ursprungs- und Zielstädte angegeben ist.

using System;
using System.Speech.Recognition;

namespace SampleRecognition
{
  class Program
  {
    static void Main(string[] args)

    // Initialize an in-process speech recognition engine.
    {
      using (SpeechRecognitionEngine recognizer =
         new SpeechRecognitionEngine())
      {

        // Create GrammarBuilder objects and append SemanticResultValue objects
        // that contain cities and airport codes.

        GrammarBuilder chicago = new GrammarBuilder();
        chicago.Append(new SemanticResultValue("Chicago", "ORD"));

        GrammarBuilder boston = new GrammarBuilder();
        boston.Append(new SemanticResultValue("Boston", "BOS"));

        GrammarBuilder miami = new GrammarBuilder();
        miami.Append(new SemanticResultValue("Miami", "MIA"));

        GrammarBuilder dallas = new GrammarBuilder();
        dallas.Append(new SemanticResultValue("Dallas", "DFW"));

        // Create a Choices object and add the cities using implicit conversion from
        // SemanticResultValue to GrammarBuilder.
        Choices cities = new Choices();
        cities.Add(new Choices(new GrammarBuilder[] { chicago, boston, miami, dallas }));

        // Build the phrase and add SemanticResultKeys.
        GrammarBuilder chooseCities = new GrammarBuilder();
        chooseCities.Append("I want to fly from");
        chooseCities.Append(new SemanticResultKey("origin", cities));
        chooseCities.Append("to");
        chooseCities.Append(new SemanticResultKey("destination", cities));

        // Build a Grammar object from the GrammarBuilder.
        Grammar bookFlight = new Grammar(chooseCities);
        bookFlight.Name = "Book Flight";

        // 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);

        // Configure the input to the recognizer.
        recognizer.SetInputToDefaultAudioDevice();

        // Load the grammar object and start recognition.
        recognizer.LoadGrammarAsync(bookFlight);
        recognizer.RecognizeAsync();

        // Keep the console window open.
        Console.ReadLine();
      }
    }
    // Handle the LoadGrammarCompleted event.
    static void recognizer_LoadGrammarCompleted(object sender, LoadGrammarCompletedEventArgs e)
    {
      Console.WriteLine("Grammar loaded: " + e.Grammar.Name);
      Console.WriteLine();
    }

    // Handle the SpeechRecognized event.
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)
    {
      Console.WriteLine("Speech recognized:  " + e.Result.Text);
      Console.WriteLine();
      Console.WriteLine("Semantic results:");
      Console.WriteLine("  The flight origin is " + e.Result.Semantics["origin"].Value);
      Console.WriteLine("  The flight destination is " + e.Result.Semantics["destination"].Value);
    }
  }
}

Hinweise

value wird am Ende der aktuellen Sequenz von Elementen hinzugefügt.

Weitere Informationen

• AppendDictation()
• AppendRuleReference(String)
• AppendWildcard()

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

public:
 void Append(System::Speech::Recognition::GrammarBuilder ^ builder);

public void Append (System.Speech.Recognition.GrammarBuilder builder);

member this.Append : System.Speech.Recognition.GrammarBuilder -> unit

Public Sub Append (builder As GrammarBuilder)

Parameter

Beispiele

Im folgenden Beispiel wird eine Spracherkennungsgrammatik für Ausdrücke wie "Call James at work" und "Call Anne on her cell phone" erstellt, wobei das Wort "phone" optional ist. GrammarBuilder und Choices -Objekte werden verwendet, um die Grammatik zu erstellen. Im Beispiel wird die Verwendung der Append -Methode hervorgehoben.

public static Grammar CreatePhonePhrase()
{
  // Create alternatives for person names, locations, devices, and pronouns.
  Choices personChoice = new Choices(new string[] {"Anne", "James", "Mary", "Sam"});
  Choices locationChoice = new Choices(new string[] {"home", "work"});
  Choices deviceChoice = new Choices(new string[] {"home", "work", "cell"});
  Choices pronounChoice = new Choices(new string[] {"his", "her"});

  // Create a phrase for the receiving device, which optionally contains the word "phone".
  GrammarBuilder devicePhrase = new GrammarBuilder(pronounChoice);
  devicePhrase.Append(deviceChoice);
  devicePhrase.Append("phone", 0, 1);

  // Create alternatives for phrases specifying a device or a location.
  GrammarBuilder atLocation = new GrammarBuilder("at");
  atLocation.Append(locationChoice);

  GrammarBuilder onDevice = new GrammarBuilder("on");
  onDevice.Append(devicePhrase);

  Choices howChoice = new Choices(new GrammarBuilder[] {atLocation, onDevice});

  // Build the final phrase.
  GrammarBuilder callWho = new GrammarBuilder("Call");
  callWho.Append(personChoice);
  callWho.Append(howChoice);

  // Create the Grammar object.
  Grammar callGrammar = new Grammar(callWho);
  callGrammar.Name = "Call Grammar";

  return callGrammar;
}

Hinweise

builder wird am Ende der aktuellen Sequenz von Grammatikelementen hinzugefügt.

Weitere Informationen

• AppendDictation()
• AppendRuleReference(String)
• AppendWildcard()

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

Quelle:

GrammarBuilder.cs

public:
 void Append(System::Speech::Recognition::Choices ^ alternateChoices);

public void Append (System.Speech.Recognition.Choices alternateChoices);

member this.Append : System.Speech.Recognition.Choices -> unit

Public Sub Append (alternateChoices As Choices)

Parameter

Beispiele

Im folgenden Beispiel wird eine Spracherkennungsgrammatik für Ausdrücke wie "Call James at work" und "Call Anne on her cell phone" erstellt, wobei das Wort "phone" optional ist. Im Beispiel wird die Verwendung der Append -Methode hervorgehoben.

public static Grammar CreatePhonePhrase()
{
  // Create alternatives for person names, locations, devices, and pronouns.
  Choices personChoice = new Choices(new string[] {"Anne", "James", "Mary", "Sam"});
  Choices locationChoice = new Choices(new string[] {"home", "work"});
  Choices deviceChoice = new Choices(new string[] {"home", "work", "cell"});
  Choices pronounChoice = new Choices(new string[] {"his", "her"});

  // Create a phrase for the receiving device, which optionally contains the word "phone".
  GrammarBuilder devicePhrase = new GrammarBuilder(pronounChoice);
  devicePhrase.Append(deviceChoice);
  devicePhrase.Append("phone", 0, 1);

  // Create alternatives for phrases specifying a device or a location.
  GrammarBuilder atLocation = new GrammarBuilder("at");
  atLocation.Append(locationChoice);

  GrammarBuilder onDevice = new GrammarBuilder("on");
  onDevice.Append(devicePhrase);

  Choices howChoice = new Choices(new GrammarBuilder[] {atLocation, onDevice});

  // Build the final phrase.
  GrammarBuilder callWho = new GrammarBuilder("Call");
  callWho.Append(personChoice);
  callWho.Append(howChoice);

  // Create the Grammar object.
  Grammar callGrammar = new Grammar(callWho);
  callGrammar.Name = "Call Grammar";

  return callGrammar;
}

Hinweise

alternateChoices wird am Ende der aktuellen Sequenz von Elementen hinzugefügt.