Udostępnij za pośrednictwem


Choices Konstruktory

Definicja

Inicjuje nowe wystąpienie klasy Choices.

Przeciążenia

Choices()

Inicjuje Choices nowe wystąpienie klasy, które zawiera pusty zestaw alternatyw.

Choices(GrammarBuilder[])

Inicjuje Choices nowe wystąpienie klasy z tablicy zawierającej co najmniej jeden GrammarBuilder obiekt.

Choices(String[])

Inicjuje Choices nowe wystąpienie klasy z tablicy zawierającej co najmniej jeden String obiekt.

Przykłady

W poniższym przykładzie użyto Choices obiektów do utworzenia dwóch list alternatyw.

Pierwszy Choices obiekt jest konstruowany z tablicy String obiektów. Drugi Choices obiekt jest konstruowany z tablicy GrammarBuilder obiektów, które zostały niejawnie przekonwertowane przez rzutowanie.

W tym przykładzie użyto GrammarBuilder obiektu do złożenia frazy przy użyciu Choices obiektów i dwóch dodatkowych ciągów, które mogą służyć do rozpoznawania danych wejściowych mowy w postaci "Call [contactlList] on [phoneType] phone" (Zadzwoń do użytkownika [contactlList] w telefonie komórkowym), na przykład "Zadzwoń do Jane na telefon komórkowy".

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

Uwagi

Obiekt można skonstruować Choices przy użyciu konstruktora bez parametrów (który zwraca pusty obiekt), z grupy String obiektów lub z zestawu GrammarBuilder obiektów.

GrammarBuilder Ponieważ obiekt obsługuje niejawną konwersję z SemanticResultValue i SemanticResultKey, Choices można utworzyć z tablicy tych obiektów przy użyciu rzutowania.

Choices()

Inicjuje Choices nowe wystąpienie klasy, które zawiera pusty zestaw alternatyw.

public:
 Choices();
public Choices ();
Public Sub New ()

Przykłady

W poniższym przykładzie użyto Choices obiektów i GrammarBuilder do utworzenia frazy, która może służyć do rozpoznawania danych wejściowych mowy, takich jak "Call Anne on her cell" i "Call James on his work phone" (Zadzwoń do Jamesa na telefon służbowy). W przykładzie użyto niejawnych rzutów z Choices i String do 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);  
}  

Uwagi

Ten konstruktor zwraca prawidłowy, pusty zestaw alternatyw. Alternatywy można dodać przy użyciu dowolnej z Add metod.

Zobacz też

Dotyczy

Choices(GrammarBuilder[])

Inicjuje Choices nowe wystąpienie klasy z tablicy zawierającej co najmniej jeden GrammarBuilder obiekt.

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())

Parametry

alternateChoices
GrammarBuilder[]

Tablica zawierająca zestaw alternatyw.

Przykłady

W poniższym przykładzie użyto Choices obiektów i GrammarBuilder , aby utworzyć Grammar frazy, takie jak "Call Anne on her cell" (Zadzwoń do Anny w jej komórce) i "Call James on his work phone" (Zadzwoń do Jamesa na telefon służbowy). W przykładzie użyto niejawnych rzutów z Choices i String do 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);  
}  

Uwagi

Każdy GrammarBuilder element w alternateChoices definiuje jedną alternatywę. Jeśli alternateChoices jest pustą tablicą, konstruktor zwraca pusty zestaw alternatyw. Alternatywy można dodać przy użyciu dowolnej z Add metod.

Konstruktor zgłasza ArgumentNullException wartość , gdy alternateChoices element ma wartość null lub gdy dowolny z elementów tablicy to null.

GrammarBuilder Ponieważ klasa zapewnia obsługę niejawnej konwersji Choicesobiektów , SemanticResultValuei SemanticResultKey na GrammarBuilder wystąpienia, przy użyciu rzutów, ten konstruktor może również służyć do tworzenia Choices obiektu z listy dowolnej kombinacji tych obiektów.

Zobacz też

Dotyczy

Choices(String[])

Inicjuje Choices nowe wystąpienie klasy z tablicy zawierającej co najmniej jeden String obiekt.

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())

Parametry

phrases
String[]

Tablica zawierająca zestaw alternatyw.

Przykłady

W poniższym przykładzie użyto Choices obiektów i GrammarBuilder , aby utworzyć Grammar element dla fraz, takich jak "Call Anne on her cell" (Zadzwoń do Anny w jej komórce) i "Zadzwoń do Jamesa na telefon służbowy". W przykładzie użyto niejawnych rzutów z Choices i String do 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);  
}  

Uwagi

Każdy String element w phrases definiuje jedną alternatywę. Aparat rozpoznawania mowy może używać dowolnego elementu w tablicy ciągów, aby dopasować dane wejściowe mowy. Jeśli phrases jest pustą tablicą, konstruktor zwraca pusty zestaw alternatyw. Alternatywy można dodać przy użyciu dowolnej z Add metod.

Konstruktor zgłasza wartość ArgumentNullException , gdy phrases element jest null lub którykolwiek z elementów tablicy to null. Konstruktor zgłasza, ArgumentException czy dowolny element w tablicy jest pustym ciągiem ("").

Zobacz też

Dotyczy