Condividi tramite

Estendere l'editor di Visual Studio

L'editor di Visual Studio supporta le estensioni che aggiungono alle relative funzionalità. Tra gli esempi sono incluse le estensioni che:

  • Inserire e modificare il codice in un linguaggio esistente.
  • Personalizzare il comportamento di determinate funzionalità dell'editor, ad esempio CodeLens.

L'editor di Visual Studio si riferisce in genere alla funzionalità di modifica di file di testo, noti come documenti, di qualsiasi tipo. È possibile aprire singoli file per la modifica. La finestra dell'editor aperto viene definita visualizzazione di testo.

Per altre informazioni sul modello a oggetti dell'editor, vedere Concetti di estendibilità dell'editor.

Le sezioni seguenti riepilogano gli scenari di estendibilità dell'editor di alto livello supportati VisualStudio.Extensibility . Ognuno di questi scenari è ricco di concetti e API. Sezioni separate e più dettagliate includono collegamenti per fornire spiegazioni più approfondite delle API e come usarle.

Leggere il testo e osservare le modifiche nell'editor

Il punto di estendibilità più fondamentale per l'editor di Visual Studio consiste nel modificare il testo, leggendo il testo nell'editor o modificando il testo. Questi scenari sono fondamentali per qualsiasi estensione basata su editor. Ad esempio, per fornire informazioni di diagnostica, ad esempio avvisi o errori, l'estensione deve leggere il codice nell'editor e quindi interpretarlo. Un'estensione richiede anche un modo per rilevare quando il testo nell'editor è stato modificato, se è stato aperto un nuovo file o se è stato chiuso un file aperto.

Per una procedura dettagliata su come leggere testo e tenere traccia delle modifiche del testo tramite VisualStudio.Extensibility, vedere Usare il testo nell'editor.

Apportare modifiche al testo nell'editor

Qualsiasi estensione che mira a migliorare la produttività di modifica tramite la generazione automatica del testo (ad esempio la generazione automatica di un GUID e l'inserimento) necessita di API per definire dove e cosa inserire. Il VisualStudio.Extensibility modello di estensione esegue il codice fuori processo e in modo asincrono, che richiede l'adesione a principi specifici quando si sviluppano estensioni di modifica del testo.

Per una procedura dettagliata su come modificare il testo usando VisualStudio.Extensibility, vedere Modificare il testo nell'editor.

Estendere le funzionalità dell'editor

Le estensioni possono anche collegarsi a molte funzionalità nell'editor che forniscono informazioni contestuali. Le sezioni seguenti riepilogano le diverse funzionalità dell'editor che è possibile estendere.

Margine visualizzazione testo

Le estensioni possono contribuire ai nuovi margini della visualizzazione testo nell'editor di Visual Studio. Un margine di visualizzazione testo è un controllo interfaccia utente rettangolare collegato a una visualizzazione di testo su uno dei quattro lati. Questi controlli dell'interfaccia utente offrono più informazioni a colpo d'occhio, che consente agli sviluppatori di rimanere produttivi quando lavorano nell'editor. Molte delle funzionalità più diffuse nell'editor di Visual Studio usano margini di visualizzazione testo, ad esempio il controllo zoom, l'indicatore del punto di interruzione e l'indicatore del numero di riga.

Per una procedura dettagliata su come personalizzare i margini della visualizzazione testo con l'estensione, vedere Estendere l'editor di Visual Studio con un nuovo margine.

CodeLens

Le estensioni possono contribuire con nuovi CodeLenses nell'editor di Visual Studio. CodeLens è un indicatore visivo visualizzato sopra le righe di testo per fornire informazioni contestuali interattivi. Gli esempi includono il numero di riferimenti a un elemento di codice, i risultati dell'ultima esecuzione dello unit test o le azioni da eseguire o eseguire il debug di uno unit test. Alcune codelenses comuni includono il riferimento al codice CodeLens, che fornisce informazioni su tutte le diverse parti del codice che fanno riferimento a un blocco di codice specifico. La cronologia del codice CodeLens fornisce informazioni su come un blocco specifico di codice modificato nel controllo del codice sorgente.

Per una procedura dettagliata su come fornire il tuo CodeLens nella tua estensione, vedere Estendere l'editor di Visual Studio con un nuovo CodeLens.

Taggger

Le estensioni possono fornire nuovi tagger nell'editor di Visual Studio. I taggger vengono usati per associare i dati agli intervalli di testo. Altre funzionalità di Visual Studio, ad esempio CodeLens e classificazione, usano questi dati.

Per una procedura dettagliata su come fornire taggger personalizzati con l'estensione, vedere Estendere l'editor di Visual Studio con un nuovo tagger.

Contenuto correlato