�@

.NET TIPS

C#��MSDN���C�u��������API���t�@�����X���쐬����ɂ́H

�f�W�^���A�h�o���e�[�W
2004/07/16

�@Visual Studio .NET�i�ȍ~�AVS.NET�j��C#�‹��ł���Visual C# .NET�ł́A�W���@�\�Ƃ��āA���̉�ʂ̂悤��API���t�@�����X�iVS.NET�ł́u�R�[�h�E�R�����gWeb���|�[�g�v�ƌĂ�ł���j���쐬�ł���i�ڂ����́uVisual C# .NET��API���t�@�����X�����i�O�ҁj�^�i��ҁj�v���Q�Ƃ��ꂽ���j�B����API���t�@�����X�́A�\�[�X�E�R�[�h���ɃR�����g���Ƃ��ċL�q���ꂽXML�^�O�i�u�h�L�������g�E�R�����g�̃^�O�v�ƌĂ΂��j����ɍ쐬���ꂽ���̂��B

VS.NET�́u�R�[�h �R�����gWeb���|�[�g�v
VS.NET�ɂ�API���t�@�����X�i�u�R�[�h �R�����gWeb���|�[�g�v�ƌĂ΂��j���o�͂���@�\���W�����ڂ���Ă���B����API���t�@�����X�́AVS.NET��IDE�ɂ��郁�j���[�E�o�[�́m�c�[���n�|�mWeb�y�[�W�̃r���h �R�����g�n����o�͂ł���B

�@����������API���t�@�����X�ł́AMSDN���C�u�����̃y�[�W�ʼn����ɂ���悤�ȁu�Q�Ɓv�̍��ڂ��lj��ł��Ȃ�������AMSDN���C�u�����̂悤��HTML�w���v�`���i.chm�t�@�C���j���o�͂ł��Ȃ�������*�ƁA�g�����肪�����Ƃ��낪����B�����Ŗ{�e�ł́A���̂悤�ȕs�����������閳����API���t�@�����X�쐬�c�[���uNDoc�v���Љ��B

* MSDN�uMicrosoft Help Technologies�v�ɂ���uVisual Studio .NET Help Integration Kit�iMicrosoft Help 2�`���j�v��uHTML Help Workshop�iHTML Help 1.4�`���j�v���g���΁AHTML�w���v�`���ɕϊ��͉”\�B

�@NDoc�́AMSDN���C�u������API���t�@�����X��HTML�w���v�E�t�@�C���𐶐����邽�߂̃c�[�����B���̃c�[�����g���΁A���̉�ʂ̂悤��API���t�@�����X���쐬�ł���B

NDoc�ɂ��API���t�@�����X
NDoc�Ȃ�HTML�w���v�`����MSDN���C�u������API���t�@�����X���쐬�ł���B
�@ NDoc�ł́m�Q�Ɓn�ɓƎ��̍��ڂ�lj����邱�Ƃ��ł���B�u�Q�Ɓv���ڂɑΉ�����h�L�������g�E�R�����g��<seealso>�^�O��VS.NET�ɂ��W���T�|�[�g����Ă���B������VS.NET�́u�R�[�h �R�����gWeb���|�[�g�v�ł́A�Ȃ����u�Q�Ɓv���ڂ�API���t�@�����X���ɕ\������Ȃ��B

�@����ł́A������������NDoc���C���X�g�[�����Ă݂悤�B

NDoc�̃C���X�g�[��

�@NDoc�͎��̃T�C�g����_�E�����[�h�ł���B�����Ń_�E�����[�h����t�@�C���́A�undoc-jp-installer�v�Ə�����Ă���C���X�g�[���t�̃p�b�P�[�W���B

�@�_�E�����[�h����NDoc�̃C���X�g�[���iNDocWebSetup_jp.exe�j�����s����΃C���X�g�[���͊�������B�r���ŁuAUTHENTICODE���������o�ł��܂���B�v�Ƃ������Z�L�����e�B�x�����\�������ꍇ�����邪�A���ɖ��Ȃ���΂��̂܂ܑ��s���āA�w���ǂ���ɍŌ�܂ŃC���X�g�[�������������Ăق����B

�@�C���X�g�[�����I����NDoc���g�����Ƃ͂ł��邪�A���ۂ�API���t�@�����X�𐶐����邽�߂ɂ́A���炩���ߕK�v�ȃt�@�C�����������Ă����K�v������B

XML�h�L�������g�E�t�@�C���̏o��

�@NDoc�ŕK�v�ƂȂ�t�@�C���́AVisual C# .NET�̃v���W�F�N�g�Ɋ܂܂��ȉ���2��ނ̃t�@�C�����B

  • �A�Z���u���E�t�@�C���i�r���h�ɂ��쐬�����EXE�t�@�C����DLL�t�@�C���j

  • XML�h�L�������g�E�t�@�C���i�r���h���Ƀh�L�������g�E�R�����g����ɒ��o�����XML�t�@�C���j

�@XML�h�L�������g�E�t�@�C���̕��́A�v���W�F�N�g�̐ݒ肪�f�t�H���g�̂܂܂ł͏o�͂���Ȃ��̂ŁA���炩���߃v���W�F�N�g�̃v���p�e�B��ύX���Ă����K�v������B����ɂ́A���̉�ʂ̂悤�ɁA�v���W�F�N�g�́m�v���p�e�B �y�[�W�n�_�C�A���O�ŁmXML �h�L�������g �t�@�C���n���ڂɁu�o�͂���t�@�C�����i�������̓t�@�C���E�p�X�j�v����͂���΂悢�B

XML�h�L�������g�E�t�@�C���̏o�͐ݒ�
�v���W�F�N�g�́m�v���p�e�B �y�[�W�n�_�C�A���O�ŁA�r���h����XML�h�L�������g�E�R�����g�̃t�@�C�����o�͂����悤�ɐݒ肷��B
�@ �m�\���v���p�e�B�n�t�H���_�̒��ɂ���m�r���h�n���ڂ�I������B
�@ �m�o�́n���ڂ̒��ɂ���mXML �h�L�������g �t�@�C���n�Ƀt�@�C�����i�������̓t�@�C���E�p�X�j����͂���B����ɂ��AXML�h�L�������g�E�t�@�C���i.xml�t�@�C���j���w�肵�����O�Łi�������͏ꏊ�Ɂj�o�͂����悤�ɂȂ�B

�@���̐ݒ�ɂ��A�r���h���s������ɂ́mXML �h�L�������g �t�@�C���n�Ɏw�肵���t�@�C�����i�������̓t�@�C���E�p�X�j��XML�h�L�������g�E�t�@�C���i.xml�t�@�C���j���o�͂����悤�ɂȂ�B

�@�ȏ��NDoc���g�����߂̏����͊��������B����NDoc�����ۂɎg���Ă݂悤�B

NDoc�̎g�p���@

�@NDoc�̎g�����͊ȒP���B�����ł͊�{�I�ȍ�Ƃ̗���ɂ‚��Ă̂ݐ�������B

�@�܂��m�X�^�[�g�n���j���[����m�v���O�����n�|�mNDoc�n�|�mNDoc�n��I������NDoc���N������B�����Ď��̉�ʗ�̂悤�ɁA�mAdd�n�{�^���������ām�A�Z���u���E�t�@�C����XML�h�L�������g�E�t�@�C���̒lj��iAdd Assembly Filename and XML Documentation Filename�j�n�_�C�A���O���J���A�v���W�F�N�g�̃r���h�ɂ��o�͂��ꂽ�A�Z���u���E�t�@�C����XML�h�L�������g�E�t�@�C�����w�肷��B

�A�Z���u���E�t�@�C����XML�h�L�������g�E�t�@�C���̎w��
API���t�@�����X���o�͂������v���O�����̃A�Z���u���E�t�@�C����XML�h�L�������g�E�t�@�C�����w�肷��B
�@ �mAdd�n�{�^�����N���b�N����Ɓm�A�Z���u���E�t�@�C����XML�h�L�������g�E�t�@�C���̒lj��iAdd Assembly Filename and XML Documentation Filename�j�n�_�C�A���O���\�������B
�@ �v���W�F�N�g�Ɋ܂܂��A�Z���u���E�t�@�C�����w�肷��B
�@ �v���W�F�N�g�Ɋ܂܂��XML�h�L�������g�E�t�@�C�����w�肷��B
�@ �mOK�n�{�^�����N���b�N���Đݒ���e���m�肵�A�_�C�A���O��‚���B
�@ API���t�@�����X���o�͂���v���O�����i�A�Z���u���E�t�@�C���j���o�^�����B

�@��́A�c�[���o�[�́m�h�L�������g�̃r���h�iBuild Documentation�j�n�{�^�����N���b�N����API���t�@�����X�̃r���h���s���A�c�[���o�[�́m�h�L�������g�̎Q�ƁiView Documentation�j�n�{�^�����N���b�N����API���t�@�����X��\������΂悢�B

API���t�@�����X�̃r���h�ƎQ��
API���t�@�����X�𐶐�����ɂ̓r���h���s���K�v������B�r���h����API���t�@�����X��NDoc����N�����ĎQ�Ƃ��邱�Ƃ��ł���B
�@ �c�[���o�[�́m�h�L�������g�̃r���h�iBuild Documentation�j�n�{�^�����N���b�N����ƁAAPI���t�@�����X�̃r���h���s����B
�@ �c�[���o�[�́m�h�L�������g�̎Q�ƁiView Documentation�j�n�{�^�����N���b�N����ƁA�r���h�Ő������ꂽAPI���t�@�����X���\�������B
�@ NDoc�ł�MSDN���C�u��������API���t�@�����X�����łȂ��AJavaDoc����API���t�@�����X�ȂǁA���܂��܂ȃ^�C�v�̂��̂𐶐��ł���B
�@ ���̃v���p�e�B�ݒ��ύX���邱�ƂŁAAPI���t�@�����X�̍\�����e�i�Ⴆ�΁A�t�@�C���̏o�͏ꏊ�Ȃǁj���J�X�^�}�C�Y�ł���B

�@�ȏ�̑���ɂ��A�`���ŏЉ���悤��MSDN���C�u��������API���t�@�����X���\�������͂����B

�@�Ȃ��A�\�[�X�E�R�[�h���ɋL�q����u�h�L�������g �R�����g�̃^�O�v�̓��e��L�q���@�ɂ‚��ẮAMSDN���C�u�����uXML�h�L�������g�v��`���ŏЉ���uVisual C# .NET��API���t�@�����X�����i�O�ҁj�^�i��ҁj�v�Ȃǂ��Q�Ƃ��Ă������������BNDoc�̃��j���[�E�o�[����mHelp�n�|�mDocumentation Tags Reference�n��I�����邱�Ƃŕ\�������uNDoc �ŃT�|�[�g����^�O�v���Q�l�ɂȂ�BEnd of Article

�J�e�S���F�J���‹����c�[���@�����ΏہFAPI���t�@�����X
�J�e�S���F�N���X�E���C�u�����@�����ΏہFWin32 API
�@
���̋L���Ɗ֘A���̍����ʂ�.NET TIPS
�mASP.NET�n�C�ӂ�XML�t�@�C������T�C�g�E���j���[���쐬����ɂ́H
���̃��X�g�́A�i���j�f�W�^���A�h�o���e�[�W���J������
�����֘A�L���T���V�X�e�� Jigsaw�i�W�O�\�[�j �ɂ�莩�����o�������̂ł��B
generated by

�u.NET TIPS�v


Insider.NET �t�H�[���� �V���L��
  • ��2��@�Ȍ��ȃR�[�f�B���O�̂��߂� �i2017/7/26�j
    �@�����_���ŋL�q�ł��郁���o�̑����Athrow���Aout�ϐ��A�^�v���ȂǁAC# 7�ɂ͈ȑO�����R�[�h���Ȍ��ɋL�q�ł���悤�ȋ@�\����������Ă���
  • ��1��@Visual Studio Code�f�o�b�O�̊�b�m�� �i2017/7/21�j
    �@Node.js�v���O�������f�o�b�O���Ȃ���AVisual Studio Code�ɓ�������Ă���f�o�b�O�@�\�̊�{�́u�L�v���}�X�^�[���悤
  • ��1��@���ĂȃR�[�f�B���O�̂��߂� �i2017/7/19�j
    �@C# 7�Œlj����ꂽ�V�@�\�̒�����A�u���l���e�����\���̉��P�v�Ɓu���[�J���֐��v���Љ��B�����͕�����₷���R�[�h���L�q����̂Ɏg����
  • Presentation Translator �i2017/7/18�j
    �@Presentation Translator��PowerPoint�p�̃A�h�C���B�v���[���e�[�V�������̎����̕t����A������ł̎��^�����A�X���C�h�̖|����s����
��IT���[���}�K�W���@�V������X�^�b�t�̃R���������[���œ͂��܂��i�����j

���ڂ̃e�[�}

Insider.NET �L�������L���O

�{�� ����