C#

C# 주석에 λŒ€ν•œ XML νƒœκ·Έ

🟦 XML νƒœκ·Έ

- summary κΈ°λŠ₯을 μ‚¬μš©ν•˜λ©΄ λ©”μ„œλ“œμ™€ νŒŒλΌλ―Έν„°μ— λŒ€ν•œ μ„€λͺ…이 뜨기 λ•Œλ¬Έμ— λ”μš± νŽΈλ¦¬ν•˜λ‹€.

 

🟧 document

https://docs.microsoft.com/ko-kr/dotnet/csharp/language-reference/xmldoc/

 

XML λ¬Έμ„œ 주석 - /// 주석을 μ‚¬μš©ν•˜μ—¬ API λ¬Έμ„œν™”

XML λ¬Έμ„œ 주석에 λŒ€ν•΄ μ•Œμ•„λ΄…λ‹ˆλ‹€. 특수 주석 ν•„λ“œμ— XML μš”μ†Œλ₯Ό λ„£μ–΄ μ½”λ“œμ˜ μ„€λͺ…μ„œλ₯Ό λ§Œλ“€ 수 μžˆμŠ΅λ‹ˆλ‹€. λ‹€λ₯Έ 도ꡬλ₯Ό μ‚¬μš©ν•˜μ—¬ μ£Όμ„μ—μ„œ λ¬Έμ„œ λ ˆμ΄μ•„μ›ƒμ„ λΉŒλ“œν•  수 μžˆμŠ΅λ‹ˆλ‹€.

docs.microsoft.com

 

 

 

🟧 Class

- μŠ¬λž˜μ‹œ( / ) μ„Έλ²ˆ μž…λ ₯ ν›„ <summary> νƒœκ·Έ μž…λ ₯

- μ£Όμ„μœΌλ‘œ μž…λ ₯ν•  λΆ€λΆ„ λͺ¨λ‘ μŠ¬λž˜μ‹œ 3λ²ˆμ„ μ•žμ— μž…λ ₯ν•΄μ€˜μ•Όν•œλ‹€.

- summary νƒœκ·Έ μ•ˆμ— ν΄λž˜μŠ€μ— λŒ€ν•œ μ„€λͺ…을 μž‘μ„±

 

 

 

- λ‹€λ₯Έ μŠ€ν¬λ¦½νŠΈμ—μ„œ ν•΄λ‹Ή 클래슀λ₯Ό μ„ μ–Έν•  λ•Œ summary둜 μž‘μ„±ν–ˆλ˜ 주석이 λ‚˜νƒ€λ‚œλ‹€.

 

 

 

🟧 Method

- ν•¨μˆ˜μ— λŒ€ν•΄μ„œλ„ 주석을 달 수 μžˆλ‹€.

- summary : ν΄λž˜μŠ€μ™€ λ§ˆμ°¬κ°€μ§€λ‘œ ν•¨μˆ˜μ— λŒ€ν•œ μ„€λͺ…

- param : μΈμžμ— λŒ€ν•œ μ„€λͺ…

- returns : λ°˜ν™˜κ°’μ— λŒ€ν•œ μ„€λͺ…

 

 

 

- λ©”μ„œλ“œλ₯Ό ν˜ΈμΆœν•  λ•Œ 주석에 μž‘μ„±ν•œ λ‚΄μš©λ“€μ΄ λœ¬λ‹€.

'C#' μΉ΄ν…Œκ³ λ¦¬μ˜ λ‹€λ₯Έ κΈ€

[C#] Nullable Type  (0) 2022.11.14
[C#] ref & out  (0) 2022.10.26
Interface, Abstract, Virtual  (0) 2021.11.12