SrgsOneOf.Add(SrgsItem) Method

Reference

Definition

Namespace:: System.Speech.Recognition.SrgsGrammar

Assembly:: System.Speech.dll

Package:: System.Speech v8.0.0

Package:: System.Speech v9.0.0-rc.2.24473.5

Source:: SrgsOneOf.cs

Source:: SrgsOneOf.cs

Source:: SrgsOneOf.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Adds an SrgsItem containing a word or a phrase to the list of alternatives.

public:
 void Add(System::Speech::Recognition::SrgsGrammar::SrgsItem ^ item);

public void Add (System.Speech.Recognition.SrgsGrammar.SrgsItem item);

member this.Add : System.Speech.Recognition.SrgsGrammar.SrgsItem -> unit

Public Sub Add (item As SrgsItem)

Parameters

item: SrgsItem

The item to add to the list of alternatives.

Exceptions

ArgumentNullException

item is null.

Examples

The following example creates a grammar that recognizes the phrase "A nation that has won the World Cup is" followed by the name of a country/region that has won the World Cup. The example uses the SrgsOneOf object to build lists of acceptable country/region names from an array of SrgsItem objects. Using the Add method, the example appends an SrgsItem that contains the string "Italy" to the SrgsOneOf object oneOfEurope.

public void WorldSoccerWinners ()
{

  // Create an SrgsDocument, create a new rule
  // and set its scope to public.
  SrgsDocument document = new SrgsDocument();
  SrgsRule winnerRule = new SrgsRule("WorldCupWinner");
  winnerRule.Scope = SrgsRuleScope.Public;

  // Add the introduction.
  winnerRule.Elements.Add(new SrgsItem("A nation that has won the world cup is: "));

  // Create the rule for the European nations.
  SrgsOneOf oneOfEurope = new SrgsOneOf(new SrgsItem[] {new SrgsItem("England"),
    new SrgsItem("France"), new SrgsItem("Germany")});
  oneOfEurope.Add(new SrgsItem("Italy"));
  SrgsRule ruleEurope = (new SrgsRule("EuropeanNations", new SrgsElement[] {oneOfEurope}));

  // Create the rule for the South American nations.
  SrgsOneOf oneOfSAmerica = new SrgsOneOf(new SrgsItem[] {new SrgsItem("Argentina"),
    new SrgsItem("Brazil"), new SrgsItem("Uruguay")});
  SrgsRule ruleSAmerica = (new SrgsRule("SouthAmericanNations", new SrgsElement[] {oneOfSAmerica}));

  // Add references to winnerRule for ruleEurope and ruleSAmerica.
  winnerRule.Elements.Add(new SrgsOneOf(new SrgsItem[] {(new SrgsItem
    (new SrgsRuleRef(ruleEurope))), new SrgsItem(new SrgsRuleRef(ruleSAmerica))}));

  // Add all the rules to the document and make winnerRule
  // the root rule of the document.
  document.Rules.Add(new SrgsRule[] {winnerRule, ruleEurope, ruleSAmerica});
  document.Root = winnerRule;
}

Applies to

Partager via