SemanticResultValue Constructeurs

Référence

Définition

Espace de noms:: System.Speech.Recognition

Assembly:: System.Speech.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la classe SemanticResultValue.

Surcharges

SemanticResultValue(Object)	Initialise une nouvelle instance de la classe SemanticResultValue et spécifie une valeur sémantique.
SemanticResultValue(GrammarBuilder, Object)	Initialise une nouvelle instance de la classe SemanticResultValue et associe une valeur sémantique à un objet GrammarBuilder.
SemanticResultValue(String, Object)	Initialise une nouvelle instance de la classe SemanticResultValue et associe une valeur sémantique à un objet String.

Remarques

Les SemanticResultValue constructeurs prennent en charge la spécification d’une Object instance avec un type de données sous-jacent bool ,, int float ou string .

Un constructeur peut créer une SemanticResultValue instance dans l’une ou l’autre des deux circonstances suivantes :

L' SemanticResultValue instance doit être associée explicitement à un élément de grammaire lors de l’utilisation GrammarBuilder d’un pour construire un Grammar .
SemanticResultValueEst déjà associé à une expression de valeur de chaîne ou à un GrammarBuilder objet.

SemanticResultValue(Object)

Initialise une nouvelle instance de la classe SemanticResultValue et spécifie une valeur sémantique.

public:
 SemanticResultValue(System::Object ^ value);

public SemanticResultValue (object value);

new System.Speech.Recognition.SemanticResultValue : obj -> System.Speech.Recognition.SemanticResultValue

Public Sub New (value As Object)

Paramètres

value: Object

Valeur managée par SemanticResultValue. Doit être de type bool, int, float ou string.

Exemples

L’exemple suivant retourne un Grammar qui reconnaît la commande «Set/change/ALTER Foreground/background... [liste des couleurs]». SemanticResultValue les SemanticResultKey instances et (conjointement avec Choices les GrammarBuilder objets et) sont utilisées pour définir la sémantique qui peut être analysée lors de la reconnaissance. La sémantique analysée détermine la couleur qui a été demandée et si le premier plan ou l’arrière-plan doit être modifié.

private Grammar FgBgColorGrammar()   
{  
  Grammar grammar = null;  

  // Allow the command to begin with set, alter, change.  
  Choices introChoices = new Choices();  
  foreach (string introString in new string[] { "Change", "Set", "Alter" })   
  {  
    GrammarBuilder introGB = new GrammarBuilder(introString);  
    introChoices.Add(  
                  new SemanticResultValue(introGB,  
                  String.Format("Command: {0}", introString)));  
  }           

  GrammarBuilder cmdIntro = new GrammarBuilder(introChoices);  

  // Define the arguments for the command to select foreground or background   
  // and to change their color as semantic values.  
  Choices fgOrbgChoice = new Choices();  
  GrammarBuilder backgroundGB=new GrammarBuilder("background");  
  backgroundGB.Append(new SemanticResultValue(true));  
  fgOrbgChoice.Add(backgroundGB);  
  fgOrbgChoice.Add((GrammarBuilder)new SemanticResultValue("foreground", false));  
  SemanticResultKey fgOrbgChoiceKey = new SemanticResultKey("BgOrFgBool", fgOrbgChoice);  
  Choices colorChoice = new Choices();  
  foreach (string colorName in System.Enum.GetNames(typeof(KnownColor)))   
  {  

    // Use implicit conversion of SemanticResultValue to GrammarBuilder.      
    colorChoice.Add(  
                 (GrammarBuilder) (new SemanticResultValue(colorName, (Color.FromName(colorName)).Name)));  
  }  

  // Create a GrammarBuilder for CmdArgs to be appended to CmdIntro using  
  // semantic keys.  
  GrammarBuilder cmdArgs = new GrammarBuilder();  
  cmdArgs.Append(new SemanticResultKey("BgOrFgBool", fgOrbgChoice));  
  cmdArgs.AppendWildcard();  
  cmdArgs.Append(new SemanticResultKey("colorStringList", colorChoice));  

  GrammarBuilder cmds =   
      GrammarBuilder.Add(  
        cmdIntro,   
        new GrammarBuilder(new SemanticResultKey("Cmd Args", cmdArgs)));  
  grammar = new Grammar(cmds);  
  grammar.Name = "Tree [Set,change,alter] [foreground,background] * color";  
  return grammar;  
}

Remarques

Un SemanticResultValue retourné par ce constructeur n’est pas associé à un élément de grammaire particulier. L’Association doit être rendue explicite à l’aide de l’instance de SemanticResultValue conjointement à GrammarBuilder .

Par exemple, dans le fragment de code ci-dessous, si un Grammar construit à l’aide de cette GrammarBuilder instance reconnaît le mot « background », true la valeur est définie dans la sémantique d’expression reconnue.

GrammarBuilder backgroundGB=new GrammarBuilder("background");  
backgroundGB.Append(new SemanticResultValue(true));

S’applique à

SemanticResultValue(GrammarBuilder, Object)

Initialise une nouvelle instance de la classe SemanticResultValue et associe une valeur sémantique à un objet GrammarBuilder.

public:
 SemanticResultValue(System::Speech::Recognition::GrammarBuilder ^ builder, System::Object ^ value);

public SemanticResultValue (System.Speech.Recognition.GrammarBuilder builder, object value);

new System.Speech.Recognition.SemanticResultValue : System.Speech.Recognition.GrammarBuilder * obj -> System.Speech.Recognition.SemanticResultValue

Public Sub New (builder As GrammarBuilder, value As Object)

Paramètres

builder: GrammarBuilder

Composant de grammaire à utiliser dans la reconnaissance.

value: Object

Valeur managée par SemanticResultValue. Doit être de type bool, int, float ou string.

Exemples

private Grammar FgBgColorGrammar()   
{  
  Grammar grammar = null;  

  // Allow the command to begin with set, alter, change.  
  Choices introChoices = new Choices();  
  foreach (string introString in new string[] { "Change", "Set", "Alter" })   
  {  
    GrammarBuilder introGB = new GrammarBuilder(introString);  
    introChoices.Add(  
                  new SemanticResultValue(introGB,  
                  String.Format("Command: {0}", introString)));  
  }           
  GrammarBuilder cmdIntro = new GrammarBuilder(introChoices);  

  // Define the arguments for the command to select foreground or background   
  // and to change their color as semantic values.  
  Choices fgOrbgChoice = new Choices();  
  GrammarBuilder backgroundGB=new GrammarBuilder("background");  
  backgroundGB.Append(new SemanticResultValue(true));  
  fgOrbgChoice.Add(backgroundGB);  
  fgOrbgChoice.Add((GrammarBuilder)new SemanticResultValue("foreground", false));  
  SemanticResultKey fgOrbgChoiceKey = new SemanticResultKey("BgOrFgBool", fgOrbgChoice);  
  Choices colorChoice = new Choices();  
  foreach (string colorName in System.Enum.GetNames(typeof(KnownColor)))   
  {  

    // Use implicit conversion of SemanticResultValue to GrammarBuilder.      
    colorChoice.Add(  
              (GrammarBuilder) (new SemanticResultValue(colorName, (Color.FromName(colorName)).Name)));  
    }  

  // Create a GrammarBuilder for CmdArgs to be appended to CmdIntro using  
  // semantic keys.  
  GrammarBuilder cmdArgs = new GrammarBuilder();  
  cmdArgs.Append(new SemanticResultKey("BgOrFgBool", fgOrbgChoice));  
  cmdArgs.AppendWildcard();  
  cmdArgs.Append(new SemanticResultKey("colorStringList", colorChoice));  

  GrammarBuilder cmds =   
      GrammarBuilder.Add(  
                      cmdIntro,  
                      new GrammarBuilder(new SemanticResultKey("Cmd Args", cmdArgs)));  
  grammar = new Grammar(cmds);  
  grammar.Name = "Tree [Set,change,alter] [foreground,background] * color";  
  return grammar;  
}

Remarques

Si l’élément de grammaire spécifié par GrammarBuilder est utilisé dans la logique de reconnaissance, value sera défini dans la sémantique de la sortie reconnue.

Dans le fragment de code ci-dessous, si la logique de reconnaissance construite avec l' GrammarBuilder instance ( myGb ) utilise l' Choices objet ( myChoice ) pour identifier l’entrée, la valeur true est ajoutée à la sémantique reconnue.

myGb.Append(new SemanticResultValue(myChoice, true);

Comme GrammarBuilder prend en charge la conversion implicite pour Choices , SemanticResultValue et SemanticResultKey , ce constructeur peut également utiliser ces objets.

S’applique à

SemanticResultValue(String, Object)

Initialise une nouvelle instance de la classe SemanticResultValue et associe une valeur sémantique à un objet String.

public:
 SemanticResultValue(System::String ^ phrase, System::Object ^ value);

public SemanticResultValue (string phrase, object value);

new System.Speech.Recognition.SemanticResultValue : string * obj -> System.Speech.Recognition.SemanticResultValue

Public Sub New (phrase As String, value As Object)

Paramètres

phrase: String

Expression à utiliser dans la reconnaissance.

value: Object

Valeur managée par SemanticResultValue. Doit être de type bool, int, float ou string.

Exemples

private Grammar FgBgColorGrammar()   
{  
  Grammar grammar = null;  

  // Allow command to begin with set, alter, change.  
  Choices introChoices = new Choices();  
  foreach (string introString in new string[] { "Change", "Set", "Alter" })   
  {  
    GrammarBuilder introGB = new GrammarBuilder(introString);  
    introChoices.Add(  
                  new SemanticResultValue(introGB,  
                  String.Format("Command: {0}", introString)));  
  }  

  GrammarBuilder cmdIntro = new GrammarBuilder(introChoices);  

  // Define the arguments for the command to select foreground or background   
  // and to change their color as semantic values.  
  Choices fgOrbgChoice = new Choices();  
  GrammarBuilder backgroundGB=new GrammarBuilder("background");  
  backgroundGB.Append(new SemanticResultValue(true));  
  fgOrbgChoice.Add(backgroundGB);  
  fgOrbgChoice.Add((GrammarBuilder)new SemanticResultValue("foreground", false));  
  SemanticResultKey fgOrbgChoiceKey = new SemanticResultKey("BgOrFgBool", fgOrbgChoice);  
  Choices colorChoice = new Choices();  
  foreach (string colorName in System.Enum.GetNames(typeof(KnownColor)))   
  {  

    // Use implicit conversion of SemanticResultValue to GrammarBuilder.      
    colorChoice.Add(  
          (GrammarBuilder) (new SemanticResultValue(colorName, (Color.FromName(colorName)).Name)));  
  }  

  // Create a GrammarBuilder for CmdArgs to be appended to CmdIntro using  
  // semantic keys.  
  GrammarBuilder cmdArgs = new GrammarBuilder();  
  cmdArgs.Append(new SemanticResultKey("BgOrFgBool", fgOrbgChoice));  
  cmdArgs.AppendWildcard();  
  cmdArgs.Append(new SemanticResultKey("colorStringList", colorChoice));  

  GrammarBuilder cmds =   
      GrammarBuilder.Add(cmdIntro,  
                         new GrammarBuilder(new SemanticResultKey("Cmd Args", cmdArgs)));  
  grammar = new Grammar(cmds);  
  grammar.Name = "Tree [Set,change,alter] [foreground,background] * color";  
  return grammar;  
}

Remarques

Si la chaîne spécifiée par phrase est utilisée dans la logique de reconnaissance, value sera définie dans la sémantique de la sortie reconnue.

Dans le fragment de code suivant, si la logique de reconnaissance construite avec l' GrammarBuilder instance ( myGb ) utilise la chaîne « My Mortgage » pour identifier l’entrée, la valeur true sera ajoutée à la sémantique reconnue.

myGb.Append(new SemanticResultValue("my mortgage", true);

S’applique à

Partager via

SemanticResultValue Constructeurs

Définition

Surcharges

Remarques

SemanticResultValue(Object)

Paramètres

Exemples

Remarques

S’applique à

SemanticResultValue(GrammarBuilder, Object)

Paramètres

Exemples

Remarques

S’applique à

SemanticResultValue(String, Object)

Paramètres

Exemples

Remarques

S’applique à

Ressources supplémentaires