SrgsRule.Scope Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece si una regla se puede activar para el reconocimiento y cuando se puede hacer referencia a la regla por parte de otras reglas.
public:
property System::Speech::Recognition::SrgsGrammar::SrgsRuleScope Scope { System::Speech::Recognition::SrgsGrammar::SrgsRuleScope get(); void set(System::Speech::Recognition::SrgsGrammar::SrgsRuleScope value); };public System.Speech.Recognition.SrgsGrammar.SrgsRuleScope Scope { get; set; }member this.Scope : System.Speech.Recognition.SrgsGrammar.SrgsRuleScope with get, setPublic Property Scope As SrgsRuleScopeValor de propiedad
Un valor que establece el ámbito para la regla.
Ejemplos
En el ejemplo siguiente se crea una gramática que reconoce la frase "Una nación que ha ganado la Copa Mundial" seguida del nombre de un país que ha ganado la Copa Mundial. Crea una regla pública denominada WorldCupWinner y establece el ámbito de esa regla en Public.
// 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;
La gramática creada tiene el siguiente formato.
<grammar version="1.0" xml:lang="en-US" xmlns="http://www.w3.org/2001/06/grammar" root="WorldCupWinner">
<rule id="WorldCupWinner" scope="public">
<item> A nation that has won the world cup is </item>
<one-of>
<item>
<ruleref uri="#EuropeanNations" />
</item>
<item>
<ruleref uri="#SouthAmericanNations" />
</item>
</one-of>
</rule>
<rule id="EuropeanNations">
<one-of>
<item> England< /item>
<item> France </item>
<item> Germany </item>
<item> Italy </item>
</one-of>
</rule>
<rule id="SouthAmericanNations">
<one-of>
<item> Argentina </item>
<item> Brazil </item>
<item> Uruguay </item>
</one-of>
</rule>
</grammar>
Comentarios
El valor predeterminado para el ámbito es Private. Una regla privada solo se puede activar para el reconocimiento mediante una referencia de regla de la regla raíz en su gramática contenedora o de otra regla a la que se hace referencia desde la regla raíz. Una gramática externa no puede hacer referencia a una regla privada, a menos que la regla privada se declare como regla raíz de su gramática contenedora.
Si su ámbito se establece Publicen , un SrgsRule objeto se puede activar para el reconocimiento mediante una referencia de un SrgsRuleRef objeto de la gramática contenedora o de una regla en una gramática externa.
