2012-07-30 3 views
1

MethodAttributes (.NET) 유형의 매개 변수를 사용하는 메서드에 대한 설명서를 작성할 때 정적 멤버 또는 인스턴스 멤버 중 하나 인 멤버의 개념을 참조하는 데 어려움이있었습니다.인스턴스 또는 정적 제휴의 개념을 어떻게 설명 할 수 있습니까?

내가 여기에서했던 것처럼 정적/인스턴스 제휴 개념을 작성하지 않고 이름을 짓기 좋은 단어 나 구가 있습니까?

편집 :
API는 다음과 같습니다. 사용자가 변경할 수있는 유형이라고 부르는 것에 메소드를 추가 할 수 있습니다. Reflection.Emit의 TypeBuilder.DefineMethod 메소드와 매우 유사합니다.

public MutableMethodInfo AddMethod (
    string name, 
    MethodAttributes attributes, 
    Type returnType, 
    IEnumerable<ParameterDeclaration> parameterDeclarations, 
    Func<MethodBodyCreationContext, Expression> bodyProvider 
); 
+0

나는 맞는 대답은 맥락이라고 생각합니다. 문서화하는 클래스 및 메서드에 대한 몇 가지 추가 정보를 제공하십시오. – orangepips

답변

1

나는 방법의 품질 중 하나의 클래스 또는 인스턴스에 속하는를 캡처하는 특정 단어가 생각하지 않습니다. 처음에는 다른 언어가 어쨌든 이러한 것들을 위해 매우 다른 단어를 사용합니다. Java와 C#은 C++처럼 정적이거나 아무것도 사용하지 않습니다. Objective-C는 '-'또는 '+'를 사용하여 메소드를 표시하지만 일반적으로 클래스 또는 인스턴스 메소드를 참조합니다. 물론 자바 스크립트는 클래스가 없으므로 다시 달라질 수 있습니다.

코드에서 isStatic 또는 isClassMethod와 같은 것이 가장 좋습니다. 완벽하게 읽을 수 있고 그것이 의미하는 바에 대해서는 의문의 여지가 없어야합니다. 문서화에서는 아마도 "클래스 또는 인스턴스 메소드"또는 "인스턴스 또는 정적 메소드"와 같은 수식을 사용하는 것이 가장 좋습니다.

관련 문제