SrgsRule.Add(SrgsElement) Méthode

Définition

Espace de noms:

System.Speech.Recognition.SrgsGrammar

Assembly:

System.Speech.dll

Paquet:

System.Speech v11.0.0-preview.3.26207.106

Source:

SrgsRule.cs

Ajoute un SrgsElementSrgsRule objet.

public:
 void Add(System::Speech::Recognition::SrgsGrammar::SrgsElement ^ element);

public void Add(System.Speech.Recognition.SrgsGrammar.SrgsElement element);

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

Public Sub Add (element As SrgsElement)

Paramètres

element

SrgsElement

Objet qui hérite SrgsElement et spécifie ce qui peut être reconnu.

Exceptions

ArgumentNullException

element a la valeur null.

Exemples

L’exemple suivant crée une grammaire qui reconnaît l’expression « Une nation qui a gagné la Coupe du Monde » suivie du nom d’un pays qui a remporté la Coupe du Monde. Après avoir créé l’objet SrgsRulewinnerRule et lui donné l’identificateur WorldCupWinnerde chaîne, l’exemple utilise la Add méthode pour ajouter la chaîne « Une nation qui a gagné la Coupe du monde est » à la règle. L’exemple crée ensuite deux règles supplémentaires et ruleEuroperuleSAmerica. Là encore, à l’aide de la Add méthode, l’exemple ajoute un SrgsOneOf objet à la WorldCupWinner règle qui contient des références de règle à ruleEurope et ruleSAmerica.

// 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"), 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;

Remarques

Les ajouts classiques à un SrgsRule objet incluent SrgsItem, SrgsOneOf, SrgsRuleRefet SrgsToken les objets qui spécifient ce que les haut-parleurs peuvent dire. Un élément de règle valide doit contenir au moins une partie de texte reconnaissable ou une référence de règle.

Un SrgsRule objet peut également contenir et SrgsNameValueTag des SrgsSemanticInterpretationTag objets qui ajoutent des valeurs sémantiques et des clés sémantiques à la règle. Le moteur de reconnaissance vocale retourne les informations sémantiques, ainsi que l’expression reconnue, lorsqu’elle reconnaît l’expression.