Capítulo 11:

 Documentos de códigos. Etiquetas (2/5)

<exception>. Especifica las excepciones que se pueden producir.

Sintaxis:

<exception cref="member">Descripción</exception>

Parámetros:

cref. Referencia a una excepción disponible desde el entorno de compilación actual. El compilador comprueba si existe la excepción dada y convierte member al nombre de elemento canónico en el resultado XML. member debe aparecer entre comillas dobles (" ").

Descripción. Descripción de la excepción.

Se utiliza la etiqueta <exception> para especificar las excepciones que se pueden producir. Esta etiqueta se aplica a una definición de método.

Ejemplo:

/// <exception cref="System.Exception">Lanzar cuando Matriz es null</exception> static void Main(string[] args) { string[] Matriz; }

<include>. La etiqueta <include> permite hacer referencia a comentarios colocados en otro archivo que describen los tipos y miembros del código fuente. Ésta es una alternativa al método habitual de colocar los comentarios

de la documentación directamente en el archivo de código fuente. La etiqueta <include> utiliza la sintaxis XPath de XML.

Sintaxis:

<include file='fichero' path='tagpath[@nombre="id"]' />

Parámetros:

* Fichero. Nombre del archivo que contiene la documentación. El nombre de archivo se puede completar con una ruta de acceso. Agregue filename entre comillas simples (' ').

* Tagpath. Ruta de acceso de las etiquetas de filename que conduce a la etiqueta name. La ruta de acceso va entre comillas simples (' ').

* Nombre. Especificador de nombre en la etiqueta que precede a los comentarios; Nombre poseerá un id.

* Id. Identificador para la etiqueta que precede a los comentarios. El id va entre comillas dobles (" ").

Ejemplo:

/// <include file='xml_include_tag.doc' /// path='MyDocs/MyMembers[@name="test"]/*' /> class Test {}

<list>. El bloque <listheader> se utiliza para definir la fila de encabezado de una tabla o de una lista de definiciones. Cuando se define una tabla, sólo es necesario suministrar una entrada para un término en el encabezado.

Cada elemento de la lista se especifica con un bloque <item>. Cuando se crea una lista de definiciones, se deberán especificar tanto term como description. Sin embargo, para una tabla, lista con viñetas o lista numerada, sólo es necesario suministrar una entrada para description. Una lista o una tabla pueden tener tantos bloques <item> como sean necesarios.

Sintaxis:

<list type="bullet" | "number" | "table"> <listheader> <term>Termino</term> <description> Descripción…...</description> </listheader> <item> <term>term</term> <description>Descripción…...</description> </item>

Cursos similares a Diseño de Aplicaciones Orientadas a Objetos (2/3)

1. Diseño de Aplicaciones Orientadas a Objetos (1/3) En esta oportunidad deseamos enseñarte un nuevo curso de programación en el cual... [05/10/11]				91
2. Actionscript 3. Objetos Objetos AS3 . Entra a nuestro tutorial de Actionscript 3 y aprende el lenguaje de... [04/07/11]				121
3. PHP y MySQL. Aplicaciones Web: programación (primera parte) Programación de aplicaciones Web con PHP y MySQL. Con este curso aprenderás el... [02/12/08]				5.012