Come commentare una riga in XML

Programmatore che lavora con il codice del programma

A differenza dell'HTML, i tag XML forniscono dettagli descrittivi sul contenuto piuttosto che istruzioni visive per visualizzarlo.

Credito immagine: RossHelen/iStock/GettyImages

XML fornisce un linguaggio di markup per memorizzare i dati e trasmetterli da una posizione all'altra. Come l'HTML, utilizza testo semplice che puoi modificare in qualsiasi applicazione che scriva file TXT. A differenza dell'HTML, i tag XML forniscono dettagli descrittivi sul contenuto piuttosto che istruzioni visive per visualizzarlo. Quando definisci i tag XML per caratterizzare un insieme di informazioni, puoi utilizzare i commenti per servirne due scopi all'interno del tuo lavoro: spiegarlo e ometterne parti dal codice che altre applicazioni processi. Se conosci già la sintassi dei commenti HTML, conosci anche l'equivalente XML.

Se vuoi commentare una singola riga nel codice XML, inserisci il cursore all'inizio di una riga che vuoi commentare. Digitare un simbolo minore di seguito da un punto esclamativo e due trattini

. Sposta il cursore alla fine della riga e poi digita due trattini seguiti da un simbolo di maggiore di.

Video del giorno

Se la tua riga consiste nell'affermazione "Usa questa sezione per creare una descrizione dei gatti adottabili", appare così con entrambi i tag di commento in posizione:

Ti consigliamo di leggere il tuo commento per verificare che non contenga istanze di due trattini consecutivi se non nei tag di commento di apertura e chiusura. I trattini consecutivi attivano un falso segnale di fine commento che interrompe la sintassi.

Piuttosto che commentare una singola riga, potrebbe essere necessario commentare un'intera sezione del codice XML. Per fare ciò, inserisci il cursore su una riga vuota sopra la sezione del codice XML che desideri commentare e quindi digita a simbolo minore di seguito da un punto esclamativo e due trattini.

Per terminare il commento, sposta il cursore in basso su una riga vuota dopo la sezione del codice XML che stai commentando. Tipo due trattini seguiti da un simbolo di maggiore di. Con i commenti in atto, una sezione del codice XML si presenta così:

Ancora una volta ti consigliamo di leggere la tua sezione commentata per verificare che non contenga un commento all'interno delle righe che hai commentato. I commenti nidificati costituiscono un errore in XML.

Quando fai commenti, ricorda alcune regole di sintassi XML di base. XML non consente l'uso del carattere minore di all'interno del suo codice, tranne che come parte di un tag di commento di apertura. Per includere il carattere in qualsiasi cosa tranne un tag di commento, inseriscilo come un riferimento entità, una sequenza codificata che si trasforma in un carattere specifico quando un'applicazione analizza il tuo XML.

Ogni riferimento di entità inizia con una e commerciale e termina con un punto e virgola. Tra questi due caratteri, il riferimento all'entità per il simbolo minore di contiene le lettere minuscole "lt", senza virgolette e punteggiatura. Il simbolo maggiore di non costituisce un carattere illegale in XML, ma è buona norma utilizzare anche il riferimento all'entità, che include le lettere "gt".

Inoltre, sappi che se non riesci ad aprire e chiudere correttamente i tuoi commenti o a posizionarli attorno a una sezione di codice che contiene un ID, il tuo XML non verrà analizzato correttamente.