다음을 통해 공유


Choices.Add 메서드

정의

대체 집합에 항목을 추가합니다.

오버로드

Add(GrammarBuilder[])

하나 이상의 GrammarBuilder 개체를 포함하는 배열을 대체 집합에 추가합니다.

Add(String[])

하나 이상의 String 개체를 포함하는 배열을 대체 집합에 추가합니다.

Add(GrammarBuilder[])

하나 이상의 GrammarBuilder 개체를 포함하는 배열을 대체 집합에 추가합니다.

public:
 void Add(... cli::array <System::Speech::Recognition::GrammarBuilder ^> ^ alternateChoices);
public void Add (params System.Speech.Recognition.GrammarBuilder[] alternateChoices);
member this.Add : System.Speech.Recognition.GrammarBuilder[] -> unit
Public Sub Add (ParamArray alternateChoices As GrammarBuilder())

매개 변수

alternateChoices
GrammarBuilder[]

GrammarBuilder 개체에 추가할 Choices 개체입니다.

예제

다음 예제에서는 "휴대폰에서 앤에게 전화", "회사 전화로 James에게 전화"와 같은 구문에 대한 음성 인식 문법을 만듭니다. 이 예제에서는 메서드의 Add 오버로드를 모두 사용하여 문법을 작성합니다.

public Grammar CreatePhonePhrase()  
{  

  // Create alternatives for female names and add a phrase.  
  GrammarBuilder females = new Choices(new string[] { "Anne", "Mary" });  
  females.Append("on her");  

  // Create alternatives for male names and add a phrase.  
  GrammarBuilder males = new Choices(new string[] { "James", "Sam" });  
  males.Append("on his");  

  // Create a Choices object that contains an array of alternative  
  // GrammarBuilder objects.  
  Choices people = new Choices();  
  people.Add(new Choices(new GrammarBuilder[] {females, males}));  

  // Create a Choices object that contains a set of alternative phone types.  
  Choices phoneType = new Choices();  
  phoneType.Add(new string[] { "cell", "home", "work" });  

  // Construct the phrase.  
  GrammarBuilder gb = new GrammarBuilder();  
  gb.Append("call");  
  gb.Append(people);  
  gb.Append(phoneType);  
  gb.Append(new GrammarBuilder("phone"), 0, 1);  

  return new Grammar(gb);  
}  

설명

및 개체에서 ChoicesSemanticResultKeySemanticResultValue 개체로의 암시적 변환에 GrammarBuilder대한 지원으로 인해 이러한 세 클래스도 인스턴스에 Choices 추가될 수 있습니다.

빈 배열인 경우 alternateChoices 이 메서드는 대체 항목 집합을 업데이트하지 않습니다.

애플리케이션 모두를 사용할 수 있습니다 Add(String[]) 하 고 Add(GrammarBuilder[]) 에 대 한 대안을 추가 하는 Choices 개체입니다.

이 메서드는 배열 요소가 있는 ArgumentNullException 경우 null alternateChoices 또는 임의의 경우를 throw합니다null.

추가 정보

적용 대상

Add(String[])

하나 이상의 String 개체를 포함하는 배열을 대체 집합에 추가합니다.

public:
 void Add(... cli::array <System::String ^> ^ phrases);
public void Add (params string[] phrases);
member this.Add : string[] -> unit
Public Sub Add (ParamArray phrases As String())

매개 변수

phrases
String[]

Choices 개체에 추가할 문자열입니다.

예제

다음 예제에서는 "휴대폰에서 앤에게 전화" 및 "회사 전화로 James에게 전화"와 유사한 구에 대한 음성 인식 문법을 만듭니다. 이 예제에서는 메서드의 Add 오버로드를 모두 사용하여 문법을 작성합니다.

public Grammar CreatePhonePhrase()  
{  

  // Create alternatives for female names and add a phrase.  
  GrammarBuilder females = new Choices(new string[] { "Anne", "Mary" });  
  females.Append("on her");  

  // Create alternatives for male names and add a phrase.  
  GrammarBuilder males = new Choices(new string[] { "James", "Sam" });  
  males.Append("on his");  

  // Create a Choices object that contains an array of alternative  
  // GrammarBuilder objects.  
  Choices people = new Choices();  
  people.Add(new Choices(new GrammarBuilder[] {females, males}));  

  // Create a Choices object that contains a set of alternative phone types.  
  Choices phoneType = new Choices();  
  phoneType.Add(new string[] { "cell", "home", "work" });  

  // Construct the phrase.  
  GrammarBuilder gb = new GrammarBuilder();  
  gb.Append("call");  
  gb.Append(people);  
  gb.Append(phoneType);  
  gb.Append(new GrammarBuilder("phone"), 0, 1);  

  return new Grammar(gb);  
}  

설명

애플리케이션 모두를 사용할 수 있습니다 Add(String[]) 하 고 Add(GrammarBuilder[]) 에 대 한 대안을 추가 하는 Choices 개체입니다.

빈 배열인 경우 phrases 이 메서드는 대체 집합을 업데이트하지 않습니다.

이 메서드는 배열 요소가 있는 ArgumentNullException 경우 null phrases 또는 임의의 경우를 throw합니다null. 이 메서드는 배열의 ArgumentException 요소가 빈 문자열("")인 경우 throw합니다.

추가 정보

적용 대상