IVsContainedLanguageHost.GetNearestVisibleToken(TextSpan, TextSpan[]) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.