SrgsRule.Add(SrgsElement) Метод

Определение

Добавляет SrgsElement в объект SrgsRule.Adds an SrgsElement to an SrgsRule object.

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)

Параметры

element
SrgsElement

Объект, наследующий из SrgsElement и указывающий, что именно можно распознать.An object that inherits from SrgsElement and specifies what can be recognized.

Исключения

Свойство element имеет значение null.element is null.

Примеры

В следующем примере создается грамматика, которая распознает фразу «страна, заключенная в жизнь мира», за которой следует имя страны, которая выиграл чашкой мира.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 that has won the World Cup. После создания SrgsRule объекта winnerRule и присвоения ему идентификатора WorldCupWinnerстроки в примере используется Add метод для добавления к правилу строки «страна, в которой заключена «чашка мира».After creating the SrgsRule object winnerRule and giving it the string identifier WorldCupWinner, the example uses the Add method to append the string "A nation that has won the World Cup is" to the rule. Затем в примере создаются два дополнительных правила: ruleEurope и ruleSAmerica.The example then creates two additional rules, ruleEurope and ruleSAmerica. Опять же, Add используя метод, в примере к WorldCupWinner правилу, содержащему ссылки ruleEurope на правила, добавляются ruleSAmerica SrgsOneOf объекты и.Again using the Add method, the example appends an SrgsOneOf object to the WorldCupWinner rule that contains rule references to ruleEurope and 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;  

Комментарии

К типичным дополнениям к SrgsRule объекту SrgsOneOfотносятся SrgsRuleRef SrgsItemобъекты, SrgsToken , и, указывающие, какие колонки могут говорить.Typical additions to an SrgsRule object include SrgsItem, SrgsOneOf, SrgsRuleRef, and SrgsToken objects that specify what speakers can say. Допустимый элемент правила должен содержать по крайней мере один фрагмент распознаваемого текста или ссылку на правило.A valid rule element must contain at least one piece of recognizable text or one rule reference. Дополнительные сведения см. в статье Создание грамматики с помощью сргсграммар .See Create Grammars Using SrgsGrammar for more information.

Объект также может содержать SrgsNameValueTag объекты и SrgsSemanticInterpretationTag , которые добавляют семантические значения и семантические ключи к правилу. SrgsRuleAn SrgsRule object may also contain SrgsNameValueTag and SrgsSemanticInterpretationTag objects that add semantic values and semantic keys to the rule. Модуль распознавания речи будет возвращать семантическую информацию, а также распознанную фразу, когда она распознает фразу.The speech recognition engine will return the semantic information, as well as the recognized phrase, when it recognizes the phrase. Дополнительные сведения см. в разделе разметка семантической интерпретации.See Semantic Interpretation Markup for more information.

Применяется к

Дополнительно