GrammarBuilder.Append Method (SemanticResultKey)

Appends an instance of SemanticResultKey to the current GrammarBuilder.

Namespace: Microsoft.Speech.Recognition
Assembly: Microsoft.Speech (in microsoft.speech.dll)

Syntax

'Declaration
Public Sub Append ( _
    key As SemanticResultKey _
)

public void Append (
    SemanticResultKey key
)

public:
void Append (
    SemanticResultKey^ key
)

public void Append (
    SemanticResultKey key
)

public function Append (
    key : SemanticResultKey
)

Parameters

• key
  Valid instance of SemanticResultKey used to construct a new instance of GrammarBuilder to be appended to the current GrammarBuilder object.

Remarks

The logic of each element appended to a GrammarBuilder is applied by recognition engines in the order in which it was appended.

The semantics defined by the SemanticResultKey are appended GrammarBuilder with results that can be accessed on recognition as a SemanticValue instance obtained using the string key to index the Semantics property on the returned instance of RecognizedPhrase.

Care should be taken in appending to a GrammarBuilder object with a SemanticResultKey instance.

An exception will be generated during the use of a Grammar generated from a GrammarBuilder with an SemanticResultKey appended its grammar logic will result in more than one instance of SemanticResultKey with the same tag value and at the same level in the recognition semantic tree are created.

Thread Safety

All public static (Shared in Visual Basic) members of this type are thread-safe. Instance members are not guaranteed to be thread-safe.

Platforms

Development Platforms

Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Vista Ultimate Edition, Windows Vista Business Edition, Windows Vista Enterprise Edition

Target Platforms

See Also

Reference

GrammarBuilder Class
GrammarBuilder Members
Microsoft.Speech.Recognition Namespace