Choices Constructors

Definitie

Naamruimte:
System.Speech.Recognition
Assembly:
System.Speech.dll

Initialiseert een nieuw exemplaar van de Choices klasse.

Overloads

Name Description
Choices()

Initialiseert een nieuw exemplaar van de Choices klasse die een lege set alternatieven bevat.
Choices(GrammarBuilder[])

Initialiseert een nieuw exemplaar van de Choices klasse van een matrix die een of meer GrammarBuilder objecten bevat.
Choices(String[])

Initialiseert een nieuw exemplaar van de Choices klasse van een matrix die een of meer String objecten bevat.

Voorbeelden

In het volgende voorbeeld worden objecten gebruikt Choices om twee lijsten met alternatieven te maken.

Het eerste Choices object wordt samengesteld op basis van een matrix met String objecten. Het andere Choices object is samengesteld uit een matrix met GrammarBuilder objecten die impliciet zijn geconverteerd door een cast.

In het voorbeeld wordt een GrammarBuilder object gebruikt om een woordgroep samen te stellen, met behulp van de Choices objecten en twee extra tekenreeksen, die kunnen worden gebruikt om spraakinvoer te herkennen in de vorm van "Call [contactlList] on [phoneType] phone", bijvoorbeeld "Call Jane on cell phone".

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

Opmerkingen

U kunt een Choices object maken met behulp van een parameterloze constructor (die een leeg object retourneert), van een groep String objecten of van een set GrammarBuilder objecten.

Omdat het GrammarBuilder object impliciete conversie van SemanticResultValue en SemanticResultKeyondersteunt, kan een Choices worden samengesteld uit een matrix van deze objecten met behulp van een cast.

Choices()

Initialiseert een nieuw exemplaar van de Choices klasse die een lege set alternatieven bevat.

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

Voorbeelden

In het volgende voorbeeld worden Choices en GrammarBuilder objecten gebruikt om een woordgroep te maken die kan worden gebruikt om spraakinvoer te herkennen, zoals 'Bel Anne op haar cel' en 'Bel James op zijn werktelefoon'. In het voorbeeld worden impliciete casts van Choices en String naar GrammarBuildergebruikt.

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

Opmerkingen

Deze constructor retourneert een geldige, lege set alternatieven. U kunt alternatieven toevoegen met behulp van een van de Add methoden.

Zie ook

Van toepassing op

Choices(GrammarBuilder[])

Initialiseert een nieuw exemplaar van de Choices klasse van een matrix die een of meer GrammarBuilder objecten bevat.

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

Parameters

alternateChoices
GrammarBuilder[]

Een matrix met de set alternatieven.

Voorbeelden

In het volgende voorbeeld worden Choices en objecten gebruikt om GrammarBuilder een Grammar for-woordgroep te maken, zoals 'Call Anne on her cell' en 'Call James on his work phone'. In het voorbeeld worden impliciete casts van Choices en String naar GrammarBuildergebruikt.

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

Opmerkingen

Elk GrammarBuilder in alternateChoices definieert één alternatief. Als alternateChoices dit een lege matrix is, retourneert de constructor een lege set alternatieven. U kunt alternatieven toevoegen met behulp van een van de Add methoden.

De constructor genereert een ArgumentNullException wanneer alternateChoices of null wanneer een van de matrixelementen is null.

Omdat de GrammarBuilder klasse ondersteuning biedt voor impliciete conversie van Choices, SemanticResultValueen SemanticResultKey objecten naar GrammarBuilder exemplaren, kan deze constructor ook worden gebruikt om een Choices object te maken op basis van een lijst met elke combinatie van deze objecten.

Zie ook

Van toepassing op

Choices(String[])

Initialiseert een nieuw exemplaar van de Choices klasse van een matrix die een of meer String objecten bevat.

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

Parameters

phrases
String[]

Een matrix met de set alternatieven.

Voorbeelden

In het volgende voorbeeld worden Choices en objecten gebruikt om GrammarBuilder een Grammar voor de woordgroepen te maken, zoals 'Call Anne on her cell' en 'Call James on his work phone'. In het voorbeeld worden impliciete casts van Choices en String naar GrammarBuildergebruikt.

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

Opmerkingen

Elk String in phrases definieert één alternatief. De spraakherkenningsengine kan elk van de items in de tekenreeksmatrix gebruiken om de spraakinvoer te vinden. Als phrases dit een lege matrix is, retourneert de constructor een lege set alternatieven. U kunt alternatieven toevoegen met behulp van een van de Add methoden.

De constructor genereert een ArgumentNullException wanneer phrases of null een van de matrixelementen.null De constructor genereert een ArgumentException als een element in de matrix een lege tekenreeks ("").

Zie ook

Van toepassing op