SemanticResultValue Sınıf

Tanım

public ref class SemanticResultValue

public class SemanticResultValue

type SemanticResultValue = class

Public Class SemanticResultValue

Devralma

Object

SemanticResultValue

Örnekler

Aşağıdaki örnek Grammar , "Ayarla/Değiştir/Ön Plan/Arka Plan Değiştir ... [renk listesi]". SemanticResultValueve SemanticResultKey örnekleri (ve GrammarBuilder nesneleriyle Choices birlikte) tanımada ayrıştırılabilir semantiği tanımlamak için kullanılır. Ayrıştırılan semantik, hangi rengin istendiğini ve ön planın mı yoksa arka planın mı değiştirileceğini belirler.

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

Açıklamalar

ve Choicesile birlikte ve SemanticResultKey nesnelerinin SemanticResultValue kullanımı, bir için Grammaranlamsal yapı tasarlamanın en GrammarBuilder kolay yoludur. Bir tümcecik için anlamsal bilgilere, üzerinde RecognizedPhraseözelliği aracılığıyla Semantics bir örneği SemanticValueelde edilerek erişilir.

Bir örneğin tipik kullanımı SemanticResultValue , örneği tümcecik, kural veya nesne gibi bir Grammaröğesinin tanınabilir bir Choices bileşeniyle ilişkilendirir. İlişkili bileşen bir tanıma işleminin parçası olarak kullanılıyorsa, SemanticResultValue döndürülen tümceciği semantiğinde bir değer tanımlamak için kullanılır.

örneğini oluşturmak SemanticResultValueiçin kullanılan oluşturucuya bağlı olarak, bir örneği dil bilgisi öğesiyle ilişkilendirmek SemanticResultValue için iki temel yöntem vardır.

• Bir nesne oluşturmak SemanticResultValue için yalnızca değeri (bir örneği Objecttarafından belirtilen) kullanılıyorsa, SemanticResultValue nesnesine GrammarBuilder ek olarak kendisinden önceki dil bilgisi bileşeniyle ilişkilendirilir.

  Örneğin, aşağıdaki kod parçasında, bu GrammarBuilder örnek kullanılarak oluşturulduğunda "background" sözcüğü tanınıyorsaGrammar, tanınan tümcecik semantiğinde değeri true ayarlanır.

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

  Daha fazla bilgi için açıklamasına SemanticResultValue(Object)bakın.

• Bir dize değeri tümceciği veya belirli GrammarBuilder bir örnek, değeri SemanticResultValue belirten bir Object ile birlikte kullanılırsa, bu değer otomatik olarak dize değeri tümceciği veya GrammarBuilder örneğiyle ilişkilendirilir. Tümcecik veya GrammarBuilder nesne tanıma işleminde kullanılıyorsa, değer tanınan tümceciği semantiğine atanır.

  Aşağıdaki örnek bunu gösterir ve işlevsel olarak ve SemanticResultValue(Object)için açık çağrıları kullanan önceki örnekle Append eşdeğerdir. Tanıma mantığı "background" sözcüğünü kullanıyorsa, değer true tanınan semantiğine eklenir.

  fgOrbgChoice.Add((GrammarBuilder)new SemanticResultValue("background", true));
  

  Daha fazla bilgi için ve SemanticResultValue(String, Object)açıklamalarını SemanticResultValue(GrammarBuilder, Object) inceleyin.

tanımada tarafından Grammar kullanılmak için tüm SemanticResultValue örneklerin tarafından Grammarkullanılan nesnelerden biriyle SemanticValue ilişkilendirilmesi gerekir. Bu, bir semantik anahtar ile SemanticResultValueilişkilendirilerek gerçekleştirilir.

Anlam anahtarları bir nesnesi kullanılarak SemanticResultKey açıkça öğesine SemanticResultValueeklenebilir. SemanticResultValue açıkça bir anahtara eklenmemiş örnekler, varsayılan SemanticValueöğesinin kök anahtarına eklenir.

SemanticResultValue varsayılan kök anahtarla veya belirli SemanticResultKeybir tarafından etiketlenmiş olsun, ayarlamak Valueiçin bir kullanıldıktan sonra, bu değer değiştirilmemelidir veya tanıma işlemleri sırasında bir özel durum oluşur.

Aşağıdaki örnek bir özel duruma neden olur çünkü bir öğesinin kökünü ValueGrammarayarlar ve değiştirir.

GrammarBuilder gb=new GrammarBuilder();
gb.Append(new SemanticResultValue("One"));
gb.Append(new SemanticResultValue("Two"));

Öte yandan, aşağıdaki örnekteki koda izin verilir. birden çok örneğini SemanticResultValuetanımlasa da, bunlar bir Choices nesnesine dahil edilir ve anahtarının bgOrfgTextdeğerini ayarlamak için yalnızca bir tane kullanılır.

Choices fgOrbgChoice = new Choices();
fgOrbgChoice.Add((GrammarBuilder)new SemanticResultValue("background"));
fgOrbgChoice.Add((GrammarBuilder)new SemanticResultValue("foreground"));
SemanticResultKey fgOrbgChoiceKey = new SemanticResultKey("BgOrFgText", fgOrbgChoice);

Oluşturucular

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• SemanticResultValue Ayıklamak için SemanticResultKey Kullanma