SemanticValue.ContainsKey(String) Метод

Ссылка

Определение

Пространство имен:: System.Speech.Recognition

Сборка:: System.Speech.dll

Пакет:: System.Speech v8.0.0

Пакет:: System.Speech v9.0.0-rc.2.24473.5

Исходный код:: SemanticValue.cs

Исходный код:: SemanticValue.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Указывает, содержит ли текущая коллекция экземпляров SemanticValue дочерний экземпляр SemanticValue с заданной строкой ключа.

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

Параметры

key: String

String, содержащий ключевую строку, используемую для идентификации дочернего экземпляра SemanticValue под текущим SemanticValue.

Возвращаемое значение

Boolean

Возвращает bool, true если дочерний экземпляр SemanticValue, отмеченный строкой key найден, если нет — false.

Реализации

ContainsKey(TKey)

Примеры

В следующем примере показан обработчик для события, предназначенного SpeechRecognized для обработки команд для изменения цвета переднего плана и фона.

После обработки фраз, которые распознаются, но не имеют семантической структуры, обработчик проверяет наличие соответствующих ключей с помощью ContainsKey (applyChgToBackground, colorRGBValueListили , а colorStringList)затем обрабатывает семантически организованные данные.

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

Доступ к данным можно получить только по значению ключа во время выполнения, например для проверка семантики["myKey"]. Значение, и это создает исключение. Рекомендуется запросить объект с ContainsKey перед использованием Item[] с заданным экземпляром SemanticValue.

Применяется к

Поделиться через