SrgsRule コンストラクター

定義

名前空間:

System.Speech.Recognition.SrgsGrammar

アセンブリ:

System.Speech.dll

パッケージ:

System.Speech v9.0.0-preview.5.24306.7

SrgsRule クラスの新しいインスタンスを初期化します。

オーバーロード

SrgsRule(String)	SrgsRule クラスの新しいインスタンスを初期化して、規則の識別子を指定します。
SrgsRule(String, SrgsElement[])	SrgsElement オブジェクトの配列から SrgsRule クラスの新しいインスタンスを初期化します。

SrgsRule(String)

ソース:

SrgsRule.cs

SrgsRule クラスの新しいインスタンスを初期化して、規則の識別子を指定します。

public:
 SrgsRule(System::String ^ id);

public SrgsRule (string id);

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

Public Sub New (id As String)

パラメーター

id

String

規則の識別子。

例外

ArgumentNullException

id が nullです。

ArgumentOutOfRangeException

id が空です。

FormatException

id は適切な規則識別子ではありません。

例

次の例では、"ワールドカップで優勝した国" という語句の後に、ワールドカップで優勝した国の名前を認識する文法を作成します。 この例では、 という名前winnerRuleの オブジェクトをSrgsRule作成し、 としてString識別子WorldCupWinnerを渡します。 オブジェクトは SrgsOneOf 、規則で認識される代替手段を含む新しい SrgsItem オブジェクトの配列で構成されます。

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

注釈

コンストラクターは SrgsRule 、 プロパティを Id 初期化します。 識別子は、特定の文法内で一意である必要があります。

コンストラクターは SrgsRule 、次の状況で を FormatException スローします。

• id は、 拡張マークアップ言語 (XML) 1.0 (第 5 版) で定義されている有効な XML 名ではありません。 この定義を言い換える場合、有効な XML 名は、文字、アンダースコア('_')、またはコロン (':') で始まる必要があり、その後に 0 個以上の NameChar 文字を付けることができます (XML 仕様でも定義されています)。

• id が "NULL" または "VOID" または "GARBAGE" です。

• id には、少なくとも 1 つの無効なルール ID 文字が含まれています。 これらの文字は、'?'、'*'、'+'、'|'、'('、')、'^'、'$'、'/'、';'、'=<>'、'['、']'、'{'、'}'、'\\'、'、'\t'、'\r'、'\n' です。

こちらもご覧ください

• SrgsGrammar を使用して文法を作成する

SrgsRule(String, SrgsElement[])

ソース:

SrgsRule.cs

SrgsElement オブジェクトの配列から SrgsRule クラスの新しいインスタンスを初期化します。

public:
 SrgsRule(System::String ^ id, ... cli::array <System::Speech::Recognition::SrgsGrammar::SrgsElement ^> ^ elements);

public SrgsRule (string id, params System.Speech.Recognition.SrgsGrammar.SrgsElement[] elements);

new System.Speech.Recognition.SrgsGrammar.SrgsRule : string * System.Speech.Recognition.SrgsGrammar.SrgsElement[] -> System.Speech.Recognition.SrgsGrammar.SrgsRule

Public Sub New (id As String, ParamArray elements As SrgsElement())

パラメーター

id

String

規則の識別子。

elements

SrgsElement[]

SrgsElement 要素の配列。

例外

ArgumentNullException

id が nullです。

elements が nullです。

ArgumentOutOfRangeException

id が空です。

FormatException

id は適切な規則識別子ではありません。

例

次の例では、"ワールドカップで優勝した国" という語句の後に、ワールドカップで優勝した国の名前を認識する文法を作成します。 この例では、 という名前 WorldCupWinnerのパブリック ルールを作成します。 次に、ruleEuropeルール識別子と ruleSAmericaオブジェクトを含むSrgsOneOf配列の をString渡す 2 つの SrgsRule オブジェクト と SrgsElement を作成します。 その後、この例では、規則 の との間でruleEuroperuleSAmericaルール参照を追加しますWorldCupWinner。

public void WorldSoccerWinners ()
{
  // Create a grammar from an SRGSDocument, create a new rule
  // and set its scope to public.
  SrgsDocument srgsGrammar = 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 grammar and make winnerRule
  // the root rule of the grammar.
  document.Rules.Add(new SrgsRule[] {winnerRule, ruleEurope, ruleSAmerica});
  srgsGrammar.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 、 プロパティを Id 初期化します。 識別子は、特定の文法内で一意である必要があります。

コンストラクターは SrgsRule 、次の状況で を FormatException スローします。

• id は、 拡張マークアップ言語 (XML) 1.0 (第 5 版) で定義されている有効な XML 名ではありません。 この定義を言い換える場合、有効な XML 名は、文字、アンダースコア('_')、またはコロン (':') で始まる必要があり、その後に 0 個以上の NameChar 文字を付けることができます (XML 仕様でも定義されています)。

• id が "NULL" または "VOID" または "GARBAGE" です。

• id には、少なくとも 1 つの無効なルール ID 文字が含まれています。 これらの文字は、'?'、'*'、'+'、'|'、'('、')、'^'、'$'、'/'、';'、'=<>'、'['、']'、'{'、'}'、'\\'、'、'\t'、'\r'、'\n' です。

こちらもご覧ください

• SrgsGrammar を使用して文法を作成する