GrammarBuilder.op_Addition Method (GrammarBuilder, GrammarBuilder)

Returns a new instance of GrammarBuilder constructed by appending the grammar logic of two GrammarBuilder instances.

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

Syntax

'Declaration
Public Shared Operator + ( _
    builder1 As GrammarBuilder, _
    builder2 As GrammarBuilder _
) As GrammarBuilder
public static GrammarBuilder operator + (
    GrammarBuilder builder1,
    GrammarBuilder builder2
)
public:
static GrammarBuilder^ operator + (
    GrammarBuilder^ builder1, 
    GrammarBuilder^ builder2
)


Parameters

  • builder1
    A valid instance of GrammarBuilder to contain the initial grammar logic of the new GrammarBuilder.
  • builder2
    A valid instance of GrammarBuilder containing grammar logic to be appended to the grammar logic of builder1.

Return Value

Returns an instance of GrammarBuilder if successful, null is returned or an exception generated if the operation fails.

Remarks

Because GrammarBuilder supports implicit conversions from SemanticResultValue and SemanticResultKey, these may be cast to use as builder1 or builder2.

Care should be taken if the GrammarBuilder instances specified by builder1 and builder2 have been constructed using any SemanticResultValue or SemanticResultKey instances.

An exception will be thrown during the use of a Grammar generated from a GrammarBuilder constructed with repeats of a defining GrammarBuilder if the repetition of the grammar logic of that GrammarBuilder include instances of SemanticResultValue that would require repeated modifications of the Value property of the one of the SemanticValue objects returned by a recognition operation.

Similarly, an exception will be generated during the use of a Grammar generated from a GrammarBuilder constructed with repeats of a defining Grammar if the repetition of the grammar logic of that Grammar 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