Share via


Note

Please see Azure Cognitive Services for Speech documentation for the latest supported speech solutions.

Grammar.RuleName Property

Gets the identifier of the root rule or entry point rule of a Grammar instance.

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

Syntax

'Declaration
Public ReadOnly Property RuleName As String
    Get
'Usage
Dim instance As Grammar
Dim value As String

value = instance.RuleName
public string RuleName { get; }

Property Value

Type: System.String
The identifier of the root rule or entry point rule of a Grammar instance.

Remarks

To construct a Grammar object and set the name for its root rule, use one of the Grammar constructors that takes the ruleName parameter.

If the root rule of a Grammar has no name, the method returns a null reference (Nothing in Visual Basic).

The root rules of Grammar instances constructed from GrammarBuilder objects typically have no name, so RuleName returns a null reference (Nothing in Visual Basic).

Examples

The following example writes information about a Grammar object to the console.

private static void DumpGrammarStatus(Grammar item)
{
  Console.WriteLine("Grammar name is {0}:", item.Name);
  Console.WriteLine("  The Grammar {0} loaded.",
    item.Loaded ? "is" : "is not");
  Console.WriteLine("  The Grammar {0} enabled.",
    item.Enabled ? "is" : "is not");
  if (item.RuleName != null)
  {
    Console.WriteLine("  The root rule is {0}.", item.RuleName);
  }
  else
  {
    Console.WriteLine("  The Grammar does not specify a root rule.");
  }
}

See Also

Reference

Grammar Class

Grammar Members

Microsoft.Speech.Recognition Namespace