Εάν ενδιαφέρεστε να προσθέσετε σχόλια αναφοράς στο δικό σας Κωδικός XML, χρησιμοποιήστε αυτό το βήμα προς βήμα οδηγό για καθοδήγηση. Μπορείτε να μάθετε πώς να εκτελέσετε αυτήν τη λειτουργία σε μόλις πέντε λεπτά. Ενώ η διαδικασία είναι εύκολο να ολοκληρωθεί, θα πρέπει να γνωρίζετε ακόμη ορισμένα βασικά στοιχεία για τα σχόλια XML και τη χρησιμότητά τους πριν ξεκινήσετε.
Γιατί τα σχόλια XML είναι χρήσιμα
Τα σχόλια σε XML είναι σχεδόν ίδια με τα σχόλια σε HTML, καθώς και τα δύο έχουν την ίδια σύνταξη. Χρησιμοποιώντας σχόλια σας επιτρέπει να κατανοήσετε τον κώδικα που γράψατε χρόνια πριν. Μπορεί επίσης να βοηθήσει έναν άλλο προγραμματιστή που εξετάζει τον κώδικα που έχετε αναπτύξει να κατανοήσει τι έχετε γράψει. Εν ολίγοις, αυτά τα σχόλια παρέχουν το πλαίσιο για τον κώδικα.
Με σχόλια, μπορείτε εύκολα να αφήσετε μια σημείωση ή να αφαιρέσετε προσωρινά μέρος ενός κώδικα XML. Παρόλο που το XML έχει σχεδιαστεί έτσι ώστε να είναι "αυτο-περιγραφόμενα δεδομένα", μερικές φορές ίσως χρειαστεί να αφήσετε ένα σχόλιο XML.
Ξεκινώντας
Οι ετικέτες σχολίων αποτελούνται από δύο μέρη: το μέρος που ξεκινά το σχόλιο και το μέρος που το τελειώνει. Για να ξεκινήσετε, προσθέστε το πρώτο μέρος της ετικέτας σχολίων:
Στη συνέχεια, γράψτε ό, τι σχόλιο θέλετε. Απλώς βεβαιωθείτε ότι δεν τοποθετείτε σχόλια σε άλλα σχόλια (δείτε συμβουλές για περισσότερες λεπτομέρειες). Μετά από αυτό, θα κλείσετε την ετικέτα σχολίου:
-->
Χρήσιμες συμβουλές
Κατά την προσθήκη σχολίων αναφοράς στον κώδικα XML, θυμηθείτε ότι δεν μπορούν να βρίσκονται στην κορυφή του εγγράφου σας. Στην XML, μόνο η δήλωση XML μπορεί να είναι πρώτη:
Όπως αναφέρθηκε παραπάνω, τα σχόλια ενδέχεται να μην είναι ένθετα το ένα μέσα στο άλλο. Πρέπει να κλείσετε το πρώτο σας σχόλιο προτού ανοίξετε ένα δεύτερο. Επίσης, δεν είναι δυνατή η εμφάνιση σχολίων εντός ετικετών, π.χ.
.
Ποτέ μην χρησιμοποιείτε τις δύο παύλες (-) οπουδήποτε αλλά στην αρχή και στο τέλος των σχολίων σας. Οτιδήποτε στα σχόλια είναι ουσιαστικά αόρατο από το Αναλυτής XML, λοιπόν, να είστε πολύ προσεκτικοί ώστε αυτό που απομένει να είναι έγκυρο και καλά σχηματισμένο.
Τυλίγοντας
Εάν εξακολουθείτε να έχετε ερωτήσεις σχετικά με την προσθήκη σχολίων αναφοράς σε κώδικα XML, ίσως θελήσετε να διαβάσετε ένα βιβλίο για να σας δώσει μια λεπτομερή εικόνα για το πώς λειτουργεί η διαδικασία. Βιβλία όπως"C # 5.0 Αναφορά προγραμματιστή" από τον Rod Stephens μπορεί να αποδειχθεί χρήσιμο.