2011-09-07 7 views
7

요약 태그 주석을 지정할 때 <param> 태그를 사용하면 매개 변수가 선택적이라는 것을 알 수 있습니다. 클라이언트는 다음과 같은 값이나 널을 제공 할 수 있습니다. <param name="Mime" optional="true">.Visual Studio - 요약 태그 설명 - 선택적 매개 변수

Google에서 속성 또는 허용 된 값의 세트 목록을 제공하지 못했습니다.

/// <summary> 
/// Sets data associated with instance 
/// </summary> 
/// <param name="Key">The key defining the data</param> 
/// <param name="Value">The data</param> 
/// <param name="Mime">The mime type of the data (optional)</param>  <----- Mark as optional 

감사

+2

을 때 당신은 간단하게 할 수 메서드를 오버로드하고 해당 매개 변수를 제외하는 시그니처가 있습니까? – canon

+2

오버로드가 고려되었지만이 특정 예에서는 오버로드가 결정되었습니다. – cweston

+0

왜 그런가? – canon

답변

5

아니요, 불가능합니다. VS에 의해 인식되는 유일한 속성은 같은 name입니다 : 당신이 할 수있는

<param name="FileName" >The filename of the file to be loaded.</param> 

있는 유일한 방법은 - 당신의 출력 문서에 대한 xsl transform을 설정하는 것입니다. 그러나 이것은 Intellisense에 아무런 영향을 미치지 않습니다.

1

당신은 <remarks></remarks> 태그를 사용할 수 있습니다. 선택적 매개 변수에 대한 특수 태그가 없습니다.

1

당신은 선택적 매개 변수 생략 과부하 제공해야한다 : 또는

/// <summary> 
/// Sets data associated with the instance using the default media type. 
/// </summary> 
/// <param name="key">The key defining the data.</param> 
/// <param name="value">The data.</param> 
public void SetData(object key, object value) 
{ 
    SetData(key, value, null); 
} 

/// <summary> 
/// Sets data associated with the instance using the specified media type. 
/// </summary> 
/// <param name="key">The key defining the data.</param> 
/// <param name="value">The data.</param> 
/// <param name="mime">The media type of the data.</param> 
public void SetData(object key, object value, string mime) 
{ 
    ... 
} 

을, 당신은 같은 옵션 매개 변수를 선언 할 수 있습니다 : 당신은 왜 선택적 매개 변수를 나타내는 귀찮게 것

/// <summary> 
/// Sets data associated with the instance. 
/// </summary> 
/// <param name="key">The key defining the data.</param> 
/// <param name="value">The data.</param> 
/// <param name="mime">The media type of the data.</param> 
public void SetData(object key, object value, string mime = null) 
{ 
    ... 
}