IVsContainedLanguageHost.GetNearestVisibleToken(TextSpan, TextSpan[]) Méthode

Définition

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

public:
 int GetNearestVisibleToken(Microsoft::VisualStudio::TextManager::Interop::TextSpan tsSecondaryToken, cli::array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> ^ ptsPrimaryToken);
public:
 int GetNearestVisibleToken(Microsoft::VisualStudio::TextManager::Interop::TextSpan tsSecondaryToken, Platform::Array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> ^ ptsPrimaryToken);
int GetNearestVisibleToken(Microsoft::VisualStudio::TextManager::Interop::TextSpan tsSecondaryToken, std::Array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> const & ptsPrimaryToken);
public int GetNearestVisibleToken (Microsoft.VisualStudio.TextManager.Interop.TextSpan tsSecondaryToken, Microsoft.VisualStudio.TextManager.Interop.TextSpan[] ptsPrimaryToken);
abstract member GetNearestVisibleToken : Microsoft.VisualStudio.TextManager.Interop.TextSpan * Microsoft.VisualStudio.TextManager.Interop.TextSpan[] -> int
Public Function GetNearestVisibleToken (tsSecondaryToken As TextSpan, ptsPrimaryToken As TextSpan()) As Integer

Paramètres

tsSecondaryToken
TextSpan

[in] Objet TextSpan décrivant la position et l'étendue du jeton à rechercher. Cette position est basée sur la mémoire tampon secondaire.

ptsPrimaryToken
TextSpan[]

[out] Retourne un objet TextSpan décrivant la position et l'étendue du jeton le plus proche du jeton spécifié. La position est basée sur la mémoire tampon primaire.

Retours

Int32

En cas de réussite, retourne S_OK , sinon, retourne un code d'erreur.

Remarques

Signature COM

À partir de singlefileeditor. idl :

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

Si un langage contenu n’est pas en mesure de déterminer où créer un marqueur pour une erreur de compilation qui est visible par l’utilisateur, la langue contenue doit appeler la GetNearestVisibleToken méthode, afin que l’éditeur puisse fournir l’élément le plus proche sur lequel créer un marqueur.

Par exemple :

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

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

S’applique à