SemanticValue.Item[String] 속성

정의

네임스페이스:

System.Speech.Recognition

어셈블리:

System.Speech.dll

패키지:

System.Speech v10.0.0-preview.2.25163.2

Source:

SemanticValue.cs

현재 SemanticValue에 속하는 자식 SemanticValue 인스턴스를 반환합니다.

public:
 property System::Speech::Recognition::SemanticValue ^ default[System::String ^] { System::Speech::Recognition::SemanticValue ^ get(System::String ^ key); void set(System::String ^ key, System::Speech::Recognition::SemanticValue ^ value); };

public System.Speech.Recognition.SemanticValue this[string key] { get; set; }

member this.Item(string) : System.Speech.Recognition.SemanticValue with get, set

Default Public Property Item(key As String) As SemanticValue

매개 변수

key

String

SemanticValue의 현재 인스턴스에 포함된 KeyValuePair<String, SemanticValue>의 키입니다.

속성 값

SemanticValue

키 값 쌍의 일부로 인덱싱할 수 있는 현재 SemanticValue 자식() KeyValuePair<String,SemanticValue>을 반환합니다.

구현

Item[TKey]

예외

KeyNotFoundException

의 현재 instance SemanticValue 자식 멤버에 매개 변수와 일치하는 key 키가 없습니다.

InvalidOperationException

코드가 지정된 인덱스에서 을 변경 SemanticValue 하려고 했습니다.

예제

다음 예제에 대 한 처리기를 SpeechRecognized 이벤트 전경색과 배경색을 변경 하는 명령 처리 하도록 설계 되었습니다.

의미 체계 구조가 없는 인식할 수 있는 구 처리 후 처리기를 사용 하 여 적절 한 키의 존재 여부 확인 ContainsKey (applyChgToBackground를 colorRGBValueList, 또는 colorStringList)를 사용 하 여는 Item[] 속성 노드를 가져오려면 필수 정보입니다.

사용 Item[] 아래 강조 표시 됩니다.

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 semantic 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 the foreground.
      if (ForeColor.GetBrightness() <= .50)
      {
        BackColor = Color.White;
      }
      else
      {
        BackColor = Color.Black;
      }
    }
    return;
  };

설명

Item[] 읽기 전용 이며 멤버 수정 되는 경우 예외를 생성 합니다.

예를 확인 하려면 컴파일 시간에 아닐 실행 시간에 키 값으로 데이터를만 액세스할 수 있습니다 semantic["myKey"].Value합니다. 존재 하지 않는 키를 지정 하면 예외가 발생 합니다.

지정된 된 키의 존재를 검색 하려면 사용 합니다 ContainsKey 속성에는 SemanticValue 인스턴스.