SrgsDocument.WriteSrgs(XmlWriter) Méthode

Définition

Espace de noms:

System.Speech.Recognition.SrgsGrammar

Assembly:

System.Speech.dll

Paquet:

System.Speech v9.0.0-preview.5.24306.7

Source:

SrgsDocument.cs

Écrit le contenu de l’objet SrgsDocument dans un fichier de grammaire au format XML conforme à la spécification Speech Recognition Grammar Specification (SRGS) Version 1.0.

public:
 void WriteSrgs(System::Xml::XmlWriter ^ srgsGrammar);

public void WriteSrgs (System.Xml.XmlWriter srgsGrammar);

member this.WriteSrgs : System.Xml.XmlWriter -> unit

Public Sub WriteSrgs (srgsGrammar As XmlWriter)

Paramètres

srgsGrammar

XmlWriter

Objet XmlWriter utilisé pour écrire l'instance SrgsDocument.

Exceptions

ArgumentNullException

srgsGrammar a la valeur null.

Exemples

L’exemple suivant crée un SrgsDocument objet, puis crée une règle publique nommée winnerRule. Il crée ensuite un SrgsItem qui se compose de la chaîne « Une nation qui a remporté la Coupe du monde est : », et ajoute cet élément à la Elements propriété de la règle. L’exemple crée ensuite deux règles supplémentaires (ruleEurope et ruleSAmerica), chacune d’elles étant un SrgsOneOf objet qui contient trois SrgsItem objets. Après cela, un autre SrgsOneOf objet est créé qui contient des SrgsRuleRef objets qui font référence à ruleEurope et ruleSAmerica. Le nouvel SrgsOneOf objet est ensuite ajouté à la Elements propriété de winnerRule. Après cela, les trois règles (winnerRule, ruleEuropeet ruleSAmerica) sont ajoutées à la Rules propriété du SrgsDocument. Enfin, l’exemple crée un fichier XML vide et une instance de XmlWriter. La WriteSrgs méthode utilise l’instance XmlWriter pour écrire le contenu du SrgsDocument dans le fichier XML.

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;

  // Create a string object with the path to the file to use.
  string srgsDocumentFile = Path.Combine(Path.GetTempPath(), "srgsDocumentFile.xml");

  // Create an XmlWriter object and pass the file path.
  XmlWriter writer = XmlWriter.Create(srgsDocumentFile);

  // Write the contents of the XmlWriter object to an SRGS-compatible XML file.
  document.WriteSrgs(writer);
  writer.Close();
}