If you want to see a bunch of nerds get into a debate, just get 2 or 3 in a room and ask them about Comments and when should you Comment? How much should you Comment? Now everybody agrees that there should be Commenting in code but nobody agrees it seems on exactly how much Commenting and when to Comment. But what I want to show you in this video is how we do Comments in C#. This is pretty straightforward, it's not a huge departure from, from anybody else out there in the development world for the most part but what I'm going to do is, drag a button onto a form. Notice I did a little different way that time and, and let me delete this and go back and show you. I clicked on the button, came over here and notice I've got this little Plus sign and the little A B. Now I can drag and build the button, what size I want and when I drop it. So if you ever want a button that large, that's where you can do it or you can just drop it on there and then resize it with the handles. Right. But anyway, we'll leave our button like this and just double-click it. Now what I want to do is, when I click on this button, I'm going to create an Integer. I'll do an Integer A and I'll set it equal to 5 and then I will do a Message Box.show that says you know, Variable created and I find, don't know why I would do something this useless. But hey, I've written a lot of useless code in my time. Okay. Now notice it's giving me a little squiggly here that says that Variable A is assigned but never used. And that's okay, we'll live with that for now but, so I've written some useless code here that looks useless. But why would I want this Message Box here? I can put some Comments in here and the easy way to do this is, 2 forward slashes and notice it's turned some things green. This Message Box is totally useless and notice this is going to set everything on this line. Now something else that you can do and I'll take it away here and you can put it at the end of a line out here. Okay. And notice, this line will still execute but I have a Comment at the end. So the 2 forward slashes will put a Comment just on that line, create an Assigned Variable. Now if I want to Comment a bunch of things and this is kind of a trick a lot of people use qnd that is I want to Comment both of these lines out. Well I could come right here and put the 2 slashes on the front and that just Commented those 2 lines out. Then I have to go manually, take these things back off again alright, to undo them. I can just highlight both of these lines, let me get this one off the end down here, so I don't confuse you anymore than I probably already am. Notice if I highlight the 2 lines and I come up here on the little Toolbar and if you don't see this Toolbar, you can go up here to View Toolbars and you can see there's Standard and Text Editor. I'm working with Text Editor here but highlight these 2 lines, come up here and just click Comment. It will put 2 slashes in front of every one of those lines that I have highlighted. Then when I'm done with it, I can come highlight these lines again, click this one and Uncomment. Now this little trick with these two buttons, it's amazing how many people either forget about these or don't realize they're up there. It's a neat little trick, I noticed that if I want to Comment out a bunch of stuff, I can highlight everything and it just Commented out everything or I can undo it. Now what's interesting is, I can just keep doing this and then I have to keep undoing it to get it back. Okay. But that's one way. Then if I want to Comment a, a whole section out and not use the Toolbars, I can use the forward slash and an asterisk and notice everything after this is green. So it is Commented from here, all the way down to here. The way I stop this Commenting is, I can come right here and I can put the asterisk and the forward slash. And notice now everything between these, notice I started it with a forward slash asterisk, I close it with an asterisk forward slash and this one is now Uncommented. So I can use the asterisk forward slash, I'll delete it here. I'll grab this one, I drag it up here and notice everything is green. I'll come down here and put it and notice it's Commented everything from here to here and now this is open. So you got a lot of options here with Comments. Use Comments, first of all, to document anything in your code that's going to be hard to figure out when you come back, a week, 2 weeks, 2 months, 6 months later and try to make changes to this code, and update it, enhance it whatever but also for other developers. Now there's always this debate about how many Comments? How much should I write? To what level of detail? And trust me on this, you'll never satisfy other developers. Write yourself enough in Comments so that you can understand what's going on, so that they can understand what's going on. And just keep in mind, you're always going to hear with your Comments, this person doesn't believe in Comments or the ones they wrote were too cryptic, I couldn't understand them. Or they wrote their autobiography in Comments and I don't understand that. So you'll always hear one or the other but I would fail on the side of writing too many Comments maybe making them a little too detailed. Because it's amazing how many times you come back to some code a few months later and you're thinking, was I on some real like, really strong sinus medicine that morning, because none of this code seems to be making any sense. Why would I write it that way? As it always usually is in life, there are reasons for doing what you're doing; they just don't make sense later. Okay. So anyway that's a quick look at Comments in C#.
TERMS & CONDITIONS OF USE
BY SUBSCRIBING TO THIS SERVICE, YOU ARE CONSENTING TO BE BOUND BY AND ARE BECOMING A PARTY TO THIS AGREEMENT, THE TERMS AND CONDITIONS OF WHICH SHALL PREVAIL IN GOVERNING YOUR RIGHTS OF USE. BY CLICKING THE "BECOME A MEMBER" BUTTON, THE INDIVIDUAL OR ENTITY LICENSING THE PRODUCT ("YOU") IS CONSENTING TO BE BOUND BY AND IS BECOMING A PARTY TO THIS AGREEMENT. IF LICENSEE DOES NOT AGREE TO ALL OF THE TERMS OF THIS AGREEMENT, THE BUTTON INDICATING "BECOME A MEMBER" MUST NOT BE SELECTED, AND LICENSEE MUST NOT INSTALL OR USE THE SOFTWARE.
"VTC" refers to Virtual Training Company,
"You" refers to the user or subscriber.
"Software" refers to the VTC training content and software.
2. LICENSE: VTC hereby grants to You a worldwide, non-royalty bearing, non-exclusive license to use the Software according to the provisions contained herein and subject to payment of the applicable subscription fees.
3. RESTRICTIONS: You may not do any of the following:
Save the Software to Your hard disk or other storage
medium; permit others to use the Software except as specified by addendum;
modify, reverse engineer, decompile, or disassemble the Software; make
derivative works based on the Software; publish or otherwise disseminate
the Software. VTC, Inc., VTC Online University, and the Virtual Training
Company site is owned and operated by VTC, Inc. as a corporation of
All materials on this site are the property of VTC unless otherwise specified. No material from these pages may be copied, reproduced, republished, downloaded, uploaded, posted, transmitted, or distributed in any way. Modification of the materials or use of the materials for any other purpose is a violation of U.S. copyright law and other proprietary rights. For purposes of this Agreement, the use of any such material on any other web site or networked computer environment is prohibited.
4. FEES: The rights granted under this Agreement
are effective only upon payment of the subscription fees, which are
strictly non-refundable other than as expressly provided herein. The
term "monthly subscription" is defined as any 30 day period.
The term "yearly subscription" is defined as one 365 day
period. A yearly subscription ends on the same numerical date as it
began (example July 28, 2004 to July 28, 2005).
The VTC Online University is access to every VTC training tutorial in our library. You pay a flat fee for access to these titles. You are billed according to your renewal selection below, and can renew monthly, yearly, or in any other increment offered. If you choose to be billed monthly, you will be billed every 30 days for the subscription until you request the subscription be cancelled. Our terms of service state that you must cancel a monthly subscription at least two business days before your renewal date. These two days give us enough time to ensure that you will not be charged again.
5. LIMITED WARRANTY: VTC warrants that the Software, if operated as directed, will substantially achieve the functionality described. VTC does not warrant, however, that Your use of the Software will be uninterrupted or that the operation of the Software will be error-free or secure. In addition, the security mechanisms implemented by the Software have inherent limitations, and You must determine that the Software sufficiently meets Your requirements. VTC also warrants that the media containing the Software, if provided by VTC, is free from defects in material from the date You acquired the Software. VTC's sole liability for any breach of this warranty shall be, in VTC's sole discretion: (i) to replace Your defective media or Software; or (ii) to advise You how to achieve substantially the same functionality with the Software as described; or (iii) if the above remedies are impracticable, to refund the subscription fee You paid for the Software. Only if You inform VTC of Your problem with the Software during the applicable subscription period will VTC be obligated to honor this warranty. VTC will use reasonable commercial efforts to repair, replace, advise, or refund pursuant to the foregoing warranty within thirty (30) days of being so notified. If any modifications are made to the Software by You during the warranty period; if the medium is subjected to accident, abuse, or improper use; or if You violate the terms of this Agreement, then this warranty shall immediately terminate. This warranty shall not apply if the Software is used on or in conjunction with hardware or software other than the unmodified version of hardware and software with which the Software was designed to be used as described.
THIS IS A LIMITED WARRANTY, AND IT IS THE ONLY WARRANTY MADE BY VTC OR ITS SUPPLIERS. VTC MAKES NO OTHER WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT OF THIRD PARTIES' RIGHTS. YOU MAY HAVE OTHER STATUTORY RIGHTS. HOWEVER, TO THE FULL EXTENT PERMITTED BY LAW, THE DURATION OF STATUTORILY REQUIRED WARRANTIES, IF ANY, SHALL BE LIMITED TO THE ABOVE LIMITED WARRANTY PERIOD. MOREOVER, IN NO EVENT WILL WARRANTIES PROVIDED BY LAW, IF ANY, APPLY UNLESS THEY ARE REQUIRED TO APPLY BY STATUTE NOTWITHSTANDING THEIR EXCLUSION BY CONTRACT. NO DEALER, AGENT, OR EMPLOYEE OF VTC IS AUTHORIZED TO MAKE ANY MODIFICATIONS, EXTENSIONS, OR ADDITIONS TO THIS LIMITED WARRANTY.
6. PROPRIETARY RIGHTS: VTC reserves all proprietary rights in and to the Software, is protected by copyright and other intellectual property laws and by international treaties. VTC, Inc.
Trademark Notice: VTC, Virtual Training Company,
Inc., The VTC Logo, and VTC Online University, are trademarks of VTC,
Inc. All other company and product names may be trademarks of their
The information contained herein is subject to change without notice. Copyright © 1995 - 2005 VTC, Inc. All rights reserved.
7. TERMINATION: This Agreement shall automatically terminate if You fail to comply with the restrictions described herein. Your obligations to pay outstanding subscription fees shall survive any termination of this Agreement.
8. LIMITATION OF LIABILITY: UNDER NO CIRCUMSTANCES
AND UNDER NO LEGAL THEORY, TORT, CONTRACT, OR OTHERWISE, SHALL VTC
OR ITS SUPPLIERS OR RESELLERS BE LIABLE TO YOU OR ANY OTHER PERSON
FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF
ANY CHARACTER, INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL,
WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER
COMMERCIAL DAMAGES OR LOSSES. IN NO EVENT WILL VTC BE LIABLE FOR ANY
DAMAGES IN EXCESS OF THE AMOUNT VTC RECEIVED FROM YOU FOR A LICENSE
TO THE SOFTWARE, EVEN IF VTC SHALL HAVE BEEN INFORMED OF THE POSSIBILITY
DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY. THIS LIMITATION OF LIABILITY SHALL NOT APPLY TO LIABILITY FOR DEATH OR PERSONAL INJURY RESULTING FROM VTC'S NEGLIGENCE TO THE EXTENT APPLICABLE LAW PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS EXCLUSION AND LIMITATION MAY NOT APPLY TO YOU.
9. Links To Other Materials: Linked sites found at the VTC site are not under the control of VTC, and we are not responsible for the content of any linked site or any link contained in a linked site. VTC may change links based solely on our discretion, and we reserve the right to terminate any link or linking program at any time. VTC does not, by linking to sites, endorse companies or products to which it links and reserves the right to note as such on its web pages. If you decide to access any of the third party sites linked to this site, you do this entirely at your own risk.
Forums, and Chat are not always screened by VTC, and we are not responsible for the content of any public or open forum content at the site. VTC may change these public forums based solely on our discretion, and we reserve the right to terminate any forum at any time. VTC does not, by allowing these forums, endorse companies or products which may be mentioned in these forums, and reserves the right to note as such on its web pages. If you decide to access any of the public forums in this site, or linked to this site, you do this entirely at your own risk.
9. GOVERNING LAW & DISPUTE RESOLUTION: This Agreement is governed by Virginia law. All disputes between You and VTC shall be finally resolved through arbitration in Winchester, Virginia. This site is controlled by VTC from its offices within the United States of America. VTC makes no representation that materials in the site are appropriate or available for use in other locations, and access to them from territories where their content is illegal is prohibited. Those who choose to access this site from other locations do so on their own initiative and are responsible for compliance with applicable local laws. You may not use or export the Materials in violation of U.S. export laws and regulations. Any claim relating to the Materials shall be governed by the internal substantive laws of the Commonwealth of Virginia, USA.
VTC may revise these Terms at any time by updating this posting. You should visit this page from time to time to review the then-current Terms because they are binding on you. Certain provisions of these Terms may be superseded by expressly designated legal notices or terms located on particular pages at this Site.
If you have any questions regarding this policy,
or your information specifically,
you may email us at:email@example.com.