Udostępnij za pośrednictwem


GrammarBuilder Konstruktory

Definicja

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

key
SemanticResultKey

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).

Zobacz też

Dotyczy