GrammarBuilder Konstruktory
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Inicjuje nowe wystąpienie klasy GrammarBuilder.
Przeciążenia
| Nazwa | Opis |
|---|---|
| GrammarBuilder() |
Inicjuje nowe, puste wystąpienie GrammarBuilder klasy. |
| GrammarBuilder(Choices) |
Inicjuje nowe wystąpienie GrammarBuilder klasy z zestawu alternatyw. |
| GrammarBuilder(SemanticResultKey) |
Inicjuje nowe wystąpienie GrammarBuilder klasy z klucza semantycznego. |
| GrammarBuilder(SemanticResultValue) |
Inicjuje GrammarBuilder nowe wystąpienie klasy z wartości semantycznej. |
| GrammarBuilder(String) |
Inicjuje nowe wystąpienie GrammarBuilder klasy z sekwencji słów. |
| GrammarBuilder(String, SubsetMatchingMode) |
Inicjuje nowe wystąpienie GrammarBuilder klasy dla podzbioru sekwencji słów. |
| GrammarBuilder(GrammarBuilder, Int32, Int32) |
Inicjuje GrammarBuilder nowe wystąpienie klasy z powtarzającego się elementu. |
| GrammarBuilder(String, Int32, Int32) |
Inicjuje nowe wystąpienie GrammarBuilder klasy z sekwencji wyrazów w obiekcie String i określa, ile razy String można powtórzyć. |
Uwagi
Wystąpienia tej klasy mogą być również uzyskiwane przez niejawne konwersje z innych klas lub przez połączenie GrammarBuilder obiektu z drugim obiektem z nowego GrammarBuilderobiektu . Aby uzyskać więcej informacji, zobacz Implicit metody i Addition .
Aby dodać ograniczenia do istniejącego GrammarBuilderelementu , użyj Addmetody , Append, AppendDictationAppendRuleReference, i AppendWildcard oraz Addition operatora .
Ważna
Rozpoznawanie mowy może zgłosić wyjątek podczas korzystania z gramatyki rozpoznawania mowy zawierającej zduplikowane elementy semantyczne o tej samej nazwie klucza lub wielu elementach semantycznych, które mogą wielokrotnie modyfikować wartość tego samego elementu semantycznego.
Aby uzyskać więcej informacji na temat tworzenia i używania gramatyki rozpoznawania mowy, zobacz Rozpoznawanie mowy.
GrammarBuilder()
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
Inicjuje nowe, puste wystąpienie GrammarBuilder klasy.
public:
GrammarBuilder();
public GrammarBuilder();
Public Sub New ()
Przykłady
W poniższym przykładzie użyto GrammarBuilder metod i Choices obiektów do utworzenia gramatyki, która może rozpoznać jedną z dwóch fraz: "Make background colorChoice" lub "Ustaw tło na colorChoice".
W przykładzie Choices użyto obiektu do utworzenia listy dopuszczalnych wartości dla funkcji colorChoice z tablicy String obiektów.
Choices Obiekt jest analogiczny do one-of elementu w specyfikacji SRGS i zawiera zestaw alternatywnych fraz, z których każdy może być rozpoznawany podczas wypowiadania. W przykładzie Choices użyto również obiektu do grupowania tablicy dwóch GrammarBuilder obiektów w parę alternatywnych fraz, które mogą rozpoznać wynikowa gramatyka. Alternatywne wyrazy lub frazy są składnikiem większości gramatyki, a Choices obiekt zapewnia tę funkcję gramatyki skonstruowanej za pomocą GrammarBuilderpolecenia .
W przykładzie na koniec tworzony jest Grammar obiekt z GrammarBuilder obiektu skonstruowanego Choices na podstawie obiektu.
private Grammar CreateColorGrammar()
{
// Create a set of color choices.
Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
GrammarBuilder colorElement = new GrammarBuilder(colorChoice);
// Create grammar builders for the two versions of the phrase.
GrammarBuilder makePhrase = new GrammarBuilder("Make background");
makePhrase.Append(colorElement);
GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
setPhrase.Append(colorElement);
// Create a Choices for the two alternative phrases, convert the Choices
// to a GrammarBuilder, and construct the Grammar object from the result.
GrammarBuilder bothPhrases = new GrammarBuilder();
Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
bothPhrases.Append(bothChoices);
Grammar grammar = new Grammar(bothPhrases);
grammar.Name = "backgroundColor";
return grammar;
}
Uwagi
Aby dodać reguły do istniejącego GrammarBuilder obiektu, użyj Addoperatora , Append, AppendDictation, AppendRuleReference, i AppendWildcard .Addition
Ważna
Rozpoznawanie mowy może zgłosić wyjątek podczas korzystania z gramatyki rozpoznawania mowy zawierającej zduplikowane elementy semantyczne o tej samej nazwie klucza lub wielu elementach semantycznych, które mogą wielokrotnie modyfikować wartość tego samego elementu semantycznego.
Zobacz też
Dotyczy
GrammarBuilder(Choices)
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
Inicjuje nowe wystąpienie GrammarBuilder klasy z zestawu alternatyw.
public:
GrammarBuilder(System::Speech::Recognition::Choices ^ alternateChoices);
public GrammarBuilder(System.Speech.Recognition.Choices alternateChoices);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.Choices -> System.Speech.Recognition.GrammarBuilder
Public Sub New (alternateChoices As Choices)
Parametry
- alternateChoices
- Choices
Zestaw alternatyw.
Przykłady
W poniższym przykładzie użyto GrammarBuilder metod i Choices obiektów do utworzenia gramatyki, która może rozpoznać jedną z dwóch fraz: "Make background colorChoice" lub "Ustaw tło na colorChoice".
W przykładzie Choices użyto obiektu do utworzenia listy dopuszczalnych wartości dla funkcji colorChoice z tablicy String obiektów.
Choices Obiekt jest analogiczny do one-of elementu w specyfikacji SRGS i zawiera zestaw alternatywnych fraz, z których dowolny może być rozpoznawany podczas wypowiadania. W przykładzie Choices użyto również obiektu do grupowania tablicy dwóch GrammarBuilder obiektów w parę alternatywnych fraz, które mogą rozpoznać wynikowa gramatyka. Alternatywne wyrazy lub frazy są składnikiem większości gramatyki, a Choices obiekt zapewnia tę funkcję gramatyki skonstruowanej za pomocą GrammarBuilderpolecenia .
W przykładzie na koniec tworzony jest Grammar obiekt z GrammarBuilder obiektu skonstruowanego Choices na podstawie obiektu.
private Grammar CreateColorGrammar()
{
// Create a set of color choices.
Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
GrammarBuilder colorElement = new GrammarBuilder(colorChoice);
// Create grammar builders for the two versions of the phrase.
GrammarBuilder makePhrase = new GrammarBuilder("Make background");
makePhrase.Append(colorElement);
GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
setPhrase.Append(colorElement);
// 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});
Grammar grammar = new Grammar((GrammarBuilder)bothChoices);
grammar.Name = "backgroundColor";
return grammar;
}
Uwagi
Aby uzyskać więcej informacji na temat tworzenia gramatyki rozpoznawania mowy zawierającej alternatywy, zobacz Using Choices to Create a GrammarBuilder Grammar (Używanie opcji do tworzenia gramatyki programu GrammarBuilder).
Zobacz też
Dotyczy
GrammarBuilder(SemanticResultKey)
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
Inicjuje nowe wystąpienie GrammarBuilder klasy z klucza semantycznego.
public:
GrammarBuilder(System::Speech::Recognition::SemanticResultKey ^ key);
public GrammarBuilder(System.Speech.Recognition.SemanticResultKey key);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultKey -> System.Speech.Recognition.GrammarBuilder
Public Sub New (key As SemanticResultKey)
Parametry
Klucz semantyczny.
Przykłady
Poniższy przykład tworzy gramatykę rozpoznawania mowy, która może rozpoznawać dwie frazy: "Make background colorChoice" i "Set background to colorChoice", gdzie kolorChoice jest wybierany z zestawu kolorów. Gramatyka pozwala użytkownikowi mówić dowolną z kilku nazw kolorów i zwraca semantyczne informacje o rozpoznanej nazwie koloru do aplikacji.
W przykładzie użyto pojedynczego elementu SemanticResultKey , za pomocą którego można pobrać SemanticValue element skojarzony z kolorem używanym przez użytkownika. Jeśli na przykład dane wejściowe zawierają frazę "Ustaw tło na czerwoną", wynik rozpoznawania zawiera wartość semantyczną "#FF0000", którą można pobrać przy użyciu procedury obsługi dla SpeechRecognized zdarzenia.
W przykładzie użyto Stringobiektów , , ChoicesSemanticResultKey, SemanticResultValuei GrammarBuilder do utworzenia ograniczeń zawartych w ostatnim GrammarBuilder obiekcie bothPhrases. Na koniec przykład tworzy Grammar obiekt z ukończonego GrammarBuilderobiektu .
private Grammar CreateColorGrammar()
{
// Create a set of color choices.
// Include semantic information about each of the colors.
Choices colorChoice = new Choices();
GrammarBuilder colorBuilder = new GrammarBuilder("red");
SemanticResultValue colorValue =
new SemanticResultValue(colorBuilder, "#FF0000");
colorChoice.Add(new GrammarBuilder(colorValue));
colorBuilder = new GrammarBuilder("green");
colorValue = new SemanticResultValue(colorBuilder, "#00FF00");
colorChoice.Add(new GrammarBuilder(colorValue));
colorBuilder = new GrammarBuilder("blue");
colorValue = new SemanticResultValue(colorBuilder, "#0000FF");
colorChoice.Add(new GrammarBuilder(colorValue));
GrammarBuilder colorElement = new GrammarBuilder(colorChoice);
// Create grammar builders for the two versions of the phrase.
GrammarBuilder makePhrase = new GrammarBuilder("Make background");
makePhrase.Append(colorElement);
GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
setPhrase.Append(colorElement);
// Create a Choices object for the two alternative phrases.
Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);
// Create the semantic key for referencing the color information.
SemanticResultKey colorKey =
new SemanticResultKey("ColorCode", bothPhrases);
bothPhrases = new GrammarBuilder(colorKey);
// Construct the Grammar object from the GrammarBuilder.
Grammar grammar = new Grammar(bothPhrases);
grammar.Name = "backgroundColor";
return grammar;
}
Uwagi
Podczas tworzenia GrammarBuilder wystąpienia na podstawie SemanticResultValue obiektu do gramatyki można dodać informacje semantyczne, które można zwrócić w wyniku rozpoznawania. Dostęp do informacji semantycznych w wyniku rozpoznawania można uzyskać przy użyciu Semantics właściwości RecognizedPhrase, która jest dostępna w procedurze obsługi dla SpeechRecognized zdarzenia. Jeśli definiuje GrammarBuilder element SemanticResultKey, może służyć do pobierania informacji semantycznych w wyniku rozpoznawania skojarzonego z kluczem. Zobacz przykład , Append(SemanticResultKey)a także zobacz SemanticResultValue i SemanticResultKey.
Ważna
Podczas konstruowania GrammarBuilder obiektów zawierających SemanticResultValue lub SemanticResultKey wystąpień należy unikać tworzenia zduplikowanych elementów semantycznych o tej samej nazwie klucza lub wielu elementach semantycznych, które mogą wielokrotnie modyfikować Value właściwość SemanticValue obiektu. Rozpoznawanie mowy może zgłosić wyjątek, jeśli napotka te okoliczności.
Zobacz też
Dotyczy
GrammarBuilder(SemanticResultValue)
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
Inicjuje GrammarBuilder nowe wystąpienie klasy z wartości semantycznej.
public:
GrammarBuilder(System::Speech::Recognition::SemanticResultValue ^ value);
public GrammarBuilder(System.Speech.Recognition.SemanticResultValue value);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultValue -> System.Speech.Recognition.GrammarBuilder
Public Sub New (value As SemanticResultValue)
Parametry
- value
- SemanticResultValue
Semantyczna wartość lub para nazwa/wartość.
Przykłady
Poniższy przykład tworzy gramatykę rozpoznawania mowy, która może rozpoznawać dwie frazy: "Make background colorChoice" i "Set background to colorChoice", gdzie kolorChoice jest wybierany z zestawu kolorów. Gramatyka pozwala użytkownikowi mówić dowolną z kilku nazw kolorów i zwraca semantyczne informacje o rozpoznanej nazwie koloru do aplikacji.
W przykładzie użyto pojedynczego elementu SemanticResultKey , za pomocą którego można pobrać SemanticValue element skojarzony z kolorem używanym przez użytkownika. Jeśli na przykład dane wejściowe zawierają frazę "Ustaw tło na czerwoną", wynik rozpoznawania zawiera wartość semantyczną "#FF0000", którą można pobrać przy użyciu procedury obsługi dla SpeechRecognized zdarzenia.
W przykładzie użyto Stringobiektów , , ChoicesSemanticResultKey, SemanticResultValuei GrammarBuilder do utworzenia ograniczeń zawartych w ostatnim GrammarBuilder obiekcie bothPhrases. Na koniec przykład tworzy Grammar obiekt z ukończonego GrammarBuilderobiektu .
private Grammar CreateColorGrammar()
{
// Create a set of color choices.
// Include semantic information about each of the colors.
Choices colorChoice = new Choices();
GrammarBuilder colorBuilder = new GrammarBuilder("red");
SemanticResultValue colorValue =
new SemanticResultValue(colorBuilder, "#FF0000");
colorChoice.Add(new GrammarBuilder(colorValue));
colorBuilder = new GrammarBuilder("green");
colorValue = new SemanticResultValue(colorBuilder, "#00FF00");
colorChoice.Add(new GrammarBuilder(colorValue));
colorBuilder = new GrammarBuilder("blue");
colorValue = new SemanticResultValue(colorBuilder, "#0000FF");
colorChoice.Add(new GrammarBuilder(colorValue));
GrammarBuilder colorElement = new GrammarBuilder(colorChoice);
// Create grammar builders for the two versions of the phrase.
GrammarBuilder makePhrase = new GrammarBuilder("Make background");
makePhrase.Append(colorElement);
GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
setPhrase.Append(colorElement);
// Create a Choices for the two alternative phrases.
Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);
// Create the semantic key for referencing the color information.
SemanticResultKey colorKey =
new SemanticResultKey("ColorCode", bothPhrases);
bothPhrases = new GrammarBuilder(colorKey);
// Construct the grammar from the grammar builder.
Grammar grammar = new Grammar(bothPhrases);
grammar.Name = "backgroundColor";
return grammar;
}
Uwagi
Podczas tworzenia GrammarBuilder wystąpienia na podstawie SemanticResultValue obiektu do gramatyki można dodać informacje semantyczne, które można zwrócić w wyniku rozpoznawania. Dostęp do informacji semantycznych w wyniku rozpoznawania można uzyskać przy użyciu Semantics właściwości RecognizedPhrase, która jest dostępna w procedurze obsługi dla SpeechRecognized zdarzenia. Jeśli definiuje GrammarBuilder element SemanticResultKey, może służyć do pobierania informacji semantycznych w wyniku rozpoznawania skojarzonego z kluczem. Zobacz przykład , Append(SemanticResultKey)a także zobacz SemanticResultValue i SemanticResultKey.
Ważna
Podczas konstruowania GrammarBuilder obiektów zawierających SemanticResultValue lub SemanticResultKey wystąpień należy unikać tworzenia zduplikowanych elementów semantycznych o tej samej nazwie klucza lub wielu elementach semantycznych, które mogą wielokrotnie modyfikować Value właściwość SemanticValue obiektu. Rozpoznawanie mowy może zgłosić wyjątek, jeśli napotka te okoliczności.
Zobacz też
Dotyczy
GrammarBuilder(String)
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
Inicjuje nowe wystąpienie GrammarBuilder klasy z sekwencji słów.
public:
GrammarBuilder(System::String ^ phrase);
public GrammarBuilder(string phrase);
new System.Speech.Recognition.GrammarBuilder : string -> System.Speech.Recognition.GrammarBuilder
Public Sub New (phrase As String)
Parametry
- phrase
- String
Sekwencja wyrazów.
Przykłady
W poniższym przykładzie użyto GrammarBuilder metod i Choices obiektów do utworzenia gramatyki, która może rozpoznać jedną z dwóch fraz: "Make background colorChoice" lub "Ustaw tło na colorChoice".
Po utworzeniu listy dopuszczalnych wartości dla funkcji colorChoice przy użyciu Choices obiektu przykład inicjuje dwa GrammarBuilder obiekty makePhrase i setPhrase, używając ciągu jako argumentu.
W przykładzie na koniec tworzony Grammar jest obiekt z rzutowania ChoicesGrammarBuilder obiektu na obiekt.
private Grammar CreateColorGrammar()
{
// Create a set of color choices.
Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
GrammarBuilder colorElement = new GrammarBuilder(colorChoice);
// Create grammar builders for the two versions of the phrase.
GrammarBuilder makePhrase = new GrammarBuilder("Make background");
makePhrase.Append(colorElement);
GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
setPhrase.Append(colorElement);
// Create a Choices for the two alternative phrases, convert the Choices
// to a GrammarBuilder, and construct the Grammar object from the result.
Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
Grammar grammar = new Grammar((GrammarBuilder)bothChoices);
grammar.Name = "backgroundColor";
return grammar;
}
Uwagi
Fraza reprezentuje dokładną frazę mówiną, którą gramatyka rozpoznawania mowy może rozpoznać. Aby uzyskać więcej informacji na temat tworzenia gramatyki rozpoznawania mowy zawierającej ciągi, zobacz Using Strings to Create a GrammarBuilder Grammar (Używanie ciągów do tworzenia gramatyki programu GrammarBuilder).
Zobacz też
Dotyczy
GrammarBuilder(String, SubsetMatchingMode)
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
Inicjuje nowe wystąpienie GrammarBuilder klasy dla podzbioru sekwencji słów.
public:
GrammarBuilder(System::String ^ phrase, System::Speech::Recognition::SubsetMatchingMode subsetMatchingCriteria);
public GrammarBuilder(string phrase, System.Speech.Recognition.SubsetMatchingMode subsetMatchingCriteria);
new System.Speech.Recognition.GrammarBuilder : string * System.Speech.Recognition.SubsetMatchingMode -> System.Speech.Recognition.GrammarBuilder
Public Sub New (phrase As String, subsetMatchingCriteria As SubsetMatchingMode)
Parametry
- phrase
- String
Sekwencja wyrazów.
- subsetMatchingCriteria
- SubsetMatchingMode
Tryb dopasowywania gramatyki rozpoznawania mowy używa do rozpoznawania frazy.
Przykłady
Poniższy przykład tworzy gramatykę rozpoznawania mowy dla każdej SubsetMatchingMode wartości i gramatyki do wyboru między gramatykami trybu dopasowania. Jeśli wartość phrase to "jeden dwa trzy cztery cztery pięć sześciu siedmiu", gramatyka Subsequence rozpoznaje dane wejściowe "dwa trzy cztery", ale nie dane wejściowe "jeden trzy pięć". Jednak gramatyka Uporządkowany podzestaw rozpoznaje oba te dane wejściowe.
private static IEnumerable<Grammar>
CreateMatchingModeGrammars(string phrase)
{
List<Grammar> grammars = new List<Grammar>(5);
Choices modeChoice = new Choices();
Type enumType = typeof(SubsetMatchingMode);
foreach (SubsetMatchingMode mode in Enum.GetValues(enumType))
{
string modeName = Enum.GetName(enumType, mode);
modeName = BreakAtCaps(modeName);
GrammarBuilder builder = new GrammarBuilder(phrase, mode);
Grammar modeGrammar = new Grammar(builder);
modeGrammar.Name = modeName;
modeGrammar.Enabled = false;
grammars.Add(modeGrammar);
modeChoice.Add(modeName);
}
Grammar choiceGrammar = new Grammar(modeChoice);
choiceGrammar.Name = "choice";
grammars.Add(choiceGrammar);
return grammars;
}
// Insert spaces preceding each uppercase letter in a string.
private static string BreakAtCaps(string item)
{
if (item == null || item.Length == 0)
{
return item;
}
StringBuilder sb = new StringBuilder(item[0].ToString());
for (int i = 1; i < item.Length; i++)
{
char c = item[i];
if (char.IsUpper(c))
{
sb.Append(" ");
}
sb.Append(c);
}
return sb.ToString();
}
Uwagi
Parametr phrase reprezentuje frazę, którą może rozpoznać gramatyka rozpoznawania mowy. Parametr subsetMatchingMode określa podzbiór frazy, która może być mówiona w celu osiągnięcia pomyślnego rozpoznawania całej frazy. Służy do tworzenia gramatyki z listą wpisów, które mają długie nazwy, bez konieczności mówienia całej nazwy przez użytkowników w celu dopasowania elementu.
Aby uzyskać więcej informacji na temat pasujących trybów, zobacz SubsetMatchingMode. Aby uzyskać więcej informacji na temat tworzenia gramatyki rozpoznawania mowy zawierającej ciągi, zobacz Using Strings to Create a GrammarBuilder Grammar (Używanie ciągów do tworzenia gramatyki programu GrammarBuilder).
Zobacz też
Dotyczy
GrammarBuilder(GrammarBuilder, Int32, Int32)
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
Inicjuje GrammarBuilder nowe wystąpienie klasy z powtarzającego się elementu.
public:
GrammarBuilder(System::Speech::Recognition::GrammarBuilder ^ builder, int minRepeat, int maxRepeat);
public GrammarBuilder(System.Speech.Recognition.GrammarBuilder builder, int minRepeat, int maxRepeat);
new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.GrammarBuilder * int * int -> System.Speech.Recognition.GrammarBuilder
Public Sub New (builder As GrammarBuilder, minRepeat As Integer, maxRepeat As Integer)
Parametry
- builder
- GrammarBuilder
Powtórzony element.
- minRepeat
- Int32
Minimalna liczba razy, gdy dane wejściowe pasujące do elementu zdefiniowanego przez builder element muszą stanowić dopasowanie.
- maxRepeat
- Int32
Maksymalna liczba razy, gdy dane wejściowe pasujące do elementu zdefiniowanego przez builder program mogą stanowić dopasowanie.
Przykłady
Poniższy przykład tworzy gramatykę rozpoznawania mowy na potrzeby zamawiania pizzy. Zaczyna się od opcjonalnej, otwierającej frazy, po której następuje od jednego do czterech toppingów, i zamyka się słowem "pizza".
private static Grammar CreatePizzaGrammar()
{
// Create a Choices object from a string array of alternative toppings.
Choices toppings = new Choices(new string[] {
"cheese", "mushroom", "tomato", "onion",
"anchovy", "chicken", "pepperoni"});
// Create a GrammarBuilder and append the Choices object.
GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);
andToppings.Append(toppings);
// Construct the phrase.
GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);
gb.Append(toppings);
gb.Append(new GrammarBuilder(andToppings, 0, 3));
gb.Append("pizza");
// Create the Grammar from the GrammarBuilder.
Grammar grammar = new Grammar(gb);
grammar.Name = "Pizza Order";
return grammar;
}
Uwagi
Jeśli wartość to minRepeat 0, nowy GrammarBuilder reprezentuje opcjonalny element.
Wartość minRepeat musi być większa lub równa 0 i mniejsza niż lub równa wartości maxRepeat.
Ważna
Po określeniu powtórzeń dla GrammarBuilder obiektów zawierających SemanticResultValue lub SemanticResultKey wystąpień należy unikać tworzenia zduplikowanych elementów semantycznych o tej samej nazwie klucza lub wielu elementach semantycznych, które mogą wielokrotnie modyfikować Value właściwość SemanticValue obiektu. Rozpoznawanie mowy może zgłosić wyjątek, jeśli napotka te okoliczności.
Zobacz też
Dotyczy
GrammarBuilder(String, Int32, Int32)
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
- Źródło:
- GrammarBuilder.cs
Inicjuje nowe wystąpienie GrammarBuilder klasy z sekwencji wyrazów w obiekcie String i określa, ile razy String można powtórzyć.
public:
GrammarBuilder(System::String ^ phrase, int minRepeat, int maxRepeat);
public GrammarBuilder(string phrase, int minRepeat, int maxRepeat);
new System.Speech.Recognition.GrammarBuilder : string * int * int -> System.Speech.Recognition.GrammarBuilder
Public Sub New (phrase As String, minRepeat As Integer, maxRepeat As Integer)
Parametry
- phrase
- String
Powtarzana sekwencja słów.
- minRepeat
- Int32
Minimalna liczba przypadków dopasowania danych wejściowych do frazy musi być zgodna.
- maxRepeat
- Int32
Maksymalna liczba przypadków dopasowania danych wejściowych do frazy może stanowić dopasowanie.
Przykłady
Poniższy przykład tworzy gramatykę rozpoznawania mowy na potrzeby zamawiania pizzy. Zaczyna się od opcjonalnej, otwierającej frazy, po której następuje od jednego do czterech toppingów, i zamyka się słowem "pizza".
private static Grammar CreatePizzaGrammar()
{
// Create a Choices object with alternatives for toppings.
Choices toppings = new Choices(new string[] {
"cheese", "mushroom", "tomato", "onion",
"anchovy", "chicken", "pepperoni"});
// Create a GrammarBuilder and append the Choices object.
GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);
andToppings.Append(toppings);
// Construct the phrase.
GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);
gb.Append(toppings);
gb.Append(new GrammarBuilder(andToppings, 0, 3));
gb.Append("pizza");
// Create the Grammar from the GrammarBuilder.
Grammar grammar = new Grammar(gb);
grammar.Name = "Pizza Order";
return grammar;
}
Uwagi
Jeśli wartość to minRepeat 0, nowy GrammarBuilder reprezentuje opcjonalny element.
Wartość minRepeat musi być większa lub równa 0 i mniejsza niż lub równa wartości maxRepeat. Aby uzyskać więcej informacji na temat tworzenia gramatyki rozpoznawania mowy zawierającej ciągi, zobacz Using Strings to Create a GrammarBuilder Grammar (Używanie ciągów do tworzenia gramatyki programu GrammarBuilder).