Semantics Property
Collapse the table of content
Expand the table of content

RecognizedPhrase.Semantics Property

 

Gets the semantic information that is associated with the recognized phrase.

Namespace:   System.Speech.Recognition
Assembly:  System.Speech (in System.Speech.dll)

public SemanticValue Semantics { get; }

Property Value

Type: System.Speech.Recognition.SemanticValue

The semantic information associated with the recognized phrase.

A speech recognition grammar can include semantic information. When a speech recognizer generates a recognition result for such a grammar, the semantic information might be included in the recognition result, according to the rules of the grammar and the input to the recognizer. For more information about semantic information, see Understanding Semantic Results and the SemanticResultKey and SemanticResultValue classes.

The following example defines a method that gets specific semantic information from a recognized phrase. When this method returns, it contains the value for the semantic key, or null if the value was not retrieved. This method checks only for top-level keys. Since the semantic information is contained in a tree of values, lower-level keys must be accessed through the returned semantic value.

static bool TryGetSemanticValue(
      RecognizedPhrase phrase, string key, out SemanticValue value)
{
  value = null;
  bool found = phrase.Semantics.ContainsKey(key);
  if (found)
  {
    value = phrase.Semantics[key];
  }

  return found;
}

.NET Framework
Available since 3.0
Return to top
Show:
© 2016 Microsoft