Metodo SmartTagRecognizeContext.PersistTag

Articolo
08/11/2011

Archivia le informazioni relative allo smart tag.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
Sub PersistTag ( _
    startIndex As Integer, _
    length As Integer, _
    propertyBag As ISmartTagProperties _
)

void PersistTag(
    int startIndex,
    int length,
    ISmartTagProperties propertyBag
)

Parametri

startIndex
Tipo: System.Int32
Posizione di inizio dello smart tag all'interno del paragrafo.

length
Tipo: System.Int32
Lunghezza dello smart tag.

propertyBag
Tipo: Microsoft.Office.Interop.SmartTag.ISmartTagProperties
Elenco proprietà contenente le coppie chiave/valore per il token.Può essere nullriferimento null (Nothing in Visual Basic).

Eccezioni

Eccezione	Condizione
InvalidOperationException	PersistTag non è stato chiamato dal metodo Recognize.

Note

Chiamare PersistTag da un'implementazione del metodo Recognize per indicare che lo smart tag è stato trovato nel testo. Utilizzare il parametro propertyBag per eseguire il commit di eventuali proprietà personalizzate per lo smart tag. È possibile utilizzare queste proprietà per personalizzare l'azione intrapresa quando viene selezionata una voce del menu di scelta rapida Smart tag.

Esempi

Nell'esempio di codice seguente viene illustrato come chiamare PersistTag da un'implementazione del metodo Recognize. Questa implementazione confronta ogni termine smart tag al contenuto del paragrafo. Per ogni termine smart tag presente nel paragrafo viene aggiunta una proprietà smart tag personalizzata e viene utilizzato il metodo PersistTag per riconoscere lo smart tag. Nell'esempio si presuppone che sia stato aggiunto un riferimento a Microsoft.Office.Interop.SmartTag dalla scheda .NET della finestra di dialogo Aggiungi riferimento. Questo esempio di codice fa parte di un esempio più esaustivo fornito per l'interfaccia ISmartTagExtension.

Private Sub Recognize(ByVal text As String,
    ByVal site As ISmartTagRecognizerSite,
    ByVal tokenList As ISmartTagTokenList,
    ByVal context As SmartTagRecognizeContext) Implements ISmartTagExtension.Recognize

    For Each term As String In smartTagDemo.Terms
        ' Search the text for the current smart tag term.
        Dim index As Integer = text.IndexOf(term, 0)

        While (index >= 0)
            ' 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.ToString())

            ' Attach the smart tag to the term in the document
            context.PersistTag(index, term.Length, propertyBag)

            ' Increment the index and then find the next instance of the smart tag term.
            index += term.Length
            index = text.IndexOf(term, index)
        End While
    Next
End Sub

void ISmartTagExtension.Recognize(string text, ISmartTagRecognizerSite site, ISmartTagTokenList tokenList, 
    SmartTagRecognizeContext context)
{

    foreach (string term in smartTagDemo.Terms)
    {
        // Search the text for the current smart tag term.
        int index = text.IndexOf(term, 0);

        while (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
            context.PersistTag(index, term.Length, propertyBag);

            // Increment the index and then find the next instance of the smart tag term.
            index += term.Length;
            index = text.IndexOf(term, index);
        }
    }
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

SmartTagRecognizeContext Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite