GrammarBuilder Constructores

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Inicializa una nueva instancia de la clase GrammarBuilder.

Sobrecargas

GrammarBuilder()	Inicializa una nueva instancia vacía de la clase GrammarBuilder.
GrammarBuilder(Choices)	Inicializa una nueva instancia de la clase GrammarBuilder a partir de un conjunto de alternativas.
GrammarBuilder(SemanticResultKey)	Inicializa una nueva instancia de la clase GrammarBuilder a partir de una clave semántica.
GrammarBuilder(SemanticResultValue)	Inicializa una nueva instancia de la clase GrammarBuilder a partir de un valor semántico.
GrammarBuilder(String)	Inicializa una nueva instancia de la clase GrammarBuilder a partir de una secuencia de palabras.
GrammarBuilder(String, SubsetMatchingMode)	Inicializa una nueva instancia de la clase GrammarBuilder para un subconjunto de una secuencia de palabras.
GrammarBuilder(GrammarBuilder, Int32, Int32)	Inicializa una nueva instancia de la clase GrammarBuilder a partir de un elemento repetido.
GrammarBuilder(String, Int32, Int32)	Inicializa una nueva instancia de la clase GrammarBuilder a partir del flujo de palabras en un objeto String y especifica cuántas veces se puede repetir String.

Comentarios

Las instancias de esta clase también se pueden obtener mediante conversiones implícitas de otras clases o mediante la combinación de un GrammarBuilder objeto con un segundo objeto a partir de un nuevo GrammarBuilder . Para obtener más información, vea Implicit los Addition métodos y.

Para agregar restricciones a un existente GrammarBuilder , use los Add métodos,, Append AppendDictation , y AppendRuleReference AppendWildcard , y el Addition operador.

Importante

El reconocedor de voz puede producir una excepción cuando se usa una gramática de reconocimiento de voz que contiene elementos semánticos duplicados con el mismo nombre de clave o varios elementos semánticos que podrían modificar repetidamente el valor del mismo elemento semántico.

Para obtener más información sobre la creación y el uso de las gramáticas de reconocimiento de voz, consulte reconocimiento de voz.

GrammarBuilder()

Inicializa una nueva instancia vacía de la clase GrammarBuilder.

public:
 GrammarBuilder();

public GrammarBuilder ();

Public Sub New ()

Ejemplos

En el ejemplo siguiente GrammarBuilder Choices se usan objetos y para crear una gramática que pueda reconocer cualquiera de las dos frases "make Background colorChoice" o "Set Background to colorChoice".

En el ejemplo se usa un Choices objeto para crear una lista de valores aceptables para colorChoice a partir de una matriz de String objetos. Un Choices objeto es análogo al one-of elemento en la especificación de SRGS y contiene un conjunto de frases alternativas, cualquiera de las cuales se puede reconocer cuando se habla. En el ejemplo también se usa un Choices objeto para agrupar una matriz de dos GrammarBuilder objetos en un par de frases alternativas que la gramática resultante puede reconocer. Palabras o frases alternativas son un componente de la mayoría de las gramáticas y el Choices objeto proporciona esta funcionalidad para las gramáticas construidas con GrammarBuilder .

Finalmente, en el ejemplo se crea un Grammar objeto a partir de un GrammarBuilder construido a partir de un Choices objeto.

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;  
}  

Comentarios

Para agregar reglas a un GrammarBuilder objeto existente, use los Add métodos,,, y Append AppendDictation AppendRuleReference AppendWildcard , y el Addition operador.

Importante

El reconocedor de voz puede producir una excepción cuando se usa una gramática de reconocimiento de voz que contiene elementos semánticos duplicados con el mismo nombre de clave o varios elementos semánticos que podrían modificar repetidamente el valor del mismo elemento semántico.

Consulte también

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

GrammarBuilder(Choices)

Inicializa una nueva instancia de la clase GrammarBuilder a partir de un conjunto de alternativas.

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)

Parámetros

alternateChoices

Choices

Conjunto de alternativas.

Ejemplos

En el ejemplo siguiente GrammarBuilder Choices se usan objetos y para crear una gramática que pueda reconocer cualquiera de las dos frases "make Background colorChoice" o "Set Background to colorChoice".

En el ejemplo se usa un Choices objeto para crear una lista de valores aceptables para colorChoice a partir de una matriz de String objetos. Un Choices objeto es análogo al one-of elemento en la especificación de SRGS y contiene un conjunto de frases alternativas, cualquiera de las cuales se puede reconocer cuando se habla. En el ejemplo también se usa un Choices objeto para agrupar una matriz de dos GrammarBuilder objetos en un par de frases alternativas que la gramática resultante puede reconocer. Palabras o frases alternativas son un componente de la mayoría de las gramáticas y el Choices objeto proporciona esta funcionalidad para las gramáticas construidas con GrammarBuilder .

Finalmente, en el ejemplo se crea un Grammar objeto a partir de un GrammarBuilder construido a partir de un Choices objeto.

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;  
}  

Comentarios

Para obtener más información acerca de cómo crear una gramática de reconocimiento de voz que contenga alternativas, consulte uso de opciones para crear una gramática de GrammarBuilder.

Consulte también

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

GrammarBuilder(SemanticResultKey)

Inicializa una nueva instancia de la clase GrammarBuilder a partir de una clave semántica.

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)

Parámetros

key

SemanticResultKey

La clave semántica.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz que puede reconocer las dos frases "make Background colorChoice" y "Set Background to colorChoice", donde colorChoice se selecciona a partir de un conjunto de colores. La gramática permite a un usuario hablar de varios nombres de color y devuelve información semántica sobre el nombre de color reconocido a la aplicación.

En el ejemplo se usa un único con el que SemanticResultKey puede recuperar el SemanticValue que está asociado al color que habla el usuario. Por ejemplo, si la entrada contiene la frase "establecer fondo en rojo", el resultado del reconocimiento contiene el valor semántico de "#FF0000", que se puede recuperar mediante un controlador para el SpeechRecognized evento.

En el ejemplo se usan los objetos,, String Choices SemanticResultKey , SemanticResultValue y GrammarBuilder para generar las restricciones que se incluyen en el último GrammarBuilder objeto, bothPhrases . Por último, en el ejemplo se crea un Grammar objeto a partir de la completa GrammarBuilder .

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;  
}  

Comentarios

Cuando se crea una GrammarBuilder instancia a partir de un SemanticResultValue objeto, se agrega información semántica a la gramática que se puede devolver en el resultado del reconocimiento. Puede tener acceso a la información semántica en el resultado del reconocimiento mediante la Semantics propiedad de RecognizedPhrase , que está disponible en el controlador del SpeechRecognized evento. Si GrammarBuilder define un SemanticResultKey , se puede usar para recuperar la información semántica de un resultado de reconocimiento asociado a la clave. Vea el ejemplo de y Append(SemanticResultKey) vea también SemanticResultValue y SemanticResultKey .

Importante

Al construir GrammarBuilder objetos que contienen SemanticResultValue instancias de o, asegúrese de SemanticResultKey evitar la creación de elementos semánticos duplicados con el mismo nombre de clave o varios elementos semánticos que podrían modificar repetidamente la Value propiedad de un SemanticValue objeto. El reconocedor de voz puede producir una excepción si encuentra estas circunstancias.

Consulte también

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

GrammarBuilder(SemanticResultValue)

Inicializa una nueva instancia de la clase GrammarBuilder a partir de un valor semántico.

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)

Parámetros

value

SemanticResultValue

El valor o el par de nombre y valor semántico.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz que puede reconocer las dos frases "make Background colorChoice" y "Set Background to colorChoice", donde colorChoice se selecciona a partir de un conjunto de colores. La gramática permite a un usuario hablar de varios nombres de color y devuelve información semántica sobre el nombre de color reconocido a la aplicación.

En el ejemplo se usa un único con el que SemanticResultKey puede recuperar el SemanticValue que está asociado al color que habla el usuario. Por ejemplo, si la entrada contiene la frase "establecer fondo en rojo", el resultado del reconocimiento contiene el valor semántico de "#FF0000", que se puede recuperar mediante un controlador para el SpeechRecognized evento.

En el ejemplo se usan los objetos,, String Choices SemanticResultKey , SemanticResultValue y GrammarBuilder para generar las restricciones que se incluyen en el último GrammarBuilder objeto, bothPhrases . Por último, en el ejemplo se crea un Grammar objeto a partir de la completa GrammarBuilder .

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;  
}  

Comentarios

Cuando se crea una GrammarBuilder instancia a partir de un SemanticResultValue objeto, se agrega información semántica a la gramática que se puede devolver en el resultado del reconocimiento. Puede tener acceso a la información semántica en el resultado del reconocimiento mediante la Semantics propiedad de RecognizedPhrase , que está disponible en el controlador del SpeechRecognized evento. Si GrammarBuilder define un SemanticResultKey , se puede usar para recuperar la información semántica de un resultado de reconocimiento asociado a la clave. Vea el ejemplo de y Append(SemanticResultKey) vea también SemanticResultValue y SemanticResultKey .

Importante

Al construir GrammarBuilder objetos que contienen SemanticResultValue instancias de o, asegúrese de SemanticResultKey evitar la creación de elementos semánticos duplicados con el mismo nombre de clave o varios elementos semánticos que podrían modificar repetidamente la Value propiedad de un SemanticValue objeto. El reconocedor de voz puede producir una excepción si encuentra estas circunstancias.

Consulte también

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

GrammarBuilder(String)

Inicializa una nueva instancia de la clase GrammarBuilder a partir de una secuencia de palabras.

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)

Parámetros

phrase

String

La secuencia de palabras.

Ejemplos

En el ejemplo siguiente GrammarBuilder Choices se usan objetos y para crear una gramática que pueda reconocer cualquiera de las dos frases "make Background colorChoice" o "Set Background to colorChoice".

Después de crear una lista de valores aceptables para colorChoice con un Choices objeto, el ejemplo inicializa dos GrammarBuilder objetos, makePhrase y setPhrase , usando una cadena como argumento.

Finalmente, en el ejemplo Grammar se crea un objeto a partir de un Choices objeto convertido en un GrammarBuilder objeto.

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;  
}  

Comentarios

La frase representa una frase oral exacta que la gramática de reconocimiento de voz puede reconocer. Para obtener más información sobre cómo crear una gramática de reconocimiento de voz que contenga cadenas, vea usar cadenas para crear una gramática de GrammarBuilder.

Consulte también

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

GrammarBuilder(String, SubsetMatchingMode)

Inicializa una nueva instancia de la clase GrammarBuilder para un subconjunto de una secuencia de palabras.

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)

Parámetros

phrase

String

La secuencia de palabras.

subsetMatchingCriteria

SubsetMatchingMode

El modo coincidente que la gramática de reconocimiento de voz usa para reconocer la frase.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz para cada SubsetMatchingMode valor y una gramática para elegir entre las gramáticas del modo de coincidencia. Si el valor de phrase es "1 2 3 4 5 6 7", la gramática de subsecuencia reconoce la entrada "2 3 4", pero no la entrada "1 3 5". Sin embargo, la gramática de subconjuntos ordenados reconoce ambas entradas.

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();  
}  

Comentarios

El phrase parámetro representa la frase que la gramática de reconocimiento de voz puede reconocer. El subsetMatchingMode parámetro especifica un subconjunto de la frase que se puede decir para lograr un reconocimiento correcto de toda la frase. Puede utilizar esta opción para crear una gramática con una lista de entradas que tienen nombres largos, sin necesidad de que los usuarios hablen de un nombre completo para que coincidan con un elemento.

Para obtener más información acerca de los modos de coincidencia, vea SubsetMatchingMode . Para obtener más información sobre cómo crear una gramática de reconocimiento de voz que contenga cadenas, vea usar cadenas para crear una gramática de GrammarBuilder.

Consulte también

• SubsetMatchingMode

GrammarBuilder(GrammarBuilder, Int32, Int32)

Inicializa una nueva instancia de la clase GrammarBuilder a partir de un elemento repetido.

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)

Parámetros

builder

GrammarBuilder

Elemento repetido.

minRepeat

Int32

El número mínimo de veces que la entrada coincidente con el elemento definido por builder debe aparecer para que constituya una coincidencia.

maxRepeat

Int32

El número máximo de veces que la entrada coincidente con el elemento definido por builder puede aparecer para que constituya una coincidencia.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz para ordenar una pizza. Comienza con una frase opcional, de apertura, seguida de uno a cuatro ingredientes y se cierra con la palabra "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;  
}  

Comentarios

Si el valor de minRepeat es 0, el nuevo GrammarBuilder representa un elemento opcional.

El valor de minRepeat debe ser mayor o igual que 0 y menor o igual que el valor de maxRepeat .

Importante

Al especificar repeticiones para GrammarBuilder objetos que contienen SemanticResultValue instancias de o, asegúrese de evitar la creación de SemanticResultKey elementos semánticos duplicados con el mismo nombre de clave o varios elementos semánticos que podrían modificar repetidamente la Value propiedad de un SemanticValue objeto. El reconocedor de voz puede producir una excepción si encuentra estas circunstancias.

Consulte también

• Choices
• Grammar

GrammarBuilder(String, Int32, Int32)

Inicializa una nueva instancia de la clase GrammarBuilder a partir del flujo de palabras en un objeto String y especifica cuántas veces se puede repetir String.

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)

Parámetros

phrase

String

La secuencia repetida de palabras.

minRepeat

Int32

El número mínimo de veces que la entrada coincidente con la frase debe aparecer para que constituya una coincidencia.

maxRepeat

Int32

El número máximo de veces que la entrada coincidente con la frase puede aparecer para que constituya una coincidencia.

Ejemplos

En el ejemplo siguiente se crea una gramática de reconocimiento de voz para ordenar una pizza. Comienza con una frase opcional, de apertura, seguida de uno a cuatro ingredientes y se cierra con la palabra "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;  
}  

Comentarios

Si el valor de minRepeat es 0, el nuevo GrammarBuilder representa un elemento opcional.

El valor de minRepeat debe ser mayor o igual que 0 y menor o igual que el valor de maxRepeat . Para obtener más información sobre cómo crear una gramática de reconocimiento de voz que contenga cadenas, vea usar cadenas para crear una gramática de GrammarBuilder.

Consulte también

• Choices
• Grammar