VS 2010에서 변수/필드/목록에 대한 의견/설명서를 작성하는 방법은 무엇입니까?

Question

는 클래스 나 메소드에 대한

///<summary> 
///This is summary for some class or method 
///</summary> 

문서가있다. 그러나 이것을 간단한 변수 나리스트에 쓰는 방법은 무엇입니까?

저는 Visual Studio 2010을 사용하며 일부 목록, 속성 또는 내가 그 특정 도구에 대해 요약 한 일종의 요약을보고 싶습니다.

///<doc> 
///always use this list! 
List<String> beer = new List<String>(); 

편집 : 좋아, 우리가 클래스에 있지만, 방법 또는 함수 외부 긴 U의 주석으로 평소와 같이 작동하는지, 발견했다!

방법 내에서 문서/댓글을 쓰는 방법은 무엇입니까?

public class BeerForall 
{ 
    /// <summary> 
    /// it works here 
    /// </summary> 
    public List<String> beer = new List<string>(); 

    public String giveBeer() 
    { 
     /// is not working, u can not comment 
     /// <summary> 
     /// test test, not working 
     /// </summary> 
     List<String> moreBeer = new List<string>(); 

     return "beer"; 
    } 
} 

Answer 1

Visual Studio 2010에서 완벽하게 작동합니다. List를 내 MainForm 클래스 내에 주석이있는 개인 필드로 정의했습니다.

함수 내에서 정의 된 로컬 변수 에는 작동하지 않습니다.

Answer 2

변수 및 메서드에 대한 요약 작업을 작성하는 것과 같은 방법으로 변수에 대한 작업을 수행합니다.

Answer 3

회원 (메서드, 속성 등)이 아닌 멤버에 XML documentation 개의 의견을 추가 할 수 있습니다.

Answer 4

는 지금까지 내가 아는 한, 인텔리에 대한 추가 의견 함수 내에서 선언 된 지역 변수에 대해 작동하지 않습니다. 지역 목록을 클래스의 인스턴스 변수로 만들려면이 작업을 수행 할 수 있어야합니다.

Answer 5

다른 언급했듯이 로컬 바를위한 IntelliSense를 얻을 수 없습니다. 그러나 : 함수가 너무 커서 "일반"주석이 var를 사용하는 곳 근처에서 읽을 수 없을만큼 가까운 경우에는 올바른 수정은 함수를 리팩토링하는 것입니다. 더 적은 vars로 더 작은 방법. 나는이 기능이 이이되어야한다고 생각하지 않습니다. 너무 큰 기능을 쓰기 쉽게하기 위해서입니다.

Answer 6

편집 : <와 같습니다. var >은 JavaScript에서만 지원됩니다.

Visual Studio 2012에서 <var> 요소를 사용하여이 설명서를 추가 할 수 있습니다.

는 여기에 마이크로 소프트의 문서입니다 :
https://msdn.microsoft.com/en-us/library/hh542722(v=vs.110).aspx