¿Cómo personalizo el texto de comentarios automáticos en Visual Studio?
-
06-07-2019 - |
Pregunta
Cuando escribo el disparador, la función de comentario automático en Visual Studio (al escribir " '' '" o " /// "), la mayoría de los detalles de comentarios de XML se muestran como me gusta. Sin embargo, normalmente agrego la etiqueta de historial a la documentación para poder realizar un seguimiento y los cambios que se realizan en el método a lo largo del tiempo.
¿Hay alguna forma en que pueda personalizar la función de comentarios automáticos para que agregue la etiqueta de historial y potencialmente algún nombre genérico - Fecha - Cambiar el texto del marcador de posición?
Solución
Sugiero usar GhostDoc . Genera comentarios muy inteligentes utilizando /// en función de los nombres y parámetros de sus métodos. Además, es totalmente personalizable.
Otros consejos
Creo que podrías usar una herramienta como dijo Dgarcia, pero trata de elegir una que haga que el control de versiones sea insadad. Personalmente, no soy un gran fan de mantener el "historial". o seguimiento del proyecto mediante comentarios en el código.
Si te gusta, puedes crear tu propia versión personalizada del fragmento, esto es más fácil si usas una herramienta como Snippy
Copie este archivo a tu
Mis documentos \ Visual Studio 2005 \ Fragmentos de código [Idioma] \ Mis fragmentos de código \
Solo tenga cuidado de cambiar el archivo si lo va a utilizar en VB.NET
Espero esta ayuda
Como seguimiento del comentario a Olivier. Aquí hay una copia de la macro ahora, busque la sección '' Hacer historial para ver dónde inserté el código.
''// InsertDocComments goes through the current document using the VS Code Model
''// to add documentation style comments to each function.
''
Sub InsertDocComments()
Dim projectItem As ProjectItem
Dim fileCodeModel As FileCodeModel
Dim codeElement As CodeElement
Dim codeElementType As CodeType
Dim editPoint As EditPoint
Dim commentStart As String
projectItem = DTE.ActiveDocument.ProjectItem
fileCodeModel = projectItem.FileCodeModel
codeElement = fileCodeModel.CodeElements.Item(1)
''// For the sample, don't bother recursively descending all code like
''// the OutlineCode sample does. Just get a first CodeType in the
''// file.
If (TypeOf codeElement Is CodeNamespace) Then
codeElement = codeElement.members.item(1)
End If
If (TypeOf codeElement Is CodeType) Then
codeElementType = CType(codeElement, CodeType)
Else
Throw New Exception("Didn't find a type definition as first thing in file or find a namespace as the first thing with a type inside the namespace.")
End If
editPoint = codeElementType.GetStartPoint(vsCMPart.vsCMPartHeader).CreateEditPoint()
''// Make doc comment start.
commentStart = LineOrientedCommentStart()
If (commentStart.Length = 2) Then
commentStart = commentStart & commentStart.Chars(1) & " "
ElseIf (commentStart.Length = 1) Then
commentStart = commentStart & commentStart.Chars(0) & commentStart.Chars(0) & " "
End If
''// Make this atomically undo'able. Use Try...Finally to ensure Undo
''// Context is close.
Try
DTE.UndoContext.Open("Insert Doc Comments")
''// Iterate over code elements emitting doc comments for functions.
For Each codeElement In codeElementType.Members
If (codeElement.Kind = vsCMElement.vsCMElementFunction) Then
''// Get Params.
Dim parameters As CodeElements
Dim codeFunction As CodeFunction
Dim codeElement2 As CodeElement
Dim codeParameter As CodeParameter
codeFunction = codeElement
editPoint.MoveToPoint(codeFunction.GetStartPoint(vsCMPart.vsCMPartHeader))
''//editPoint.LineUp()
parameters = codeFunction.Parameters
''// Do comment.
editPoint.Insert(Microsoft.VisualBasic.Constants.vbCrLf)
editPoint.LineUp()
editPoint.Insert(Microsoft.VisualBasic.Constants.vbTab & commentStart & "<summary>")
editPoint.Insert(Microsoft.VisualBasic.Constants.vbCrLf)
editPoint.Insert(Microsoft.VisualBasic.Constants.vbTab & commentStart & "Summary of " & codeElement.Name & ".")
editPoint.Insert(Microsoft.VisualBasic.Constants.vbCrLf)
editPoint.Insert(Microsoft.VisualBasic.Constants.vbTab & commentStart & "</summary>")
editPoint.Insert(Microsoft.VisualBasic.Constants.vbCrLf)
editPoint.Insert(Microsoft.VisualBasic.Constants.vbTab & commentStart)
For Each codeElement2 In parameters
codeParameter = codeElement2
editPoint.Insert("<param name=" & codeParameter.Name & "></param>")
editPoint.Insert(Microsoft.VisualBasic.Constants.vbCrLf)
editPoint.Insert(Microsoft.VisualBasic.Constants.vbTab & commentStart)
Next ''//param
''// Do history tag.
editPoint.Insert(Microsoft.VisualBasic.Constants.vbCrLf)
editPoint.LineUp()
editPoint.Insert(Microsoft.VisualBasic.Constants.vbTab & commentStart & "<history>")
editPoint.Insert(Microsoft.VisualBasic.Constants.vbCrLf)
editPoint.Insert(Microsoft.VisualBasic.Constants.vbTab & commentStart & "Name MM/DD/YYYY [Created]")
editPoint.Insert(Microsoft.VisualBasic.Constants.vbCrLf)
editPoint.Insert(Microsoft.VisualBasic.Constants.vbTab & commentStart & "</history>")
editPoint.Insert(Microsoft.VisualBasic.Constants.vbCrLf)
editPoint.Insert(Microsoft.VisualBasic.Constants.vbTab & commentStart)
End If ''//we have a function
Next ''//code elt member
Finally
DTE.UndoContext.Close()
End Try
End Sub
Por alguna razón, después de guardar, reconstruir y reiniciar Visual Studio, no obtengo la etiqueta de historial. ¿Alguien puede ver algo aquí que me estoy perdiendo?
vb utiliza un archivo xml para cargar los datos. Es VBXMLDoc.xml y depende de la versión que esté ejecutando en cuanto a la ubicación del archivo.