Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe GrammarBuilder

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Fornece um mecanismo para criar programaticamente as restrições para uma gramática de reconhecimento de fala.

Namespace:   System.Speech.Recognition
Assembly:  System.Speech (em System.Speech.dll)

System.Object
  System.Speech.Recognition.GrammarBuilder

public class GrammarBuilder

NomeDescrição
System_CAPS_pubmethodGrammarBuilder()

Inicializa uma nova instância vazia da classe GrammarBuilder.

System_CAPS_pubmethodGrammarBuilder(Choices)

Inicializa uma nova instância do GrammarBuilder classe a partir de um conjunto de alternativas.

System_CAPS_pubmethodGrammarBuilder(GrammarBuilder, Int32, Int32)

Inicializa uma nova instância do GrammarBuilder classe a partir de um elemento repetido.

System_CAPS_pubmethodGrammarBuilder(SemanticResultKey)

Inicializa uma nova instância do GrammarBuilder classe a partir de uma chave semântica.

System_CAPS_pubmethodGrammarBuilder(SemanticResultValue)

Inicializa uma nova instância do GrammarBuilder classe a partir de um valor semântico.

System_CAPS_pubmethodGrammarBuilder(String)

Inicializa uma nova instância do GrammarBuilder classe de uma sequência de palavras.

System_CAPS_pubmethodGrammarBuilder(String, Int32, Int32)

Inicializa uma nova instância do GrammarBuilder classe da sequência de palavras em uma String e especifica quantas vezes o String pode ser repetido.

System_CAPS_pubmethodGrammarBuilder(String, SubsetMatchingMode)

Inicializa uma nova instância da classe GrammarBuilder para um subconjunto de uma sequência de palavras.

NomeDescrição
System_CAPS_pubpropertyCulture

Obtém ou define a cultura da gramática de reconhecimento de fala.

System_CAPS_pubpropertyDebugShowPhrases

Obtém uma cadeia de caracteres que mostra o conteúdo e a estrutura da gramática contida pelo GrammarBuilder.

NomeDescrição
System_CAPS_pubmethodSystem_CAPS_staticAdd(Choices, GrammarBuilder)

Cria um novo GrammarBuilder que contém um Choices objeto seguido por um GrammarBuilder objeto.

System_CAPS_pubmethodSystem_CAPS_staticAdd(GrammarBuilder, Choices)

Cria um novo GrammarBuilder que contém um GrammarBuilder objeto seguido por um Choices objeto.

System_CAPS_pubmethodSystem_CAPS_staticAdd(GrammarBuilder, GrammarBuilder)

Cria um novo GrammarBuilder que contém uma sequência de dois GrammarBuilder objetos.

System_CAPS_pubmethodSystem_CAPS_staticAdd(GrammarBuilder, String)

Cria um novo GrammarBuilder que contém um GrammarBuilder objeto seguido por uma frase.

System_CAPS_pubmethodSystem_CAPS_staticAdd(String, GrammarBuilder)

Cria um novo GrammarBuilder que contém uma frase seguida por um GrammarBuilder objeto.

System_CAPS_pubmethodAppend(Choices)

Anexa um conjunto de alternativas para a sequência atual de elementos de gramática.

System_CAPS_pubmethodAppend(GrammarBuilder)

Acrescenta um elemento de gramática para a sequência atual de elementos de gramática.

System_CAPS_pubmethodAppend(GrammarBuilder, Int32, Int32)

Acrescenta um elemento de gramática repetidas para a sequência atual de elementos de gramática.

System_CAPS_pubmethodAppend(SemanticResultKey)

Acrescenta uma chave semântica para a sequência atual de elementos de gramática.

System_CAPS_pubmethodAppend(SemanticResultValue)

Acrescenta um valor semântico para a sequência atual de elementos de gramática.

System_CAPS_pubmethodAppend(String)

Acrescenta uma frase para a sequência atual de elementos de gramática.

System_CAPS_pubmethodAppend(String, Int32, Int32)

Acrescenta uma frase repetida para a sequência atual de elementos de gramática.

System_CAPS_pubmethodAppend(String, SubsetMatchingMode)

Adiciona um elemento para um subconjunto de uma frase para a sequência atual de elementos de gramática.

System_CAPS_pubmethodAppendDictation()

Anexa a gramática de ditado padrão na sequência atual de elementos de gramática.

System_CAPS_pubmethodAppendDictation(String)

Anexa a gramática ditado especificado para a sequência atual de elementos de gramática.

System_CAPS_pubmethodAppendRuleReference(String)

Acrescenta um arquivo de definição de gramática à sequência de elementos da gramática atual.

System_CAPS_pubmethodAppendRuleReference(String, String)

Anexa a regra especificada de um arquivo de definição de gramática para a sequência atual de elementos de gramática.

System_CAPS_pubmethodAppendWildcard()

Acrescenta um elemento da gramática de reconhecimento que corresponde a uma entrada para a sequência atual de elementos da gramática.

System_CAPS_pubmethodEquals(Object)

Determina se o objeto especificado é igual ao objeto atual.(Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.(Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

Retorna uma cadeia de caracteres que representa o objeto atual.(Herdado de Object.)

NomeDescrição
System_CAPS_puboperatorSystem_CAPS_staticAddition(Choices, GrammarBuilder)

Cria um novo GrammarBuilder que contém um Choices objeto seguido por um GrammarBuilder objeto.

System_CAPS_puboperatorSystem_CAPS_staticAddition(GrammarBuilder, Choices)

Cria um novo GrammarBuilder que contém um GrammarBuilder seguido por um Choices.

System_CAPS_puboperatorSystem_CAPS_staticAddition(GrammarBuilder, GrammarBuilder)

Cria um novo GrammarBuilder que contém uma sequência de dois GrammarBuilder objetos.

System_CAPS_puboperatorSystem_CAPS_staticAddition(GrammarBuilder, String)

Cria um novo GrammarBuilder que contém um GrammarBuilder seguido por uma frase.

System_CAPS_puboperatorSystem_CAPS_staticAddition(String, GrammarBuilder)

Cria um novo GrammarBuilder que contém uma frase seguida por um GrammarBuilder.

System_CAPS_puboperatorSystem_CAPS_staticImplicit(Choices to GrammarBuilder)

Converte um objeto Choices em um objeto GrammarBuilder.

System_CAPS_puboperatorSystem_CAPS_staticImplicit(SemanticResultKey to GrammarBuilder)

Converte um objeto SemanticResultKey em um objeto GrammarBuilder.

System_CAPS_puboperatorSystem_CAPS_staticImplicit(SemanticResultValue to GrammarBuilder)

Converte um objeto SemanticResultValue em um objeto GrammarBuilder.

System_CAPS_puboperatorSystem_CAPS_staticImplicit(String to GrammarBuilder)

Converte uma cadeia de caracteres para um GrammarBuilder objeto.

Gramáticas de reconhecimento de fala geralmente são criadas no formato XML definido pelo Speech Recognition Grammar Specification (SRGS) Version 1.0. Se você estiver familiarizado com SRGS mas deseja gerar as gramáticas programaticamente, você pode usar o System.Speech.Recognition.SrgsGrammar namespace, cujos membros estreitamente correspondem aos elementos e atributos definidos por SRGS. Se você não estiver familiarizado com SRGS, ou se desejar uma abordagem programática leve para a criação de gramáticas com a qual você com eficiência pode fazer muitos cenários comuns; Você pode usar o GrammarBuilder e Choices classes.

Use GrammarBuilder composto de objetos para criar uma árvore hierárquica de Choices objetos que contêm frases alternativos, Intercalado com preâmbulo e frases de pós-amble em cada nó e propagado com valores semânticos que transmitem o significado de volta para o aplicativo.

Para usar um GrammarBuilder para criar um Grammar de objeto, use as etapas a seguir.

  1. Crie um objeto GrammarBuilder.

  2. Anexar restrições para o GrammarBuilder, como String objetos, Choices, SemanticResultKey, SemanticResultValue, DictationGrammare outros GrammarBuilder objetos que definem as restrições da gramática.

  3. Use um do Grammar construtores para criar um Grammar objeto do concluído GrammarBuilder gramática.

Criando com GrammarBuilder é mais adequada para gramáticas que têm uma única regra que contém listas ou talvez a lista de listas. Para criar programaticamente gramáticas que têm várias regras, ou que precisam fazer referências de regra interna, use as classes do System.Speech.Recognition.SrgsGrammar namespace.

Instâncias do GrammarBuilder também podem ser obtidas pelo conversões implícitas de algumas outras classes ou combinando um GrammarBuilder com um segundo objeto que contém as restrições para uma gramática. Para obter mais informações, consulte o Implicit e Addition operadores e Add métodos.

Para adicionar regras a um existente GrammarBuilder, use o Add, Append, AppendDictation, AppendRuleReference, e AppendWildcard métodos.

System_CAPS_importantImportante

O reconhecedor de fala pode lançar uma exceção ao usar uma gramática de reconhecimento de fala que contém elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que repetidamente podem modificar o valor do elemento mesmo semântico. Para obter mais informações sobre como criar uma gramática de reconhecimento de fala que contém informações de semânticas, consulte Using SemanticResultKey and SemanticResultValue Objects.

Para ajudar na depuração, o DebugShowPhrases propriedade retorna o status atual do GrammarBuilder como uma cadeia de caracteres.

Para obter mais informações sobre a criação e uso de gramáticas de reconhecimento de fala, consulte Speech Recognition e Creating GrammarBuilder Grammars.

O exemplo a seguir usa GrammarBuilder e Choices objetos para construir uma gramática que possa reconhecer qualquer uma das duas frases, "plano de fundo colorChoice" ou "definir o plano de fundo colorChoice".

O exemplo usa um Choices objeto para criar uma lista de valores aceitáveis para colorChoice de uma matriz de String objetos. Um Choices objeto é análogo ao one-of elemento na especificação SRGS e contém um conjunto de frases alternativos, que pode ser reconhecido quando faladas. O exemplo também usa um Choices objeto para agrupar uma matriz de dois GrammarBuilder objetos em um par de frases alternativos que possa reconhecer a gramática resultante. Alternativas palavras ou frases são um componente de gramáticas maioria e o Choices objeto fornece essa funcionalidade para gramáticas construído com GrammarBuilder.

O exemplo, por fim, cria um Grammar do objeto de um GrammarBuilder construído a partir de um 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;
}

.NET Framework
Disponível desde 3.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: