SrgsDocument Konstruktory

Definicja

Przestrzeń nazw:

System.Speech.Recognition.SrgsGrammar

Zestaw:

System.Speech.dll

Inicjuje nowe wystąpienie klasy SrgsDocument.

Przeciążenia

SrgsDocument()	Inicjuje nowe wystąpienie klasy SrgsDocument.
SrgsDocument(GrammarBuilder)	Inicjuje nowe wystąpienie SrgsDocument klasy z GrammarBuilder obiektu.
SrgsDocument(SrgsRule)	Inicjuje nowe wystąpienie SrgsDocument klasy i określa SrgsRule obiekt jako główną regułę gramatyki.
SrgsDocument(String)	Inicjuje nowe wystąpienie SrgsDocument klasy, określając lokalizację dokumentu XML, który jest używany do wypełniania SrgsDocument wystąpienia.
SrgsDocument(XmlReader)	Inicjuje nowe wystąpienie SrgsDocument klasy z wystąpienia XmlReader , które odwołuje się do pliku gramatyki w formacie XML.

Uwagi

Używając konstruktorów SrgsDocument klasy, można utworzyć wystąpienie SrgsDocument z GrammarBuilder , SrgsRule , lub XmlReader , z ciągu, który zawiera ścieżkę do gramatyki w formacie XML lub można zainicjować puste wystąpienie SrgsDocument .

SrgsDocument()

Inicjuje nowe wystąpienie klasy SrgsDocument.

public:
 SrgsDocument();

public SrgsDocument ();

Public Sub New ()

Przykłady

Poniższy przykład tworzy SrgsDocument obiekt, a następnie tworzy regułę publiczną o nazwie winnerRule . Następnie tworzy SrgsItem , która składa się z ciągu "kraj, który kupił światowy filiżankę:", i dodaje ten element do Elements Właściwości reguły. Przykład tworzy dwie więcej reguł ( ruleEurope i ruleSAmerica ), z których każdy jest SrgsOneOf obiektem, który zawiera trzy SrgsItem obiekty. Następnie SrgsOneOf tworzony jest inny obiekt, który zawiera SrgsRuleRef obiekty odwołujące się do ruleEurope i ruleSAmerica . Nowy SrgsOneOf obiekt jest następnie dodawany do Elements właściwości winnerRule . Następnie wszystkie trzy reguły ( winnerRule , ruleEurope i ruleSAmerica ) zostaną dodane do Rules właściwości SrgsDocument . Na koniec trzy reguły są kompilowane w postaci binarnej reprezentacji gramatyki.

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;  

  String fileName = Path.GetTempFileName();  
  using (FileStream stream = new FileStream(fileName, FileMode.Create))   
  {   

    // Compile the grammar to a binary format.  
    SrgsGrammarCompiler.Compile(document, stream);   
  }  
}  

Uwagi

Ten konstruktor tworzy puste SrgsDocument wystąpienie. Aby zbudować gramatykę w pustym SrgsDocument wystąpieniu, należy dodać wystąpienia klas, które reprezentują elementy SRGS, takie jak SrgsRule ,, SrgsRuleRef SrgsOneOf , i SrgsItem .

SrgsDocument(GrammarBuilder)

Inicjuje nowe wystąpienie SrgsDocument klasy z GrammarBuilder obiektu.

public:
 SrgsDocument(System::Speech::Recognition::GrammarBuilder ^ builder);

public SrgsDocument (System.Speech.Recognition.GrammarBuilder builder);

new System.Speech.Recognition.SrgsGrammar.SrgsDocument : System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.SrgsGrammar.SrgsDocument

Public Sub New (builder As GrammarBuilder)

Parametry

builder

GrammarBuilder

GrammarBuilderObiekt używany do tworzenia SrgsDocument wystąpienia.

Wyjątki

ArgumentNullException

builder to null.

Przykłady

Poniższy przykład tworzy gramatykę w GrammarBuilder wystąpieniu przy użyciu Choices obiektów. Następnie tworzy SrgsDocument GrammarBuilder obiekt z obiektu.

GrammarBuilder builder = null;  

// Create new Choices objects and add countries/regions, and create GrammarBuilder objects.  
Choices choicesEurope = new Choices(new string[] { "England", "France", "Germany", "Italy" });  
GrammarBuilder europe = new GrammarBuilder(choicesEurope);  

Choices choicesSAmerica = new Choices(new string[] { "Argentina", "Brazil", "Uruguay" });  
GrammarBuilder sAmerica = new GrammarBuilder(choicesSAmerica);  

Choices worldCupWinnerChoices = new Choices(new GrammarBuilder[] {choicesEurope, choicesSAmerica});  

// Create new GrammarBuilder from a Choices object.  
builder = new GrammarBuilder(worldCupWinnerChoices);  

// Create an SrgsDocument object from a GrammarBuilder object.  
SrgsDocument document = new SrgsDocument(builder);  

SrgsDocument(SrgsRule)

Inicjuje nowe wystąpienie SrgsDocument klasy i określa SrgsRule obiekt jako główną regułę gramatyki.

public:
 SrgsDocument(System::Speech::Recognition::SrgsGrammar::SrgsRule ^ grammarRootRule);

public SrgsDocument (System.Speech.Recognition.SrgsGrammar.SrgsRule grammarRootRule);

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

Public Sub New (grammarRootRule As SrgsRule)

Parametry

grammarRootRule

SrgsRule

root ruleW SrgsDocument obiekcie.

Wyjątki

ArgumentNullException

grammarRootRule to null.

Przykłady

Poniższy przykład tworzy dwie reguły ( chooseCities i destCities ) do wybierania pochodzenia i miejsc docelowych dla lotu. Przykład inicjuje SrgsDocument wystąpienie przy użyciu chooseCities reguły jako argumentu. Przykład zapisuje zawartość kolekcji reguł i nazwę głównej reguły w konsoli programu.

// Create a rule that contains a list of destination cities.  
SrgsRule destCities = new SrgsRule("Destination");  
SrgsOneOf toCities = new SrgsOneOf(new string[] { "New York", "Seattle", "Denver" });  
destCities.Add(toCities);  

// Create a list of origin cities and supporting phrases.  
SrgsOneOf fromCities = new SrgsOneOf(new SrgsItem[] {   
  new SrgsItem("Dallas"), new SrgsItem("Miami"), new SrgsItem("Chicago") });  
SrgsItem intro = new SrgsItem("I want to fly from");  
SrgsItem to = new SrgsItem("to");  

// Create the root rule of the grammar, and assemble the components.  
SrgsRule chooseCities = new SrgsRule("Trip");  
chooseCities.Add(intro);  
chooseCities.Add(fromCities);  
chooseCities.Add(to);  
chooseCities.Add(new SrgsRuleRef(destCities));  

// Create the SrgsDocument and specify the root rule to add.  
SrgsDocument bookFlight = new SrgsDocument(chooseCities);  

// Add the rule for the destination cities to the document's rule collection.  
bookFlight.Rules.Add(new SrgsRule[] { destCities });  

// Display the contents of the Rules collection and the name of the root rule.  
foreach (SrgsRule rule in bookFlight.Rules)  
{  
  Console.WriteLine("Rule " + rule.Id + " is in the rules collection");  
}  
Console.WriteLine("Root Rule " + bookFlight.Root.Id);  

// Create a Grammar object and load it to the recognizer.  
Grammar g = new Grammar(bookFlight);  
g.Name = ("City Chooser");  
recognizer.LoadGrammarAsync(g);  

Uwagi

Ten konstruktor dodaje określoną regułę do SrgsRulesCollection SrgsDocument obiektu i ustawia ją jako Root regułę dla gramatyki.

SrgsDocument(String)

Inicjuje nowe wystąpienie SrgsDocument klasy, określając lokalizację dokumentu XML, który jest używany do wypełniania SrgsDocument wystąpienia.

public:
 SrgsDocument(System::String ^ path);

public SrgsDocument (string path);

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

Public Sub New (path As String)

Parametry

path

String

Lokalizacja pliku XML SRGS.

Wyjątki

ArgumentNullException

path to null.

ArgumentException

path jest pustym ciągiem.

Przykłady

Poniższy przykład tworzy nowy SrgsDocument plik z pliku o nazwie "srgsDocumentFile.xml".

string srgsDocumentFile = Path.Combine(Path.GetTempPath(), "srgsDocumentFile.xml");  
SrgsDocument document = null;  

if (File.Exists(srgsDocumentFile))  
   document = new SrgsDocument(srgsDocumentFile);  

SrgsDocument(XmlReader)

Inicjuje nowe wystąpienie SrgsDocument klasy z wystąpienia XmlReader , które odwołuje się do pliku gramatyki w formacie XML.

public:
 SrgsDocument(System::Xml::XmlReader ^ srgsGrammar);

public SrgsDocument (System.Xml.XmlReader srgsGrammar);

new System.Speech.Recognition.SrgsGrammar.SrgsDocument : System.Xml.XmlReader -> System.Speech.Recognition.SrgsGrammar.SrgsDocument

Public Sub New (srgsGrammar As XmlReader)

Parametry

srgsGrammar

XmlReader

XmlReaderObiekt, który został utworzony za pomocą SrgsDocument wystąpienia XML.

Wyjątki

ArgumentNullException

srgsGrammar to null.

Przykłady

Poniższy przykład tworzy nowe wystąpienie z SrgsDocument wystąpienia XmlReader , które odwołuje się do pliku "srgsDocumentFile.xml".

string srgsDocumentFile = Path.Combine(Path.GetTempPath(), "srgsDocumentFile.xml");  
SrgsDocument document = null;  

if (File.Exists(srgsDocumentFile))  
{  
  XmlReader reader = XmlReader.Create(srgsDocumentFile);  
  document = new SrgsDocument(reader);  
  reader.Close();  
}