Freigeben über


GrammarBuilder.Add Methode

Definition

Erstellt ein neuen GrammarBuilder, der eine Sequenz aus zwei Grammatikelementen enthält.

Überlädt

Add(Choices, GrammarBuilder)

Erstellt einen neuen GrammarBuilder, der ein Choices-Objekt gefolgt von einem GrammarBuilder-Objekt enthält.

Add(GrammarBuilder, Choices)

Erstellt einen neuen GrammarBuilder, der ein GrammarBuilder-Objekt gefolgt von einem Choices-Objekt enthält.

Add(GrammarBuilder, GrammarBuilder)

Erstellt einen neuen GrammarBuilder, der eine Sequenz aus zwei GrammarBuilder-Objekten enthält.

Add(GrammarBuilder, String)

Erstellt ein neues GrammarBuilder, das ein GrammarBuilder-Objekt gefolgt von einem Begriff enthält.

Add(String, GrammarBuilder)

Erstellt ein neues GrammarBuilder, das einen Begriff gefolgt von einem GrammarBuilder-Objekt enthält.

Hinweise

Die statischen Add Methoden bieten einen weiteren Mechanismus, mit dem Sie verschiedene Typen kombinieren können, um Vielfalt und Flexibilität bei Grammatiken zu schaffen, die mit GrammarBuildererstellt wurden. Diese Methoden entsprechen den statischen Addition Methoden, die auch für die GrammarBuilder -Klasse definiert sind. Die Reihenfolge der Parameter bestimmt die Reihenfolge der Elemente im neuen GrammarBuilder.

Ein GrammarBuilder kann auch von Choices, SemanticResultKey, SemanticResultValueund String-Objekten abgerufen werden. Weitere Informationen finden Sie in den Implicit Operatoren und Addition .

Wichtig

Die Spracherkennung kann eine Ausnahme auslösen, wenn eine Spracherkennungsgrammatik verwendet wird, die doppelte semantische Elemente mit demselben Schlüsselnamen oder mehrere semantische Elemente enthält, die den Wert desselben semantischen Elements wiederholt ändern können.

Weitere Informationen zum Erstellen und Verwenden von Spracherkennungsgrammatiken finden Sie unter Spracherkennung.

Add(Choices, GrammarBuilder)

Quelle:
GrammarBuilder.cs
Quelle:
GrammarBuilder.cs
Quelle:
GrammarBuilder.cs

Erstellt einen neuen GrammarBuilder, der ein Choices-Objekt gefolgt von einem GrammarBuilder-Objekt enthält.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::Choices ^ choices, System::Speech::Recognition::GrammarBuilder ^ builder);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.Choices choices, System.Speech.Recognition.GrammarBuilder builder);
static member Add : System.Speech.Recognition.Choices * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (choices As Choices, builder As GrammarBuilder) As GrammarBuilder

Parameter

choices
Choices

Das erste Grammatikelement, das einen Satz von Alternativen darstellt.

builder
GrammarBuilder

Das zweite Grammatikelement.

Gibt zurück

Ein GrammarBuilder für die Sequenz des choices-Elements gefolgt vom builder-Element.

Hinweise

GrammarBuilder unterstützt implizite Konvertierungen aus den folgenden Klassen:

Diese Methode akzeptiert die oben aufgeführten Objekte für den builder Parameter.

Weitere Informationen finden Sie in den Implicit Operatoren und Addition .

Wichtig

Wenn Sie Objekte kombinierenChoices, die oder SemanticResultKey Instanzen enthaltenSemanticResultValue, vermeiden Sie das Erstellen doppelter semantischer Elemente mit demselben Schlüsselnamen oder mehreren semantischen Elementen, die die Value Eigenschaft eines SemanticValue Objekts wiederholt ändern GrammarBuilder könnten. Die Spracherkennung kann eine Ausnahme auslösen, wenn diese Umstände auftreten. Weitere Informationen zum Erstellen einer Spracherkennungsgrammatik, die semantische Informationen enthält, finden Sie unter Hinzufügen von Semantik zu einer GrammarBuilder-Grammatik.

Weitere Informationen

Gilt für:

Add(GrammarBuilder, Choices)

Quelle:
GrammarBuilder.cs
Quelle:
GrammarBuilder.cs
Quelle:
GrammarBuilder.cs

Erstellt einen neuen GrammarBuilder, der ein GrammarBuilder-Objekt gefolgt von einem Choices-Objekt enthält.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder, System::Speech::Recognition::Choices ^ choices);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.GrammarBuilder builder, System.Speech.Recognition.Choices choices);
static member Add : System.Speech.Recognition.GrammarBuilder * System.Speech.Recognition.Choices -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder As GrammarBuilder, choices As Choices) As GrammarBuilder

Parameter

builder
GrammarBuilder

Das erste Grammatikelement.

choices
Choices

Das zweite Grammatikelement, das einen Satz von Alternativen darstellt.

Gibt zurück

Ein GrammarBuilder für die Sequenz des builder-Elements gefolgt vom choices-Element.

Beispiele

Im folgenden Beispiel wird eine Spracherkennungsgrammatik erstellt, die die beiden Ausdrücke " Hintergrundfarbe erstellen" und "Hintergrund auf Farbe festlegen" erkennen kann, wobei Die Farbe aus einer Reihe von Farben ausgewählt wird. Zum Erstellen der endgültigen Grammatik werden verschiedene Typen verwendet, z. B. String- Choicesund GrammarBuilder -Objekte. Die expliziten Umwandlungsoperatoren in den Aufrufen der Add Methoden sind optional.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the grammar from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Hinweise

GrammarBuilder unterstützt implizite Konvertierungen aus den folgenden Klassen:

Diese Methode akzeptiert die oben aufgeführten Objekte für den builder Parameter.

Weitere Informationen finden Sie in den Implicit Operatoren und Addition .

Wichtig

Wenn Sie Objekte, die oder SemanticResultKey Instanzen mit anderen Grammatikelementen enthaltenSemanticResultValue, kombinieren GrammarBuilderChoices, vermeiden Sie das Erstellen doppelter semantischer Elemente mit demselben Schlüsselnamen oder mehreren semantischen Elementen, die die Value Eigenschaft eines SemanticValue Objekts wiederholt ändern könnten. Die Spracherkennung kann eine Ausnahme auslösen, wenn diese Umstände auftreten.

Weitere Informationen

Gilt für:

Add(GrammarBuilder, GrammarBuilder)

Quelle:
GrammarBuilder.cs
Quelle:
GrammarBuilder.cs
Quelle:
GrammarBuilder.cs

Erstellt einen neuen GrammarBuilder, der eine Sequenz aus zwei GrammarBuilder-Objekten enthält.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder1, System::Speech::Recognition::GrammarBuilder ^ builder2);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.GrammarBuilder builder1, System.Speech.Recognition.GrammarBuilder builder2);
static member Add : System.Speech.Recognition.GrammarBuilder * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder1 As GrammarBuilder, builder2 As GrammarBuilder) As GrammarBuilder

Parameter

builder1
GrammarBuilder

Das erste Grammatikelement.

builder2
GrammarBuilder

Das zweite Grammatikelement.

Gibt zurück

Ein GrammarBuilder für die Sequenz des builder1-Elements gefolgt vom builder2-Element.

Beispiele

Im folgenden Beispiel wird eine Spracherkennungsgrammatik erstellt, die die beiden Ausdrücke " Hintergrundfarbe erstellen" und "Hintergrund auf Farbe festlegen" erkennen kann, wobei Die Farbe aus einer Reihe von Farben ausgewählt wird. Zum Erstellen der endgültigen Grammatik werden verschiedene Typen verwendet, z. B. String- Choicesund GrammarBuilder -Objekte. Die expliziten Umwandlungsoperatoren in den Aufrufen der Add Methoden sind optional.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the grammar from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Hinweise

GrammarBuilder unterstützt implizite Konvertierungen aus den folgenden Klassen:

Diese Methode akzeptiert die oben aufgeführten Objekte für den builder1 -Parameter oder builder2 .

Weitere Informationen finden Sie in den Implicit Operatoren und Addition .

Wichtig

Wenn Sie Objekte, die oder SemanticResultKey Instanzen mit anderen Grammatikelementen enthaltenSemanticResultValue, kombinieren GrammarBuilderChoices, vermeiden Sie das Erstellen doppelter semantischer Elemente mit demselben Schlüsselnamen oder mehreren semantischen Elementen, die die Value Eigenschaft eines SemanticValue Objekts wiederholt ändern könnten. Die Spracherkennung kann eine Ausnahme auslösen, wenn diese Umstände auftreten.

Weitere Informationen

Gilt für:

Add(GrammarBuilder, String)

Quelle:
GrammarBuilder.cs
Quelle:
GrammarBuilder.cs
Quelle:
GrammarBuilder.cs

Erstellt ein neues GrammarBuilder, das ein GrammarBuilder-Objekt gefolgt von einem Begriff enthält.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder, System::String ^ phrase);
public static System.Speech.Recognition.GrammarBuilder Add (System.Speech.Recognition.GrammarBuilder builder, string phrase);
static member Add : System.Speech.Recognition.GrammarBuilder * string -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder As GrammarBuilder, phrase As String) As GrammarBuilder

Parameter

builder
GrammarBuilder

Das erste Grammatikelement.

phrase
String

Das zweite Grammatikelement, das eine Sequenz von Wörtern darstellt.

Gibt zurück

Ein GrammarBuilder für die Sequenz des builder-Elements gefolgt vom phrase-Element.

Beispiele

Im folgenden Beispiel wird eine Spracherkennungsgrammatik erstellt, die die beiden Ausdrücke " Hintergrundfarbe erstellen" und "Hintergrund auf Farbe festlegen" erkennen kann, wobei Die Farbe aus einer Reihe von Farben ausgewählt wird. Zum Erstellen der endgültigen Grammatik werden verschiedene Typen verwendet, z. B. String- Choicesund GrammarBuilder -Objekte. Die expliziten Umwandlungsoperatoren in den Aufrufen der Add Methoden sind optional.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the grammar from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Hinweise

GrammarBuilder unterstützt implizite Konvertierungen aus den folgenden Klassen:

Diese Methode akzeptiert die oben aufgeführten Objekte für den builder Parameter.

Weitere Informationen finden Sie in den Implicit Operatoren und Addition .

Weitere Informationen

Gilt für:

Add(String, GrammarBuilder)

Quelle:
GrammarBuilder.cs
Quelle:
GrammarBuilder.cs
Quelle:
GrammarBuilder.cs

Erstellt ein neues GrammarBuilder, das einen Begriff gefolgt von einem GrammarBuilder-Objekt enthält.

public:
 static System::Speech::Recognition::GrammarBuilder ^ Add(System::String ^ phrase, System::Speech::Recognition::GrammarBuilder ^ builder);
public static System.Speech.Recognition.GrammarBuilder Add (string phrase, System.Speech.Recognition.GrammarBuilder builder);
static member Add : string * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (phrase As String, builder As GrammarBuilder) As GrammarBuilder

Parameter

phrase
String

Das erste Grammatikelement, das eine Sequenz von Wörtern darstellt.

builder
GrammarBuilder

Das zweite Grammatikelement.

Gibt zurück

Ein GrammarBuilder für die Sequenz des phrase-Elements gefolgt vom builder-Element.

Beispiele

Im folgenden Beispiel wird eine Spracherkennungsgrammatik erstellt, die die beiden Ausdrücke " Hintergrundfarbe erstellen" und "Hintergrund auf Farbe festlegen" erkennen kann, wobei Die Farbe aus einer Reihe von Farben ausgewählt wird. Zum Erstellen der endgültigen Grammatik werden verschiedene Typen verwendet, z. B. String- Choicesund GrammarBuilder -Objekte. Die expliziten Umwandlungsoperatoren in den Aufrufen der Add Methoden sind optional.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase =
    GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
  GrammarBuilder setPhrase =
    GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);

  // Create a Choices for the two alternative phrases, convert the Choices
  // to a GrammarBuilder, and construct the grammar from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Hinweise

GrammarBuilder unterstützt implizite Konvertierungen aus den folgenden Klassen:

Diese Methode akzeptiert die oben aufgeführten Objekte für den builder Parameter.

Weitere Informationen finden Sie in den Implicit Operatoren und Addition .

Weitere Informationen

Gilt für: