Sdílet prostřednictvím


SmartTagBase.Recognize-Methode (2007 System)

Aktualisiert: November 2007

Durchsucht Text nach erkannten Begriffen.

Namespace:  Microsoft.Office.Tools
Assembly:  Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)

Syntax

'Declaration
Protected Overridable Sub Recognize ( _
    text As String, _
    site As ISmartTagRecognizerSite, _
    tokenList As ISmartTagTokenList _
)
'Usage
Dim text As String
Dim site As ISmartTagRecognizerSite
Dim tokenList As ISmartTagTokenList

Me.Recognize(text, site, tokenList)
protected virtual void Recognize(
    string text,
    ISmartTagRecognizerSite site,
    ISmartTagTokenList tokenList
)

Parameter

  • text
    Typ: System.String

    Der nach erkannten Begriffen zu durchsuchende Text.

  • site
    Typ: ISmartTagRecognizerSite

    Die Position des Texts in der Arbeitsmappe oder dem Dokument.

  • tokenList
    Typ: ISmartTagTokenList

    Der nach erkannten Begriffen zu durchsuchende Text, gegliedert in eine Liste von Tokens.

Hinweise

Wird in Leerlaufzeiten von der Visual Studio Tools for Office-Laufzeit aufgerufen, um Text nach erkannten Begriffen zu durchsuchen. Implementieren Sie diese Methode, wenn Sie die Standarderkennung durch eigene Suchalgorithmen erweitern möchten.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Recognize-Methode innerhalb einer Klasse überschrieben wird, die von Microsoft.Office.Tools.Excel.SmartTag abgeleitet ist. Diese Implementierung von Recognize vergleicht jeden einzelnen Smarttagbegriff mit dem Inhalt einer Zelle in einem Microsoft Office Excel-Arbeitsblatt. Wenn in der Zelle ein Smarttagbegriff gefunden wird, wird dem Smarttag durch Code eine benutzerdefinierte Smarttageigenschaft hinzugefügt, und dann wird die SmartTag.PersistTag(ISmartTagProperties)-Methode zum Erkennen des Smarttags aufgerufen. In diesem Beispiel wird davon ausgegangen, dass Sie im Dialogfeld Verweis hinzufügen auf der Registerkarte COM einen Verweis auf die Microsoft Smart Tags 2.0-Typbibliothek hinzugefügt haben. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels, das für die Microsoft.Office.Tools.Excel.SmartTag-Klasse bereitgestellt wird.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Protected Overrides Sub Recognize(ByVal text As String, _
    ByVal site As ISmartTagRecognizerSite, _
    ByVal tokenList As ISmartTagTokenList)

    ' Determine whether each smart tag term exists in 
    ' the document text.
    Dim Term As String
    For Each Term In Me.Terms

        ' Search the cell text for the first instance of 
        ' the current smart tag term.
        Dim index As Integer = Me.CellText.IndexOf(Term, 0)

        If (index >= 0) Then

            ' Create a smart tag token and a property bag for the 
            ' recognized term.
            Dim propertyBag As ISmartTagProperties = _
                site.GetNewPropertyBag()

            ' Write a new property value.
            Dim key As String = "Key1"
            propertyBag.Write(key, DateTime.Now)

            ' Attach the smart tag to the term in the document
            Me.PersistTag(propertyBag)

            ' This implementation only finds the first instance
            ' of a smart tag term in the cell. 
            Exit For
        End If
    Next
End Sub
protected override void Recognize(string text, 
    ISmartTagRecognizerSite site, ISmartTagTokenList tokenList)
{
    // Determine whether each smart tag term exists in 
    // the document text.
    foreach (string term in this.Terms)
    {
        // Search the cell text for the first instance of 
        // the current smart tag term.
        int index = this.CellText.IndexOf(term, 0);

        if (index >= 0)
        {
            // Create a smart tag token and a property bag for the 
            // recognized term.
            ISmartTagProperties propertyBag = 
                site.GetNewPropertyBag();

            // Write a new property value.                 
            string key = "Key1";
            propertyBag.Write(key, DateTime.Now.ToString());

            // Attach the smart tag to the term in the document
            this.PersistTag(propertyBag);

            // This implementation only finds the first instance
            // of a smart tag term in the cell. 
            break;
        }
    }
}

Berechtigungen

Siehe auch

Referenz

SmartTagBase-Klasse

SmartTagBase-Member

Microsoft.Office.Tools-Namespace