Choices Konstruktory

Definice

Obor názvů:

System.Speech.Recognition

Sestavení:

System.Speech.dll

Balíček:

System.Speech v9.0.0-rc.2.24473.5

Inicializuje novou instanci Choices třídy .

Přetížení

Choices()	Inicializuje novou instanci Choices třídy, která obsahuje prázdnou sadu alternativ.
Choices(GrammarBuilder[])	Inicializuje novou instanci Choices třídy z pole obsahujícího jeden nebo více GrammarBuilder objektů.
Choices(String[])	Inicializuje novou instanci Choices třídy z pole obsahujícího jeden nebo více String objektů.

Příklady

Následující příklad používá Choices objekty k vytvoření dvou seznamů alternativ.

První Choices objekt je vytvořen z pole String objektů. Druhý Choices objekt je vytvořen z pole GrammarBuilder objektů, které byly implicitně převedeny přetypováním.

Příklad používá GrammarBuilder objekt k sestavení fráze pomocí Choices objektů a dvou dalších řetězců, které lze použít k rozpoznávání hlasového vstupu ve formě "Call [contactlList] on [phoneType] phone", například "Call Jane on mobile".

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

Poznámky

Můžete vytvořit Choices objekt pomocí konstruktoru bez parametrů (který vrací prázdný objekt), ze skupiny String objektů nebo ze sady GrammarBuilder objektů.

Vzhledem k tomu, že GrammarBuilder objekt podporuje implicitní převod z SemanticResultValue objektů a SemanticResultKey, Choices lze vytvořit z pole těchto objektů pomocí přetypování.

Choices()

Inicializuje novou instanci Choices třídy, která obsahuje prázdnou sadu alternativ.

public:
 Choices();

public Choices ();

Public Sub New ()

Příklady

Následující příklad používá Choices objekty a GrammarBuilder k vytvoření fráze, která se dá použít k rozpoznávání vstupu řeči, například "Call Anne on her cell" (Call Anne on her cell) a "Call James on his work phone" (Call James on his work phone). Příklad používá implicitní přetypování z Choices a String na 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);  
}  

Poznámky

Tento konstruktor vrátí platnou, prázdnou sadu alternativ. Alternativy můžete přidat pomocí libovolné z těchto Add metod.

Viz také

• Grammar
• GrammarBuilder

Choices(GrammarBuilder[])

Inicializuje novou instanci Choices třídy z pole obsahujícího jeden nebo více GrammarBuilder objektů.

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[]

Pole obsahující sadu alternativ.

Příklady

Následující příklad používá Choices objekty a GrammarBuilder k vytvoření Grammar výrazů pro například "Call Anne on her cell" (Zavolat Anně do její buňky) a "Call James on his work phone" (Call James on his work phone). Příklad používá implicitní přetypování z Choices a String na 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);  
}  

Poznámky

Každý GrammarBuilder v alternateChoices definuje jednu alternativu. Pokud alternateChoices je pole prázdné, vrátí konstruktor prázdnou sadu alternativ. Alternativy můžete přidat pomocí libovolné z těchto Add metod.

Konstruktor vyvolá, ArgumentNullException když alternateChoices je null nebo když některý z prvků pole je null.

Vzhledem k tomu, že GrammarBuilder třída poskytuje podporu pro implicitní převod Choicesobjektů , SemanticResultValuea SemanticResultKey na GrammarBuilder instance, pomocí správného použití přetypování, lze tento konstruktor použít také k vytvoření Choices objektu ze seznamu jakékoli kombinace těchto objektů.

Viz také

• Grammar
• GrammarBuilder

Choices(String[])

Inicializuje novou instanci Choices třídy z pole obsahujícího jeden nebo více String objektů.

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[]

Pole obsahující sadu alternativ.

Příklady

Následující příklad používá Choices objekty a GrammarBuilder k vytvoření Grammar výrazu pro fráze, například "Call Anne on her cell" (Call Anne on her cell) a "Call James on his work phone" (ZavolejTe Janě na jeho pracovní telefon). Příklad používá implicitní přetypování z Choices a String na 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);  
}  

Poznámky

Každý String v phrases definuje jednu alternativu. Modul rozpoznávání řeči může použít libovolnou položku v poli řetězců, aby odpovídala hlasovému vstupu. Pokud phrases je pole prázdné, vrátí konstruktor prázdnou sadu alternativ. Alternativy můžete přidat pomocí libovolné z těchto Add metod.

Konstruktor vyvolá, ArgumentNullException když phrases je null nebo některý z prvků pole je null. Konstruktor vyvolá, ArgumentException pokud je libovolný prvek v poli prázdný řetězec ("").

Viz také

• Grammar
• GrammarBuilder