8

Al crear documentación XML para los métodos de C# en Visual Studio (estoy usando 2010), que reciben apoyo Intellisense para la creación de las diversas etiquetas XML, tales como ver, paramref, etc. En Por otro lado, cuando agrega un atributo de un cref, debe usar un, que creo que es un formato complicado para describir los tipos. Esto es peor cuando tienes varios genéricos.Visual Studio IntelliSense para de CREF en la documentación XML

Lo que estoy buscando es el siguiente. Si está configurando el atributo cref en un elemento see, tiene una lista Intellisense de clases que coinciden con lo que ha escrito hasta el momento y luego muestra la descripción de tipo adecuada necesaria. O cuando configura el atributo cref en un elemento paramref, recibe la lista de parámetros de ese método.

¿Alguien sabe de algún tipo de complemento para Visual Studio proporciona a Intellisense para estos atributos CREF?

+0

No es un complemento per se, sino ** cambiar a VB.NET le conseguirá este **. El IDE de VB.NET es totalmente compatible con la autocompletación de IntelliSense para los atributos 'cref' y muchos otros. Siempre me ha frustrado que esto sea otra cosa más de lo que carece el C# IDE. –

Respuesta

4

He estado escribiendo mucha documentación XML recientemente, y creo que ReSharper proporciona la funcionalidad que está buscando con su función Extended IntelliSense Code Completion - La uso todo el tiempo. La característica Quick Documentation no debe ser pasado por alto cuando escribiendo documentación o bien - con ella, se puede ver lo que la documentación XML en realidad se verá como cuando se compila a html/CHM, y se actualiza en tiempo real, por lo que si cambio algo en el documentos con la ventana de Documentación rápida, la veo cambiar automáticamente, realmente útil para el formateo y tal.

Si agrega Agent Smith a la mezcla (que sólo funciona como un add-on para ReSharper, al parecer), se puede añadir un poco de práctica comprobación de ortografía, XML Comentario de validación, nombrando cheques Convención y algunos simple comentario -reflujo (si prefieres quedarte dentro de una cierta cantidad de caracteres/línea) (probablemente los primeros dos sean los más útiles, ya que ReSharper ofrece la posibilidad de imponer convenciones de nomenclatura).

Espero que ayude!

+0

Gracias por esa pista; me ha llevado a la mitad de averiguar cómo construir una ! (Que es 'MyClass.op_Implicit', si solo hay una conversión definida por el usuario definida, pero no puedo entender cómo diferenciar entre dos o más ... –

+0

Entonces, para la posteridad, [MS dice que la forma correcta] (http://msdn.microsoft.com/en-us/library/fsbx0t7x%28v=vs.80%29.aspx) es '', pero ya sea R # o VS o ambos no están contentos con esa tilde. Oh bien. –

Cuestiones relacionadas