SemanticValue.ContainsKey(String) Método

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Paquete:

System.Speech v9.0.0-preview.3.24172.9

Source:

SemanticValue.cs

Indica si la colección actual de la instancia de SemanticValue contiene una instancia de SemanticValue secundaria con una cadena de clave especificada.

public:
 virtual bool ContainsKey(System::String ^ key);

public bool ContainsKey (string key);

abstract member ContainsKey : string -> bool
override this.ContainsKey : string -> bool

Public Function ContainsKey (key As String) As Boolean

Parámetros

key

String

String que contiene la cadena de clave usada para identificar una instancia secundaria de SemanticValue bajo el SemanticValue actual.

Devoluciones

Boolean

Devuelve un valor bool, true si se encuentra una instancia secundaria de SemanticValue etiquetada con key de cadena; de lo contrario, es false.

Implementaciones

ContainsKey(TKey)

Ejemplos

En el ejemplo siguiente se muestra un controlador para un SpeechRecognized evento diseñado para controlar los comandos para cambiar el color de primer plano y de fondo.

Después de controlar frases reconocidas pero que no tienen estructura semántica, el controlador comprueba la presencia de claves adecuadas mediante ContainsKey (applyChgToBackground, , o colorStringList)y, a continuación, colorRGBValueListprocesa los datos organizados semánticamente.

newGrammar.SpeechRecognized +=  
  delegate(object sender, SpeechRecognizedEventArgs eventArgs)   
  {  

    // Retrieve the value of the semantic property.  
    bool changeBackGround = true;  
    string errorString = "";  
    SemanticValue semantics = eventArgs.Result.Semantics;  

    Color newColor = Color.Empty;  

    try   
    {  
      if (semantics.Count == 0 && semantics.Value==null)  
      {  

        // Signifies recognition by a grammar with no semantics.  
        // Parse the string, assuming that the last word is color,  
        // searching for background or foreground in input.  
        if (eventArgs.Result.Text.Contains("foreground"))   
        {  
          changeBackGround = false;  
        }  
        string cName = eventArgs.Result.Words[eventArgs.Result.Words.Count - 1].Text;  
        newColor = Color.FromName(cName);  

      }  
      else if (semantics.ContainsKey("colorStringList") ^ semantics.ContainsKey("colorRGBValueList"))   
      {  

        // Determine whether to change background or foreground.  
        if (semantics.ContainsKey("applyChgToBackground"))   
        {  
          changeBackGround = semantics["applyChgToBackground"].Value is bool;  
        }  

        // Get the RGB color value.  
        if (semantics.ContainsKey("colorStringList"))   
        {  
          newColor = Color.FromName((string)semantics["colorStringList"].Value);  
        }  
        if (semantics.ContainsKey("colorRGBValueList"))   
        {  
          newColor = System.Drawing.Color.FromArgb((int)semantics["colorRGBValueList"].Value);  
        }  
      }  
      else   
      {  

        // Throw an exception if the semantics do not contain the keys we  
        // support.  
        throw(new Exception("Unsupported semantics keys found."));  
      }  
    }  

    catch (Exception exp)   
    {  
      MessageBox.Show(String.Format("Unable to process color semantics.:\n{0}\n", exp.Message));  
      return;  
    }  

    // Change colors, either foreground or background.  
    if (changeBackGround)   
    {  
      BackColor = newColor;  
      float Bright = BackColor.GetBrightness();  
      float Hue = BackColor.GetHue();  
      float Sat = BackColor.GetSaturation();  
      // Make sure that text is readable regardless of background.  
      if (BackColor.GetBrightness() <= .50)   
      {  
        ForeColor = Color.White;  
      }  
      else   
      {  
        ForeColor = Color.Black;  
      }  
    }  
    else   
    {  
      ForeColor = newColor;  
      float Bright = ForeColor.GetBrightness();  
      float Hue = ForeColor.GetHue();  
      float Sat = ForeColor.GetSaturation();  
      // Make sure that text is readable regardless of Foreground.  
      if (ForeColor.GetBrightness() <= .50)   
      {  
        BackColor = Color.White;  
      }  
      else   
      {  
        BackColor = Color.Black;  
      }  
    }  
    return;  
  };  

Comentarios

Solo puede acceder a los datos por valor de clave en tiempo de ejecución, por ejemplo para comprobar la semántica["myKey"]. Valor y esto genera una excepción. Se recomienda consultar el objeto con ContainsKey antes de usar Item[] con una instancia determinada de SemanticValue.