๋ณธ๋ฌธ ๋ฐ”๋กœ๊ฐ€๊ธฐ
๐ŸŽฎunity/C#

C# ์ฃผ์„์— ๋Œ€ํ•œ XML ํƒœ๊ทธ

by ojui 2021. 11. 1.
๋ฐ˜์‘ํ˜•

๐ŸŸฆ 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 : ๋ฐ˜ํ™˜๊ฐ’์— ๋Œ€ํ•œ ์„ค๋ช…

 

 

 

- ๋ฉ”์„œ๋“œ๋ฅผ ํ˜ธ์ถœํ•  ๋•Œ ์ฃผ์„์— ์ž‘์„ฑํ•œ ๋‚ด์šฉ๋“ค์ด ๋œฌ๋‹ค.

๋ฐ˜์‘ํ˜•

'๐ŸŽฎunity > C#' ์นดํ…Œ๊ณ ๋ฆฌ์˜ ๋‹ค๋ฅธ ๊ธ€

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