SrgsRule Konstruktor

Definisi

Ruang nama:

System.Speech.Recognition.SrgsGrammar

Rakitan:

System.Speech.dll

Paket:

System.Speech v9.0.0-preview.6.24327.7

Menginisialisasi instans baru kelas SrgsRule.

Overload

SrgsRule(String)	Menginisialisasi instans SrgsRule baru kelas dan menentukan pengidentifikasi untuk aturan.
SrgsRule(String, SrgsElement[])	Menginisialisasi instans SrgsRule baru kelas dari array SrgsElement objek.

SrgsRule(String)

Sumber:

SrgsRule.cs

Menginisialisasi instans SrgsRule baru kelas dan menentukan pengidentifikasi untuk aturan.

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)

Parameter

id

String

Pengidentifikasi aturan.

Pengecualian

ArgumentNullException

idadalah null.

ArgumentOutOfRangeException

id kosong.

FormatException

id bukan pengidentifikasi aturan yang tepat.

Contoh

Contoh berikut membuat tata bahasa yang mengenali frasa "Bangsa yang telah memenangkan Piala Dunia adalah" diikuti dengan nama negara yang telah memenangkan Piala Dunia. Contoh membuat SrgsRule objek bernama winnerRule dan meneruskan pengidentifikasi WorldCupWinner sebagai String. Objek SrgsOneOf terdiri dari array objek baru SrgsItem yang berisi alternatif untuk dikenali oleh aturan.

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

Keterangan

SrgsRule Konstruktor menginisialisasi Id properti . Pengidentifikasi harus unik dalam tata bahasa tertentu.

SrgsRule Konstruktor melemparkan FormatException dalam keadaan berikut:

• id bukan nama XML yang valid, seperti yang didefinisikan dalam Extensible Markup Language (XML) 1.0 (Edisi Kelima). Untuk memparafrasekan definisi ini, nama XML yang valid harus dimulai dengan huruf, garis bawah ('_') , atau titik dua (':') dan dapat diikuti dengan nol atau lebih karakter NameChar (juga ditentukan dalam spesifikasi XML).

• id adalah "NULL" atau "VOID" atau "SAMPAH".

• id berisi setidaknya satu karakter ID aturan yang tidak valid. Karakter ini adalah: '?', '*', '+', '|', '(', '), '^', '$', '/', ';', '.', '=', '', '<>', '[', ']', '{', '}', '\\', ' ', '\t', '\r', dan '\n'.

Lihat juga

• Membuat Tata Bahasa Menggunakan SrgsGrammar

SrgsRule(String, SrgsElement[])

Sumber:

SrgsRule.cs

Menginisialisasi instans SrgsRule baru kelas dari array SrgsElement objek.

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

Parameter

id

String

Pengidentifikasi aturan.

elements

SrgsElement[]

Array SrgsElement elemen.

Pengecualian

ArgumentNullException

idadalah null.

elementsadalah null.

ArgumentOutOfRangeException

id kosong.

FormatException

id bukan pengidentifikasi aturan yang tepat.

Contoh

Contoh berikut membuat tata bahasa yang mengenali frasa "Bangsa yang telah memenangkan Piala Dunia adalah" diikuti dengan nama negara yang telah memenangkan Piala Dunia. Contoh membuat aturan publik bernama WorldCupWinner. Contohnya kemudian membuat dua SrgsRule objek, ruleEurope dan ruleSAmerica, meneruskan String untuk pengidentifikasi aturan dan array yang SrgsElementSrgsOneOf berisi objek. Selanjutnya, contoh menambahkan referensi aturan ke ruleEurope dan ruleSAmerica dari aturan 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;
}

Tata bahasa yang dibuat memiliki formulir berikut.

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

Keterangan

SrgsRule Konstruktor menginisialisasi Id properti . Pengidentifikasi harus unik dalam tata bahasa tertentu.

SrgsRule Konstruktor melemparkan FormatException dalam keadaan berikut:

• id bukan nama XML yang valid, seperti yang didefinisikan dalam Extensible Markup Language (XML) 1.0 (Edisi Kelima). Untuk memparafrasekan definisi ini, nama XML yang valid harus dimulai dengan huruf, garis bawah ('_') , atau titik dua (':') dan dapat diikuti dengan nol atau lebih karakter NameChar (juga ditentukan dalam spesifikasi XML).

• id adalah "NULL" atau "VOID" atau "SAMPAH".

• id berisi setidaknya satu karakter ID aturan yang tidak valid. Karakter ini adalah: '?', '*', '+', '|', '(', '), '^', '$', '/', ';', '.', '=', '', '<>', '[', ']', '{', '}', '\\', ' ', '\t', '\r', dan '\n'.

Lihat juga

• Membuat Tata Bahasa Menggunakan SrgsGrammar