GrammarBuilder.Append Method (String, SubsetMatchingMode)
Appends an instance of GrammarBuilder to the current GrammarBuilder.
Namespace: Microsoft.Speech.Recognition
Assembly: Microsoft.Speech (in microsoft.speech.dll)
Syntax
'Declaration
Public Sub Append ( _
phrase As String, _
subsetMatchingCriteria As SubsetMatchingMode _
)
public void Append (
string phrase,
SubsetMatchingMode subsetMatchingCriteria
)
public:
void Append (
String^ phrase,
SubsetMatchingMode subsetMatchingCriteria
)
public void Append (
String phrase,
SubsetMatchingMode subsetMatchingCriteria
)
public function Append (
phrase : String,
subsetMatchingCriteria : SubsetMatchingMode
)
Parameters
- phrase
A System.String containing a phrase to be used recognized.
- subsetMatchingCriteria
A member of SubsetMatchingMode defining the method used to match audio input which may be a subset of the match string
Remarks
The logic of each element appended to a GrammarBuilder is applied by recognition engines in the order in which it was appended.
The logic of each element appended to a GrammarBuilder is applied by recognition engines in the order in which it was appended.
For detailed information on the use of sub set matching modes, see Microsoft.Speech.Recognition.SubsetMatchingMode.
Example
Below is a test routine which generates four Grammar, one for each mode with the same string. These Grammar objects can then be tested.
private void CreateSubsetMatchTest() {
foreach ( Microsoft.Speech.Recognition.SubsetMatchingMode mode
in Enum.GetValues(typeof(Microsoft.Speech.Recognition.SubsetMatchingMode))){
GrammarBuilder gb = new GrammarBuilder();
gb.Append("a car the truck a boat that plane",mode);
Grammar grammar = new Grammar(gb);
grammar.Name = mode.ToString();
grammar.Enabled=true;
_recognizer.LoadGrammar(grammar);
}
}
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