GrammarBuilder GrammarBuilder GrammarBuilder GrammarBuilder Class

정의

음성 인식 문법에 대 한 제약 조건을 프로그래밍 방식으로 작성 하는 메커니즘을 제공 합니다.Provides a mechanism for programmatically building the constraints for a speech recognition grammar.

public ref class GrammarBuilder
public class GrammarBuilder
type GrammarBuilder = class
Public Class GrammarBuilder
상속
GrammarBuilderGrammarBuilderGrammarBuilderGrammarBuilder

예제

다음 예제에서는 GrammarBuilder 하 고 Choices 두 구 중 하나를 인식할 수 있는 문법 구성 하는 개체 "배경 colorChoice" 또는 "백그라운드로 colorChoice".The following example uses GrammarBuilder and Choices objects to construct a grammar that can recognize either of the two phrases, "Make background colorChoice" or "Set background to colorChoice".

이 예제에서는 사용을 Choices 개체에 대 한 허용 가능한 값 목록을 만드는 데 colorChoice 배열에서 String 개체입니다.The example uses a Choices object to create a list of acceptable values for colorChoice from an array of String objects. A Choices 개체는 비슷합니다는 one-of SRGS 사양의 요소 말할 때 인식할 수 있는 대체 구 집합을 포함 하 고 합니다.A Choices object is analogous to the one-of element in the SRGS specification, and contains a set of alternate phrases, any of which can be recognized when spoken. 또한이 예제에서는 Choices 배열을 두 개의 그룹 개체 GrammarBuilder 결과 문법 인식할 수 있는 대체 구의 쌍 개체입니다.The example also uses a Choices object to group an array of two GrammarBuilder objects into a pair of alternative phrases that the resultant grammar can recognize. 대체 단어 또는 문구는 대부분의 문법의 구성 요소 및 Choices 문법을 사용 하 여 생성에 대 한 개체는이 기능을 제공 GrammarBuilder합니다.Alternate words or phrases are a component of most grammars, and the Choices object provides this functionality for grammars constructed with GrammarBuilder.

이 예에서는 마지막으로 만듭니다는 Grammar 에서 개체를 GrammarBuilder 에서 생성 된를 Choices 개체입니다.The example finally creates a Grammar object from a GrammarBuilder constructed from a Choices object.


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

설명

음성 인식 문법 정의 된 XML 형식에 일반적으로 작성 되는 음성 인식 문법 Specification (SRGS) 버전 1.0합니다.Speech recognition grammars are commonly authored in the XML format defined by the Speech Recognition Grammar Specification (SRGS) Version 1.0. SRGS 문법을 프로그래밍 방식으로 생성 하려는 같지만 잘 알고 있다면 사용할 수는 System.Speech.Recognition.SrgsGrammar 네임 스페이스에는 요소와 특성 SRGS 정의한 멤버가 정확 하 게 일치 합니다.If you are familiar with SRGS but want to generate the grammars programmatically, you can use the System.Speech.Recognition.SrgsGrammar namespace, whose members correspond closely to the elements and attributes defined by SRGS. SRGS, 익숙한 되지 않거나 문법은 효율적으로 수행할 수 많은 일반적인 시나리오를 작성 하는 간단 하 고 프로그래밍 방식으로 접근 방법을 사용할 경우 사용할 수는 GrammarBuilderChoices 클래스입니다.If you are unfamiliar with SRGS, or you want a lightweight, programmatic approach to authoring grammars with which you can efficiently accomplish many common scenarios; you can use the GrammarBuilder and Choices classes.

사용 하 여 GrammarBuilder 계층적 트리를 작성 하는 개체 구성 Choices 프리앰블 및 각 노드에서 후 amble 구를 사용 하 여 섞어서 및 의미를 전달 하는 값 의미 체계를 사용 하 여 시드 대체 구가 포함 된 개체를 다시는 애플리케이션입니다.Use GrammarBuilder objects to build a hierarchical tree composed of Choices objects that contain alternate phrases, interspersed with preamble and post-amble phrases at each node, and seeded with semantic values that convey meaning back to the application.

사용 하는 GrammarBuilder 만들려면를 Grammar 개체, 다음 단계를 사용 합니다.To use a GrammarBuilder to create a Grammar object, use the following steps.

  1. GrammarBuilder 개체를 만듭니다.Create a GrammarBuilder object.

  2. 제약 조건을 추가 합니다 GrammarBuilder와 같은 String 개체를 Choices, SemanticResultKey, SemanticResultValue, DictationGrammar, 및 기타 GrammarBuilder 문법에 대 한 제약 조건을 정의 하는 개체입니다.Append constraints to the GrammarBuilder, such as String objects, Choices, SemanticResultKey, SemanticResultValue, DictationGrammar, and other GrammarBuilder objects that define the constraints for the grammar.

  3. 중 하나를 사용 합니다 Grammar 만들려면 생성자를 Grammar 개체에서 완료 된 GrammarBuilder 문법입니다.Use one of the Grammar constructors to create a Grammar object from the completed GrammarBuilder grammar.

사용 하 여 작성 GrammarBuilder 는 단일 규칙이 목록 또는 목록의 목록 등을 포함 하는 문법에 가장 적합 합니다.Authoring with GrammarBuilder is best suited to grammars that have a single rule containing lists, or perhaps lists of lists. 여러 규칙이 있는 또는 내부 규칙 참조를 확인 해야 하는 문법을 프로그래밍 방식으로 빌드의 클래스를 사용 합니다 System.Speech.Recognition.SrgsGrammar 네임 스페이스입니다.To programmatically build grammars that have multiple rules, or that need to make internal rule references, use the classes of the System.Speech.Recognition.SrgsGrammar namespace.

인스턴스의 GrammarBuilder 다른 특정 클래스에서 암시적 변환 하거나 결합 하 여 가져올 수도 있습니다는 GrammarBuilder 문법에 대 한 제약 조건을 포함 하는 두 번째 개체를 사용 하 여...Instances of GrammarBuilder can also be obtained by implicit conversions from certain other classes or by combining a GrammarBuilder with a second object that contains constraints for a grammar.. 자세한 내용은 참조 하세요. 합니다 Implicit 하 고 Addition 연산자 및 Add 메서드.For more information, see the Implicit and Addition operators and the Add methods.

기존 규칙을 추가할 GrammarBuilder를 사용 합니다 Add, Append, AppendDictation, AppendRuleReference, 및 AppendWildcard 메서드.To add rules to an existing GrammarBuilder, use the Add, Append, AppendDictation, AppendRuleReference, and AppendWildcard methods.

중요

음성 인식기 키 이름이 같은 중복 된 의미 체계 요소 또는 동일한 의미 체계 요소의 값을 반복적으로 수정할 수 있는 여러 의미 체계 요소가 포함 된 음성 인식 문법을 사용 하는 경우 예외가 throw 할 수 있습니다.The speech recognizer can throw an exception when using a speech recognition grammar that contains duplicate semantic elements with the same key name or multiple semantic elements that could repeatedly modify the value of the same semantic element.

디버깅에 도움이 되는 DebugShowPhrases 속성의 현재 상태를 반환 합니다 GrammarBuilder 문자열로 합니다.To help with debugging, the DebugShowPhrases property returns the current status of the GrammarBuilder as a string.

빌드 및 음성 인식 문법을 사용 하는 방법에 대 한 자세한 내용은 참조 하세요. 음성 인식 하 고 GrammarBuilder 문법을 만드는합니다.For more information about building and using speech recognition grammars, see Speech Recognition and Creating GrammarBuilder Grammars.

생성자

GrammarBuilder() GrammarBuilder() GrammarBuilder() GrammarBuilder()

GrammarBuilder 클래스의 비어 있는 새 인스턴스를 초기화합니다.Initializes a new, empty instance of the GrammarBuilder class.

GrammarBuilder(Choices) GrammarBuilder(Choices) GrammarBuilder(Choices) GrammarBuilder(Choices)

대체 집합에서 GrammarBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the GrammarBuilder class from a set of alternatives.

GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32) GrammarBuilder(GrammarBuilder, Int32, Int32)

반복된 요소에서 GrammarBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the GrammarBuilder class from a repeated element.

GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey) GrammarBuilder(SemanticResultKey)

의미 키에서 GrammarBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the GrammarBuilder class from a semantic key.

GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue) GrammarBuilder(SemanticResultValue)

의미 값에서 GrammarBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the GrammarBuilder class from a semantic value.

GrammarBuilder(String) GrammarBuilder(String) GrammarBuilder(String) GrammarBuilder(String)

단어 시퀀스에서 GrammarBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the GrammarBuilder class from a sequence of words.

GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32) GrammarBuilder(String, Int32, Int32)

GrammarBuilder의 단어의 시퀀스에서의 String 클래스의 새 인스턴스를 초기화하며 String이 얼마나 반복될 수 있는지를 지정합니다.Initializes a new instance of the GrammarBuilder class from the sequence of words in a String and specifies how many times the String can be repeated.

GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode) GrammarBuilder(String, SubsetMatchingMode)

단어 시퀀스의 하위 집합에 대한 GrammarBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the GrammarBuilder class for a subset of a sequence of words.

속성

Culture Culture Culture Culture

음성 인식 문법의 문화권을 가져오거나 설정합니다.Gets or sets the culture of the speech recognition grammar.

DebugShowPhrases DebugShowPhrases DebugShowPhrases DebugShowPhrases

GrammarBuilder가 포함하는 문법의 콘텐츠와 구조를 보여주는 문자열을 가져옵니다.Gets a string that shows the contents and structure of the grammar contained by the GrammarBuilder.

메서드

Add(Choices, GrammarBuilder) Add(Choices, GrammarBuilder) Add(Choices, GrammarBuilder) Add(Choices, GrammarBuilder)

Choices 개체와 GrammarBuilder 개체를 차례로 포함하는 새 GrammarBuilder를 만듭니다.Creates a new GrammarBuilder that contains a Choices object followed by a GrammarBuilder object.

Add(GrammarBuilder, Choices) Add(GrammarBuilder, Choices) Add(GrammarBuilder, Choices) Add(GrammarBuilder, Choices)

GrammarBuilder 개체와 Choices 개체를 차례로 포함하는 새 GrammarBuilder를 만듭니다.Creates a new GrammarBuilder that contains a GrammarBuilder object followed by a Choices object.

Add(GrammarBuilder, GrammarBuilder) Add(GrammarBuilder, GrammarBuilder) Add(GrammarBuilder, GrammarBuilder) Add(GrammarBuilder, GrammarBuilder)

GrammarBuilder 개체의 시퀀스를 포함하는 새 GrammarBuilder를 만듭니다.Creates a new GrammarBuilder that contains a sequence of two GrammarBuilder objects.

Add(GrammarBuilder, String) Add(GrammarBuilder, String) Add(GrammarBuilder, String) Add(GrammarBuilder, String)

GrammarBuilder 개체와 그 뒤에 구를 포함하는 새 GrammarBuilder를 만듭니다.Creates a new GrammarBuilder that contains a GrammarBuilder object followed by a phrase.

Add(String, GrammarBuilder) Add(String, GrammarBuilder) Add(String, GrammarBuilder) Add(String, GrammarBuilder)

구와 그 뒤에 GrammarBuilder 개체를 포함하는 새 GrammarBuilder를 만듭니다.Creates a new GrammarBuilder that contains a phrase followed by a GrammarBuilder object.

Append(Choices) Append(Choices) Append(Choices) Append(Choices)

대체 항목의 집합을 문법 요소의 현재 시퀀스에 추가합니다.Appends a set of alternatives to the current sequence of grammar elements.

Append(GrammarBuilder) Append(GrammarBuilder) Append(GrammarBuilder) Append(GrammarBuilder)

문법 요소를 문법 요소의 현재 시퀀스에 추가합니다.Appends a grammar element to the current sequence of grammar elements.

Append(GrammarBuilder, Int32, Int32) Append(GrammarBuilder, Int32, Int32) Append(GrammarBuilder, Int32, Int32) Append(GrammarBuilder, Int32, Int32)

반복된 문법 요소를 문법 요소의 현재 시퀀스에 추가합니다.Appends a repeated grammar element to the current sequence of grammar elements.

Append(SemanticResultKey) Append(SemanticResultKey) Append(SemanticResultKey) Append(SemanticResultKey)

의미 키를 문법 요소의 현재 시퀀스에 추가합니다.Appends a semantic key to the current sequence of grammar elements.

Append(SemanticResultValue) Append(SemanticResultValue) Append(SemanticResultValue) Append(SemanticResultValue)

의미 값을 문법 요소의 현재 시퀀스에 추가합니다.Appends a semantic value to the current sequence of grammar elements.

Append(String) Append(String) Append(String) Append(String)

구를 문법 요소의 현재 시퀀스에 추가합니다.Appends a phrase to the current sequence of grammar elements.

Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32) Append(String, Int32, Int32)

반복된 구를 문법 요소의 현재 시퀀스에 추가합니다.Appends a repeated phrase to the current sequence of grammar elements.

Append(String, SubsetMatchingMode) Append(String, SubsetMatchingMode) Append(String, SubsetMatchingMode) Append(String, SubsetMatchingMode)

구의 하위 집합에 대한 요소를 문법 요소의 현재 시퀀스에 추가합니다.Appends an element for a subset of a phrase to the current sequence of grammar elements.

AppendDictation() AppendDictation() AppendDictation() AppendDictation()

기본 받아쓰기 문법을 문법 요소의 현재 시퀀스에 추가합니다.Appends the default dictation grammar to the current sequence of grammar elements.

AppendDictation(String) AppendDictation(String) AppendDictation(String) AppendDictation(String)

지정된 받아쓰기 문법을 문법 요소의 현재 시퀀스에 추가합니다.Appends the specified dictation grammar to the current sequence of grammar elements.

AppendRuleReference(String) AppendRuleReference(String) AppendRuleReference(String) AppendRuleReference(String)

문법 정의 파일을 문법 요소의 현재 시퀀스에 추가합니다.Appends a grammar definition file to the current sequence of grammar elements.

AppendRuleReference(String, String) AppendRuleReference(String, String) AppendRuleReference(String, String) AppendRuleReference(String, String)

문법 정의 파일의 지정된 규칙을 문법 요소의 현재 시퀀스에 추가합니다.Appends the specified rule of a grammar definition file to the current sequence of grammar elements.

AppendWildcard() AppendWildcard() AppendWildcard() AppendWildcard()

입력과 일치하는 인식 문법 요소를 문법 요소의 현재 시퀀스에 추가합니다.Appends a recognition grammar element that matches any input to the current sequence of grammar elements.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

연산자

Addition(Choices, GrammarBuilder) Addition(Choices, GrammarBuilder) Addition(Choices, GrammarBuilder) Addition(Choices, GrammarBuilder)

Choices 개체와 GrammarBuilder 개체를 차례로 포함하는 새 GrammarBuilder를 만듭니다.Creates a new GrammarBuilder that contains a Choices object followed by a GrammarBuilder object.

Addition(GrammarBuilder, Choices) Addition(GrammarBuilder, Choices) Addition(GrammarBuilder, Choices) Addition(GrammarBuilder, Choices)

GrammarBuilder와 그 뒤에 GrammarBuilder를 포함하는 새 Choices를 만듭니다.Creates a new GrammarBuilder that contains a GrammarBuilder followed by a Choices.

Addition(GrammarBuilder, GrammarBuilder) Addition(GrammarBuilder, GrammarBuilder) Addition(GrammarBuilder, GrammarBuilder) Addition(GrammarBuilder, GrammarBuilder)

GrammarBuilder 개체의 시퀀스를 포함하는 새 GrammarBuilder를 만듭니다.Creates a new GrammarBuilder that contains a sequence of two GrammarBuilder objects.

Addition(GrammarBuilder, String) Addition(GrammarBuilder, String) Addition(GrammarBuilder, String) Addition(GrammarBuilder, String)

GrammarBuilder와 그 뒤에 구를 포함하는 새 GrammarBuilder를 만듭니다.Creates a new GrammarBuilder that contains a GrammarBuilder followed by a phrase.

Addition(String, GrammarBuilder) Addition(String, GrammarBuilder) Addition(String, GrammarBuilder) Addition(String, GrammarBuilder)

구와 그 뒤에 GrammarBuilder를 포함하는 새 GrammarBuilder를 만듭니다.Creates a new GrammarBuilder that contains a phrase followed by a GrammarBuilder.

Implicit(Choices to GrammarBuilder) Implicit(Choices to GrammarBuilder) Implicit(Choices to GrammarBuilder) Implicit(Choices to GrammarBuilder)

Choices 개체를 GrammarBuilder 개체로 변환합니다.Converts a Choices object to a GrammarBuilder object.

Implicit(SemanticResultKey to GrammarBuilder) Implicit(SemanticResultKey to GrammarBuilder) Implicit(SemanticResultKey to GrammarBuilder) Implicit(SemanticResultKey to GrammarBuilder)

SemanticResultKey 개체를 GrammarBuilder 개체로 변환합니다.Converts a SemanticResultKey object to a GrammarBuilder object.

Implicit(SemanticResultValue to GrammarBuilder) Implicit(SemanticResultValue to GrammarBuilder) Implicit(SemanticResultValue to GrammarBuilder) Implicit(SemanticResultValue to GrammarBuilder)

SemanticResultValue 개체를 GrammarBuilder 개체로 변환합니다.Converts a SemanticResultValue object to a GrammarBuilder object.

Implicit(String to GrammarBuilder) Implicit(String to GrammarBuilder) Implicit(String to GrammarBuilder) Implicit(String to GrammarBuilder)

문자열을 GrammarBuilder 개체로 변환합니다.Converts a string to a GrammarBuilder object.

적용 대상

추가 정보