Agregar comentarios de referencia a su código XML

Obtenga los hechos con esta guía paso a paso Si está interesado en agregar comentarios de referencia a su código XML, use este tutorial paso a paso como guía. Puede aprender a ejecutar esta función en solo cinco minutos.

Obtenga los hechos con esta guía paso a paso

Si está interesado en agregar comentarios de referencia a su código XML, use este tutorial paso a paso como guía. Puede aprender a ejecutar esta función en solo cinco minutos. Si bien el proceso es fácil de completar, aún debe conocer algunos conceptos básicos sobre los comentarios XML y su utilidad antes de comenzar.

Por qué son útiles los comentarios XML

Los comentarios en XML son casi idénticos a los comentarios en HTML, ya que ambos tienen la misma sintaxis. El uso de comentarios le permite comprender el código que escribió años antes. También puede ayudar a otro desarrollador que está revisando el código que desarrolló para comprender lo que escribió. En resumen, estos comentarios proporcionan contexto para el código.

Con comentarios, puede dejar fácilmente una nota o eliminar temporalmente parte de un código XML. Aunque XML está diseñado para ser «datos autodescriptivos», en ocasiones es posible que deba dejar un comentario XML.

Empezando

Las etiquetas de comentarios constan de dos partes: la parte que comienza el comentario y la parte que lo termina. Para comenzar, agregue la primera parte de la etiqueta de comentario:

  

Luego escribe cualquier comentario que quieras. Solo asegúrese de no anidar comentarios dentro de otros comentarios (consulte los consejos para obtener más detalles). Después de eso, cerrará la etiqueta de comentario:

 -> 

Consejos útiles

Cuando agregue comentarios de referencia a su código XML, recuerde que no pueden aparecer en la parte superior de su documento. En XML, solo la declaración XML puede venir primero:

 

Como se mencionó anteriormente, los comentarios no pueden estar anidados uno dentro de otro. Debe cerrar su primer comentario antes de abrir un segundo. Además, los comentarios no pueden aparecer dentro de las etiquetas, p.

. 

Nunca use los dos guiones (-) en ningún lugar excepto al principio y al final de sus comentarios. Cualquier cosa en los comentarios es efectivamente invisible para el analizador XML, así que tenga mucho cuidado de que lo que queda todavía sea válido y esté bien formado.

Terminando

Si aún tiene preguntas sobre cómo agregar comentarios de referencia al código XML, es posible que desee leer un libro para obtener una imagen detallada de cómo funciona el proceso. Los libros como «C # 5.0 Programmer’s Reference» de Rod Stephens pueden ser útiles.

Rate article
labsfabs.com
Add a comment