Partager via


IVsContainedLanguageHost.GetNearestVisibleToken, méthode

Retourne le jeton de langage qui est le plus proche la ligne demandée.

Espace de noms :  Microsoft.VisualStudio.TextManager.Interop
Assembly :  Microsoft.VisualStudio.TextManager.Interop.8.0 (dans Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Syntaxe

'Déclaration
Function GetNearestVisibleToken ( _
    tsSecondaryToken As TextSpan, _
    <OutAttribute> ptsPrimaryToken As TextSpan() _
) As Integer
int GetNearestVisibleToken(
    TextSpan tsSecondaryToken,
    TextSpan[] ptsPrimaryToken
)
int GetNearestVisibleToken(
    [InAttribute] TextSpan tsSecondaryToken, 
    [OutAttribute] array<TextSpan>^ ptsPrimaryToken
)
abstract GetNearestVisibleToken : 
        tsSecondaryToken:TextSpan * 
        ptsPrimaryToken:TextSpan[] byref -> int
function GetNearestVisibleToken(
    tsSecondaryToken : TextSpan, 
    ptsPrimaryToken : TextSpan[]
) : int

Paramètres

Valeur de retour

Type : Int32
Si réussi, retours S_OK ; sinon, retours code d'erreur.

Notes

Signature de COM

De singlefileeditor.idl :

HRESULT GetNearestVisibleToken(
   [in]  TextSpan  tsSecondaryToken,
   [out] TextSpan* ptsPrimaryToken
);

Si un langage contenu ne peut pas déterminer où créer une marque pour une erreur de compilation qui est visible à l'utilisateur, le langage contenu doit appeler la méthode d'GetNearestVisibleToken, afin que l'éditeur puisse fournir l'élément le plus proche pour créer la marque sur.

Par exemple :

<script runat="server" language="vb">
        Sub TestSub()
</script>

Normalement, Visual Basic placerait la ligne ondulée tilde () indiquant le point d'erreur sur l'instruction d'End Class ou sur le code de Visual Basic peut suivre End Sub manquant. Toutefois, dans l'exemple ci-dessus de ASP.NET, tout code supplémentaire de Visual Basic est en dehors du bloc de code visible. Le langage contenu peut déterminer cette situation en appelant la méthode d'MapSecondaryToPrimarySpan qui échoue si le texte est en dehors de la plage visible. Dans ce cas, le langage contenu peut appeler la méthode d'GetNearestVisibleToken pour obtenir l'étendue pour que le jeton visible le plus proche mette les tilde sur. Dans l'exemple ci-dessus, les tilde doivent apparaître sur la balise d'</script> et c'est l'étendue que l'éditeur se retourne de la méthode d'GetNearestVisibleToken.

Sécurité .NET Framework

Voir aussi

Référence

IVsContainedLanguageHost Interface

Microsoft.VisualStudio.TextManager.Interop, espace de noms