RecognizedWordUnit.Text Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den normalisierten Text für ein erkanntes Wort ab.
public:
property System::String ^ Text { System::String ^ get(); };
public string Text { get; }
member this.Text : string
Public ReadOnly Property Text As String
Eigenschaftswert
Eine Zeichenfolge, die die normalisierte Textausgabe für ein angegebenes Eingabewort enthält.
Beispiele
Das folgende Beispiel zeigt eine Hilfsprogrammroutine, die eine Zeichenfolge in einem von drei Formaten generiert: lexikalisch (mit LexicalForm), normalisiert (mit Text) und phonetisch (mit Pronunciation). Die Textausgabe wird aus einer ReadOnlyCollection<T> von RecognizedWordUnit -Objekten abgerufen, die von der Words -Eigenschaft für das RecognizedPhrase -Objekt abgerufen wird.
internal enum WordType
{
Text,
Normalized = Text,
Lexical,
Pronunciation
}
internal static string stringFromWordArray(
ReadOnlyCollection<RecognizedWordUnit> words,
WordType type)
{
string text = "";
foreach (RecognizedWordUnit word in words)
{
string wordText = "";
if (type == WordType.Text || type == WordType.Normalized)
{
wordText = word.Text;
}
else if (type == WordType.Lexical)
{
wordText = word.LexicalForm;
}
else if (type == WordType.Pronunciation)
{
wordText = word.Pronunciation;
}
else
{
throw new InvalidEnumArgumentException(
String.Format("[0}: is not a valid input", type));
}
// Use display attribute
if ((word.DisplayAttributes & DisplayAttributes.OneTrailingSpace) != 0)
{
wordText += " ";
}
if ((word.DisplayAttributes & DisplayAttributes.TwoTrailingSpaces) != 0)
{
wordText += " ";
}
if ((word.DisplayAttributes & DisplayAttributes.ConsumeLeadingSpaces) != 0)
{
wordText = wordText.TrimStart();
}
if ((word.DisplayAttributes & DisplayAttributes.ZeroTrailingSpaces) != 0)
{
wordText = wordText.TrimEnd();
}
text += wordText;
}
return text;
}
Hinweise
In den meisten Fällen sind die von Text und LexicalForm zurückgegebenen Werte identisch. Erkennungs-Engines können jedoch die Sprachnormalisierung verwenden, um benutzerfreundlichere oder umgangssprachliche Textdarstellungen von Audioeingaben zurückzugeben.
Sprachnormalisierung ist die Verwendung spezieller Konstrukte oder Symbole, um Sprache schriftlich auszudrücken. Die Normalisierung kann beispielsweise die gesprochenen Wörter "ein Dollar und sechzehn Cents" durch "$1,16" im Ausgabetext ersetzen.