Freigeben über


GrammarBuilder.Add Methode

Definition

Erstellt eine neue GrammarBuilder , die eine Abfolge von zwei Grammatikelementen enthält.

Überlädt

Name Beschreibung
Add(Choices, GrammarBuilder)

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

Add(GrammarBuilder, Choices)

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

Add(GrammarBuilder, GrammarBuilder)

Erstellt eine neue GrammarBuilder , die eine Abfolge von zwei GrammarBuilder Objekten enthält.

Add(GrammarBuilder, String)

Erstellt eine neue GrammarBuilder , die ein GrammarBuilder Objekt enthält, gefolgt von einem Ausdruck.

Add(String, GrammarBuilder)

Erstellt eine neue GrammarBuilder , die einen Ausdruck 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 in Grammatiken zu schaffen, die mit GrammarBuilder. 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.

A kann auch aus Objekten des ChoicesTyps GrammarBuilderStringSemanticResultKeySemanticResultValueabgerufen werden. Weitere Informationen finden Sie unter den Operatoren und Addition den Implicit Operatoren.

Von Bedeutung

Die Spracherkennung kann eine Ausnahme auslösen, wenn eine Spracherkennungsgrammatik verwendet wird, die doppelte semantische Elemente mit demselben Schlüsselnamen oder mehreren semantischen Elementen 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
Quelle:
GrammarBuilder.cs

Erstellt ein neues GrammarBuilder Objekt, das 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 eine Reihe von Alternativen darstellt.

builder
GrammarBuilder

Das zweite Grammatikelement.

Gibt zurück

A GrammarBuilder für die Abfolge 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 unter den Operatoren und Addition den Implicit Operatoren.

Von Bedeutung

Wenn Sie Objekte kombinieren und GrammarBuilder Objekte, Choices die oder SemanticResultKey Instanzen enthaltenSemanticResultValue, vermeiden Sie, doppelte semantische Elemente mit demselben Schlüsselnamen oder mehreren semantischen Elementen zu erstellen, die die Value Eigenschaft eines SemanticValue Objekts wiederholt ändern können. 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
Quelle:
GrammarBuilder.cs

Erstellt ein neues GrammarBuilder Objekt, das 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 eine Reihe von Alternativen darstellt.

Gibt zurück

A GrammarBuilder für die Abfolge des builder Elements gefolgt vom choices Element.

Beispiele

Im folgenden Beispiel wird eine Grammatik für die Spracherkennung erstellt, mit der die beiden Ausdrücke " Hintergrundfarbe erstellen" und "Hintergrund auf Farbe festlegen" erkannt werden können, wobei farbe aus einer Reihe von Farben ausgewählt wird. Verschiedene Typen werden verwendet, um die endgültige Grammatik zu erstellen, 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 unter den Operatoren und Addition den Implicit Operatoren.

Von Bedeutung

Wenn Sie Objekte kombinierenChoices, die oder SemanticResultKey Instanzen mit anderen Grammatikelementen enthaltenSemanticResultValue, sollten Sie vermeiden, doppelte semantische Elemente mit demselben Schlüsselnamen oder mehreren semantischen Elementen zu erstellen, die die Value Eigenschaft eines SemanticValue Objekts GrammarBuilder 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
Quelle:
GrammarBuilder.cs

Erstellt eine neue GrammarBuilder , die eine Abfolge von 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

A GrammarBuilder für die Abfolge des builder1 Elements gefolgt vom builder2 Element.

Beispiele

Im folgenden Beispiel wird eine Grammatik für die Spracherkennung erstellt, mit der die beiden Ausdrücke " Hintergrundfarbe erstellen" und "Hintergrund auf Farbe festlegen" erkannt werden können, wobei farbe aus einer Reihe von Farben ausgewählt wird. Verschiedene Typen werden verwendet, um die endgültige Grammatik zu erstellen, 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 Parameter oder builder2 den builder1 Parameter.

Weitere Informationen finden Sie unter den Operatoren und Addition den Implicit Operatoren.

Von Bedeutung

Wenn Sie Objekte kombinierenChoices, die oder SemanticResultKey Instanzen mit anderen Grammatikelementen enthaltenSemanticResultValue, sollten Sie vermeiden, doppelte semantische Elemente mit demselben Schlüsselnamen oder mehreren semantischen Elementen zu erstellen, die die Value Eigenschaft eines SemanticValue Objekts GrammarBuilder 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
Quelle:
GrammarBuilder.cs

Erstellt eine neue GrammarBuilder , die ein GrammarBuilder Objekt enthält, gefolgt von einem Ausdruck.

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 Abfolge von Wörtern darstellt.

Gibt zurück

A GrammarBuilder für die Abfolge des builder Elements gefolgt vom phrase Element.

Beispiele

Im folgenden Beispiel wird eine Grammatik für die Spracherkennung erstellt, mit der die beiden Ausdrücke " Hintergrundfarbe erstellen" und "Hintergrund auf Farbe festlegen" erkannt werden können, wobei farbe aus einer Reihe von Farben ausgewählt wird. Verschiedene Typen werden verwendet, um die endgültige Grammatik zu erstellen, 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 unter den Operatoren und Addition den Implicit Operatoren.

Weitere Informationen

Gilt für:

Add(String, GrammarBuilder)

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

Erstellt eine neue GrammarBuilder , die einen Ausdruck 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 Abfolge von Wörtern darstellt.

builder
GrammarBuilder

Das zweite Grammatikelement.

Gibt zurück

A GrammarBuilder für die Abfolge des phrase Elements gefolgt vom builder Element.

Beispiele

Im folgenden Beispiel wird eine Grammatik für die Spracherkennung erstellt, mit der die beiden Ausdrücke " Hintergrundfarbe erstellen" und "Hintergrund auf Farbe festlegen" erkannt werden können, wobei farbe aus einer Reihe von Farben ausgewählt wird. Verschiedene Typen werden verwendet, um die endgültige Grammatik zu erstellen, 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 unter den Operatoren und Addition den Implicit Operatoren.

Weitere Informationen

Gilt für: