SrgsRule.Add(SrgsElement) Méthode

Définition

Espace de noms:

System.Speech.Recognition.SrgsGrammar

Assembly:

System.Speech.dll

Paquet:

System.Speech v9.0.0-preview.3.24172.9

Source:

SrgsRule.cs

Ajoute un élément SrgsElement à un objet SrgsRule.

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 de SrgsElement et spécifie ce qui peut être identifié.

Exceptions

ArgumentNullException

element a la valeur null.

Exemples

L’exemple suivant crée une grammaire qui reconnaît l’expression « Une nation qui a remporté la Coupe du monde est » suivie du nom d’un pays qui a remporté la Coupe du monde. Après avoir créé l’objet SrgsRulewinnerRule et lui avoir donné l’identificateur WorldCupWinnerde chaîne , l’exemple utilise la Add méthode pour ajouter la chaîne « Une nation qui a remporté la Coupe du monde est » à la règle. L’exemple crée ensuite deux règles supplémentaires, ruleEurope et ruleSAmerica. À 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 des SrgsItemobjets , SrgsOneOf, SrgsRuleRefet SrgsToken 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. Pour plus d’informations, consultez Créer des grammaires à l’aide de SrgsGrammar .

Un SrgsRule objet peut également contenir des SrgsNameValueTag objets et SrgsSemanticInterpretationTag 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’il reconnaît l’expression. Pour plus d’informations, consultez Balisage d’interprétation sémantique .

Voir aussi

• Créer des grammaires à l’aide de SrgsGrammar
• Balisage d’interprétation sémantique