SrgsRuleRef 构造函数

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

public:
 SrgsRuleRef(System::Speech::Recognition::SrgsGrammar::SrgsRule ^ rule);

public SrgsRuleRef (System.Speech.Recognition.SrgsGrammar.SrgsRule rule);

new System.Speech.Recognition.SrgsGrammar.SrgsRuleRef : System.Speech.Recognition.SrgsGrammar.SrgsRule -> System.Speech.Recognition.SrgsGrammar.SrgsRuleRef

Public Sub New (rule As SrgsRule)

参数

例外

示例

以下示例创建一个语法，该语法识别短语“赢得世界杯的国家是”，后跟赢得世界杯的国家的名称。 创建 SrgsRule 对象 winnerRule 并为其提供字符串标识符 WorldCupWinner后，该示例会将字符串“赢得世界杯冠军的国家”追加到规则中。 然后，该示例使用 SrgsOneOf 对象生成一个欧洲国家/地区列表和一个南美国家/地区列表，并将每个列表添加到其各自的规则 ruleEurope 或 ruleSAmerica。 然后，该示例为 ruleEurope 和 ruleSAmerica 创建规则引用，并将其添加到规则。WorldCupWinner

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

创建的语法具有以下形式。

<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>

注解

此构造函数创建对 SrgsRule 包含语法中的 对象的规则引用。 若要创建对外部语法文件中元素 rule 的规则引用，请使用以下任一构造函数：

• SrgsRuleRef

• SrgsRuleRef

• SrgsRuleRef

• SrgsRuleRef(Uri, String, String, String)

另请参阅

• 使用 SrgsGrammar 创建语法

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

public:
 SrgsRuleRef(Uri ^ uri);

public SrgsRuleRef (Uri uri);

new System.Speech.Recognition.SrgsGrammar.SrgsRuleRef : Uri -> System.Speech.Recognition.SrgsGrammar.SrgsRuleRef

Public Sub New (uri As Uri)

参数

例外

示例

以下示例为应用程序创建一个语法，用于返回有关总线穿梭服务的信息。 第一个方法 GrammarUrlForRoute采用指定路由的字符串，并将其追加到指定语法位置的字符串。 这指定该语法中的特定规则。 方法返回 Uri 该规则的 。

第二种方法 CreateGrammarForRoute创建名为 SrgsDocument 的 grammar 元素，其中包含由 Uri 传递给它的 GrammarUrlForRoute指定的规则引用。 请注意，名为 _route 的变量是封闭类的成员。

private Uri GrammarUrlForRoute(string route)
{
  return new Uri("http://localhost/MyBus/MyBusLocations.grxml#LocationsForRoute" + route);
}

private SrgsDocument CreateGrammarForRoute()
{
  SrgsDocument grammar = new SrgsDocument();
  grammar.Mode = SrgsGrammarMode.Voice;
  SrgsRule rule = new SrgsRule("LocationsForRoute" + _route);
  SrgsRuleRef ruleref = new SrgsRuleRef(GrammarUrlForRoute(_route));

  SrgsSemanticInterpretationTag tag = new SrgsSemanticInterpretationTag ("$.Location = $$");

  rule.Elements.Add(ruleref);
  rule.Elements.Add(tag);
  grammar.Rules.Add(rule);
  grammar.Root = rule;
  return grammar;
}

注解

此构造函数创建对外部语法文件的规则引用。 URI 还可以包含要引用的规则的标识符，例如 http://www.contoso.com/ExternalGrammar.grxml#targetRule。 uri如果 参数未指定规则标识符，则规则引用指向目标语法的根规则。 若要创建对同一 SrgsRule 语法中的对象的规则引用，请使用以下任一构造函数：

• SrgsRuleRef

• SrgsRuleRef

• SrgsRuleRef

另请参阅

• 使用 SrgsGrammar 创建语法

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

public:
 SrgsRuleRef(System::Speech::Recognition::SrgsGrammar::SrgsRule ^ rule, System::String ^ semanticKey);

public SrgsRuleRef (System.Speech.Recognition.SrgsGrammar.SrgsRule rule, string semanticKey);

new System.Speech.Recognition.SrgsGrammar.SrgsRuleRef : System.Speech.Recognition.SrgsGrammar.SrgsRule * string -> System.Speech.Recognition.SrgsGrammar.SrgsRuleRef

Public Sub New (rule As SrgsRule, semanticKey As String)

参数

示例

以下示例创建一个语法，用于为外部测试版选择城市。 该示例构造两 SrgsRuleRef 个实例，每个实例指定一个语义键。 这两个规则引用都针对同一 SrgsRule 个名为 cities的对象，但使用不同的语义键标记规则引用的识别结果。 语义键将已识别的城市标识为航班的出发城市或到达城市。 事件的处理程序 SpeechRecognized 使用键从识别结果检索使用 SrgsNameValueTag 创建的语义值。

using System;
using System.Speech.Recognition;
using System.Speech.Recognition.SrgsGrammar;

namespace SampleRecognition
{
  class Program
  {
    static void Main(string[] args)

    // Initialize a SpeechRecognitionEngine object.
    {
      using (SpeechRecognitionEngine recognizer =
         new SpeechRecognitionEngine(new System.Globalization.CultureInfo("en-US")))
      {

        // Build a rule with a list of cities, assign a semantic value to each city.
        SrgsItem chi = new SrgsItem("Chicago");
        chi.Add(new SrgsNameValueTag("ORD"));
        SrgsItem bos = new SrgsItem("Boston");
        bos.Add(new SrgsNameValueTag("BOS"));
        SrgsItem mia = new SrgsItem("Miami");
        mia.Add(new SrgsNameValueTag("MIA"));
        SrgsItem dal = new SrgsItem("Dallas");
        dal.Add(new SrgsNameValueTag("DFW"));

        SrgsOneOf cities = new SrgsOneOf(new SrgsItem[] { chi, bos, mia, dal });
        SrgsRule citiesRule = new SrgsRule("flightCities");
        citiesRule.Add(cities);

        // Build the root rule, add rule references to the cities rule.
        SrgsRule flightBooker = new SrgsRule("bookFlight");
        flightBooker.Add(new SrgsItem("I want to fly from"));
        flightBooker.Add(new SrgsRuleRef(citiesRule, "departureCity"));
        flightBooker.Add(new SrgsItem("to"));
        flightBooker.Add(new SrgsRuleRef(citiesRule, "arrivalCity"));

        // Build an SrgsDocument object from the flightBooker rule and add the cities rule.
        SrgsDocument cityChooser = new SrgsDocument(flightBooker);
        cityChooser.Rules.Add(citiesRule);

        // Create a Grammar object from the SrgsDocument and load it to the recognizer.
        Grammar departArrive = new Grammar(cityChooser);
        departArrive.Name = ("Cities Grammar");
        recognizer.LoadGrammarAsync(departArrive);

        // Configure recognizer input.
        recognizer.SetInputToDefaultAudioDevice();

        // Attach a handler for the SpeechRecognized event.
        recognizer.SpeechRecognized +=
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);

        // Start asynchronous recognition.
        recognizer.RecognizeAsync();
        Console.WriteLine("Starting asynchronous recognition...");

        // Keep the console window open.
        Console.ReadLine();
      }
    }

    // Handle the SpeechRecognized event.
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)
    {
      Console.WriteLine("Speech recognized: " + e.Result.Text);
      Console.WriteLine();
      Console.WriteLine("Semantic results:");
      Console.WriteLine("  The departure city is: " + e.Result.Semantics["departureCity"].Value);
      Console.WriteLine("  The destination city is: " + e.Result.Semantics["arrivalCity"].Value);
    }
  }
}

注解

此构造函数创建对 SrgsRule 包含语法中的 对象的规则引用。 若要创建对外部语法文件中元素 rule 的规则引用，请使用以下任一构造函数：

• SrgsRuleRef

• SrgsRuleRef

• SrgsRuleRef

• SrgsRuleRef(Uri, String, String, String)

另请参阅

• 使用 SrgsGrammar 创建语法

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

public:
 SrgsRuleRef(Uri ^ uri, System::String ^ rule);

public SrgsRuleRef (Uri uri, string rule);

new System.Speech.Recognition.SrgsGrammar.SrgsRuleRef : Uri * string -> System.Speech.Recognition.SrgsGrammar.SrgsRuleRef

Public Sub New (uri As Uri, rule As String)

参数

例外

注解

此构造函数创建对外部语法文件中元素 rule 的规则引用。 若要创建对同一 SrgsRule 语法中的对象的规则引用，请使用以下任一构造函数：

• SrgsRuleRef

• SrgsRuleRef

• SrgsRuleRef

另请参阅

• 使用 SrgsGrammar 创建语法

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

public:
 SrgsRuleRef(System::Speech::Recognition::SrgsGrammar::SrgsRule ^ rule, System::String ^ semanticKey, System::String ^ parameters);

public SrgsRuleRef (System.Speech.Recognition.SrgsGrammar.SrgsRule rule, string semanticKey, string parameters);

new System.Speech.Recognition.SrgsGrammar.SrgsRuleRef : System.Speech.Recognition.SrgsGrammar.SrgsRule * string * string -> System.Speech.Recognition.SrgsGrammar.SrgsRuleRef

Public Sub New (rule As SrgsRule, semanticKey As String, parameters As String)

参数

注解

此构造函数创建对 SrgsRule 包含语法中的 对象的规则引用。 若要创建对外部语法文件中元素 rule 的规则引用，请使用以下任一构造函数：

• SrgsRuleRef

• SrgsRuleRef

• SrgsRuleRef

• SrgsRuleRef(Uri, String, String, String)

另请参阅

• 使用 SrgsGrammar 创建语法

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

public:
 SrgsRuleRef(Uri ^ uri, System::String ^ rule, System::String ^ semanticKey);

public SrgsRuleRef (Uri uri, string rule, string semanticKey);

new System.Speech.Recognition.SrgsGrammar.SrgsRuleRef : Uri * string * string -> System.Speech.Recognition.SrgsGrammar.SrgsRuleRef

Public Sub New (uri As Uri, rule As String, semanticKey As String)

参数

例外

注解

此构造函数创建对外部语法文件中元素 rule 的规则引用。 若要创建对同一 SrgsRule 语法中的对象的规则引用，请使用以下任一构造函数：

• SrgsRuleRef

• SrgsRuleRef

• SrgsRuleRef

另请参阅

• 使用 SrgsGrammar 创建语法

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

Source:

SrgsRuleRef.cs

public:
 SrgsRuleRef(Uri ^ uri, System::String ^ rule, System::String ^ semanticKey, System::String ^ parameters);

public SrgsRuleRef (Uri uri, string rule, string semanticKey, string parameters);

new System.Speech.Recognition.SrgsGrammar.SrgsRuleRef : Uri * string * string * string -> System.Speech.Recognition.SrgsGrammar.SrgsRuleRef

Public Sub New (uri As Uri, rule As String, semanticKey As String, parameters As String)

参数

注解

此构造函数创建对外部语法文件中元素 rule 的规则引用。 若要创建对同一 SrgsRule 语法中的对象的规则引用，请使用以下任一构造函数：

• SrgsRuleRef

• SrgsRuleRef

• SrgsRuleRef

另请参阅

• 使用 SrgsGrammar 创建语法