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 bestimmtes Eingabewort enthält.
Beispiele
Das folgende Beispiel zeigt eine Hilfsroutine, die eine Zeichenfolge in einem von drei Formaten generiert: lexikalisch (mithilfe ), normalisiert (mit LexicalFormText) und phonetisch (mit Pronunciation). Die Textausgabe wird aus einem ReadOnlyCollection<T> Objekt RecognizedWordUnit abgerufen, das aus der Words Eigenschaft des RecognizedPhrase Objekts 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 ihnen zurückgegebenen Werte LexicalForm identisch. Erkennungsmodule können jedoch die Sprachnormalisierung verwenden, um benutzerfreundlichere oder kolloquiale Textdarstellungen von Audioeingaben zurückzugeben.
Die Sprachnormalisierung ist die Verwendung spezieller Konstrukte oder Symbole, um Sprache schriftlich auszudrücken. Die Normalisierung kann z. B. die gesprochenen Wörter "Dollar und sechzehn Cent" durch "$1,16" im Ausgabetext ersetzen.