C#의 XML 주석 사용 CREF 속성 사용 Params 구문이 있습니다.

Question

C#에서는 사용하려고합니다u003Csee cref="blah"/> Params 키워드가 포함 된 메소드 서명을 참조합니다. 이것이 매개 변수 목록을 배열로 변환한다는 것을 알고 있지만 CREF 속성의 배열을 참조하는 방법조차 알 수 없습니다. 나는 내 검색에서 아무것도 찾지 못하고 내가 아는 사람도 아무도 모른다. 컴파일러가 사각형 괄호에서 질식하고 있습니다. 곱슬 괄호를 사용하여 배열 클래스를 사용하여 모든 종류의 다른 조합을 시도했지만 아무것도 작동하지 않습니다. 누구든지 이것을 알고 있습니까?

Answer 1

ECMA 334 표준 PDF, 부록 e에는 XML 문서 주석에 대한 괜찮은 개요가 포함되어 있습니다. 표준을 다운로드 할 수 있습니다.

http://www.ecma-international.org/publications/standards/ecma-334.htm

구체적으로, 496 페이지에서 시작하는 E.3.1 섹션을 원할 것입니다.

비슷한 내용은 MSDN에도 있습니다 (MSDN 은이 주제에 대해 끔찍한 내비게이션을 가지고있어 다른 섹션을 찾기가 어렵습니다).

http://msdn.microsoft.com/en-us/library/aa664787(vs.71).aspx

E.3.1에 해당하는 것 :

http://msdn.microsoft.com/en-us/library/aa664807(vs.71).aspx

모노의 문서화가 유용하다고 생각할 수도 있습니다.

http://www.go-go-mono.com/docs/index.aspx?tlink=29@man%3amdoc(5)

특이 적으로, "cref 형식"섹션은 ID 문자열 규칙을 다룹니다.

업데이트 2018/05/23

위의 ECMA-334 표준 PDF의 URL은 표준의 최신판으로 링크됩니다. 2009 년에는 표준의 4 판이었습니다. 그러나 2017 년 12 월 현재 5 판은 현재이며, 4 판의 E.3.1은 5 판에서 D.4.2 섹션이되었습니다.

ECMA-334 표준의 이전 버전은 다음 페이지에서 다운로드 할 수 있습니다. https://www.ecma-international.org/publications/standards/ecma-334-arch.htm

Answer 2

에 따르면 b.3.1 ID 문자열 형식 기사, 배열 참조는 [Square Brackets]로 수행됩니다 (선택 사항 lowerbound:size Specifiers) 그러나 특정 유형 (또는 객체 배열)의 배열을 참조하려면 글을 쓸 수 없습니다.

<see cref="Object[]"/>

대신 당신은 당신이 T: 접두사, 좋아요

<see cref="T:Object[]"/>

다음과 같은 방법의 특정 오버로드를 참조 할 때는 적용되지 않는 것 같습니다.

<seealso cref="String.Join(String, String[])"/>

Answer 3

당신은 단지 Param 키워드를 제거하고 다음과 같은 유형에 넣습니다.

/// <summary>
/// <see cref="Method(string[])"/>
/// </summary>
public static void Main()
{
    Method("String1", "String2");
}

public static void Method(params string[] values)
{
    foreach (string value in values)
    {
        Console.WriteLine(value);
    }
}