Choices コンストラクター

定義

名前空間:

System.Speech.Recognition

アセンブリ:

System.Speech.dll

パッケージ:

System.Speech v9.0.0-rc.2.24473.5

Choices クラスの新しいインスタンスを初期化します。

オーバーロード

Choices()	空の代替セットを含む、Choices クラスの新しいインスタンスを初期化します。
Choices(GrammarBuilder[])	1 つ以上の Choices オブジェクトを含む配列から GrammarBuilder クラスの新しいインスタンスを初期化します。
Choices(String[])	1 つ以上の Choices オブジェクトを含む配列から String クラスの新しいインスタンスを初期化します。

例

次の例では、 オブジェクトを使用 Choices して、代替の 2 つのリストを作成します。

最初 Choices のオブジェクトは、 オブジェクトの String 配列から構築されます。 もう 1 つの Choices オブジェクトは、キャストによって暗黙的に変換された オブジェクトの GrammarBuilder 配列から構築されます。

この例では、 オブジェクトを GrammarBuilder 使用して、オブジェクトと 2 つの追加の文字列を使用して Choices フレーズをアセンブルします。この文字列を使用すると、"Call [contactlList] on [phoneType] phone" (携帯電話の Call Jane など) の形式で音声入力を認識できます。

public GrammarBuilder ChoicesConstructor2 ()  
{  
    GrammarBuilder gb = new GrammarBuilder ();  
    Choices phoneType = new Choices (new string[] {"cell", "home", "work"});  
    Choices contactList = new Choices (new GrammarBuilder[] {(GrammarBuilder) "Mark", (GrammarBuilder) "Jane", (GrammarBuilder) "Frank"});  
    gb.Append ("Call");  
    gb.Append (contactList);  
    gb.Append ("on");  
    gb.Append (phoneType);  
    gb.Append ("phone");  
    return gb;  
}  

注釈

オブジェクトはChoices、パラメーターなしのコンストラクター (空のオブジェクトを返します)、オブジェクトのグループ、またはオブジェクトのStringGrammarBuilderセットの を使用して構築できます。

オブジェクトは GrammarBuilder および SemanticResultKeyChoices からのSemanticResultValue暗黙的な変換をサポートしているため、 キャストを使用して、これらのオブジェクトの配列から を構築できます。

Choices()

ソース:

Choices.cs

空の代替セットを含む、Choices クラスの新しいインスタンスを初期化します。

public:
 Choices();

public Choices ();

Public Sub New ()

例

次の例では、 オブジェクトと GrammarBuilder オブジェクトを使用Choicesして、"Call Anne on her cell" や "Call James on his work phone" などの音声入力を認識するために使用できるフレーズを作成します。 この例では、 と String から Choices への暗黙的なキャストを使用しますGrammarBuilder。

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 追加できます。

こちらもご覧ください

• Grammar
• GrammarBuilder

Choices(GrammarBuilder[])

ソース:

Choices.cs

1 つ以上の Choices オブジェクトを含む配列から GrammarBuilder クラスの新しいインスタンスを初期化します。

public:
 Choices(... cli::array <System::Speech::Recognition::GrammarBuilder ^> ^ alternateChoices);

public Choices (params System.Speech.Recognition.GrammarBuilder[] alternateChoices);

new System.Speech.Recognition.Choices : System.Speech.Recognition.GrammarBuilder[] -> System.Speech.Recognition.Choices

Public Sub New (ParamArray alternateChoices As GrammarBuilder())

パラメーター

alternateChoices

GrammarBuilder[]

代替のセットを格納する配列。

例

次の例では、 オブジェクトと GrammarBuilder オブジェクトを使用Choicesして、"自分のセルにアンヌを呼び出す" や "勤務先の電話で James を呼び出す" などの語句の を作成Grammarします。 この例では、 と String から Choices への暗黙的なキャストを使用しますGrammarBuilder。

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

注釈

のそれぞれ GrammarBuilder で alternateChoices 、1 つの代替方法が定義されています。 が空の配列の場合 alternateChoices 、コンストラクターは空の代替セットを返します。 任意のメソッドを使用して代替手段を Add 追加できます。

コンストラクターは、 ArgumentNullException が の場合alternateChoices、または配列要素nullのいずれかが の場合に null をスローします。

クラスは、キャストをGrammarBuilder適切に使用して、、SemanticResultValue、および SemanticResultKey オブジェクトからChoicesインスタンスへのGrammarBuilder暗黙的な変換をサポートするため、このコンストラクターを使用して、これらのオブジェクトの任意の組み合わせのリストからオブジェクトを作成Choicesすることもできます。

こちらもご覧ください

• Grammar
• GrammarBuilder

Choices(String[])

ソース:

Choices.cs

1 つ以上の Choices オブジェクトを含む配列から String クラスの新しいインスタンスを初期化します。

public:
 Choices(... cli::array <System::String ^> ^ phrases);

public Choices (params string[] phrases);

new System.Speech.Recognition.Choices : string[] -> System.Speech.Recognition.Choices

Public Sub New (ParamArray phrases As String())

パラメーター

phrases

String[]

代替のセットを格納する配列。

例

次の例では、 オブジェクトと GrammarBuilder オブジェクトを使用Choicesして、"Call Anne on her cell" や "Call James on his work phone" などの語句の を作成Grammarします。 この例では、 と String から Choices への暗黙的なキャストを使用しますGrammarBuilder。

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

注釈

のそれぞれ String で phrases 、1 つの代替方法が定義されています。 音声認識エンジンは、文字列配列内の任意の項目を使用して、音声入力と一致させることができます。 が空の配列の場合 phrases 、コンストラクターは空の代替セットを返します。 任意のメソッドを使用して代替手段を Add 追加できます。

コンストラクターは、 ArgumentNullException が null の場合、または配列要素のいずれかが であるnull場合phrasesに をスローします。 配列内の ArgumentException 要素が空の文字列 ("") の場合、コンストラクターは をスローします。

こちらもご覧ください

• Grammar
• GrammarBuilder