Choices 類別

定義

命名空間:

System.Speech.Recognition

組件:

System.Speech.dll

套件:

System.Speech v9.0.0-rc.2.24473.5

來源:

Choices.cs

表示語音辨識文法條件約束中的一組替代項。

public ref class Choices

public class Choices

type Choices = class

Public Class Choices

繼承

Object

Choices

範例

下列範例會為片語「將背景設定為 colorChoice」建立語音辨識文法，其中 colorChoice 可以是其中一個定義的色彩。 GrammarBuilder用來定義文法的條件約束。

private Grammar CreateColorGrammar()  
{  

  // Create a Choices object that contains a set of alternative colors.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  colorChoice.Add(new string[] {"cyan", "yellow", "magenta"});  

  // Construct the phrase.  
  GrammarBuilder builder = new GrammarBuilder("Set background to");  
  builder.Append(colorChoice);  

  // Create a grammar for the phrase.  
  Grammar colorGrammar = new Grammar(builder);  
  colorGrammar.Name = "SetBackground";  

  return colorGrammar;  
}  

備註

Choices物件代表詞組的元件，該詞組可以有數個值之一。 從 GrammarBuilder 物件建立語音辨識文法時，請使用這個類別。

例如， Choices 物件可以代表詞組中的元件 colorChoice 「將色彩變更為 colorChoice」，其中 colorChoice 的可接受值為 “red”，或 “green” 或 “blue”。

注意

若要在 Choices 片語中使用物件做為選擇性元件，請建立 Choices 物件，並將它分別新增至 GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) 物件， minRepeat 並將 maxRepeat 它分別設定為0和1。 可以辨識包含選擇性元件的詞組，無論是否說出選擇性元件。

類別Choices與one-of語音辨識文法規格所定義的 XML 元素相同， (SRGS) 1.0 版，類似於 SrgsOneOf 命名空間中的 System.Speech.Recognition.SrgsGrammar 類別。

如需定義語音辨識文法的詳細資訊，請參閱 語音辨識。

建構函式

Choices()	初始化包含空的替代項目集合之 Choices 類別的新執行個體。
Choices(GrammarBuilder[])	從包含一或多個 Choices 物件的陣列，初始化 GrammarBuilder 類別的新執行個體。
Choices(String[])	從包含一或多個 Choices 物件的陣列，初始化 String 類別的新執行個體。

方法

Add(GrammarBuilder[])	將陣列（其中包含一或多個GrammarBuilder物件）加入至選項組合。
Add(String[])	將陣列（其中包含一或多個String物件）加入至選項組合。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToGrammarBuilder()	從這個 GrammarBuilder 物件傳回 Choices 物件。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• Grammar
• GrammarBuilder
• 語音識別文法規格 (SRGS)