Microsoft Visual Basic computerprogrammeringssprog har været populært i programmeringskredse i mange år. Programmører bruger det til alle slags projekter. Varianter af dette programmeringssprog bruges til websider, og andre typer Visual Basic -programmer bruges til mange af de Windows -programmer, vi bruger hver dag. Et af de væsentlige elementer i Visual Basic er muligheden for at inkludere kommentarer, som er noter indlejret i koden, der ikke har et funktionelt kodeformål. Visual Basic bruger specifik protokol til at skelne disse fra kode. Tilføjelse af kommentarer er ekstremt vigtigt i de fleste projekter for at hjælpe menneskelige kodevisere med at læse kodemodulerne korrekt. Hvis du har brug for at tilføje kommentarer til Visual Basic, er her nogle af de grundlæggende trin for at sikre, at du gør dette korrekt.
Trin
Trin 1. Bestem, hvilken type kommentar du vil tilføje
Programmører har flere forskellige hovedformål med kommentarer, der bestemmer det nøjagtige format og stil for, hvad der vil blive inkluderet i kommentaren.
- Overvej kodemodulkommentarer. Modulkommentarer er kommentarer på højere niveau, der normalt beskriver kodemodulets overordnede formål samt andre oplysninger som ophavsret, forfatterskab og mere.
- Vurder behovet for procedurkommentarer. Forskellige funktionelle kodeprocedurer bør også kommenteres. Procedurekommentarer vedrører kodens specifikke funktioner, og de hjælper med at advare andre programmører om de nøjagtige resultater af en procedure i henhold til, hvordan den er skrevet.
Trin 2. Vælg detaljerede kategorier af brug for dine kodekommentarer
Nogle typer kommentarer, som procedurkommentarer, findes også i forskellige former. Forstå disse forskellige anvendelser for at tilføje de rigtige slags kommentarer til dit program.
- Vurder brugen af formålskommentarer til procedurer. Disse beskriver, hvad proceduren gør.
- Overvej brugen af funktionsreturværdi -kommentarer. Disse vil hjælpe andre med at forstå, hvilke værdier der returneres ved procedure.
- Inkluder betingede kommentarer. Betingede kommentarer kan beskrive mulige fejlbetingelser og fejlhåndtering samt betingelser, der skal være opfyldt for at koden skal fungere korrekt.
Trin 3. Vælg et format til kommentarer
Der er også spørgsmålet om, hvordan du tilføjer kommentarer til bestemte kodelinjer.
- Brug venstrehåndede kommentarer. Disse kommentarer starter til venstre på skærmen og fortsætter hele vejen over en linje. Normalt skal koderen vilkårligt afslutte kommentaren nær højre side af skærmen, gå ned til en ny linje og fortsætte kommentaren.
- Brug in-line kommentarer. In-line kommentarer har en apostrof direkte efter et stykke kode og placeres på samme linje.
Trin 4. Brug en apostrof til at markere begyndelsen på dine kommentarer
Dette er det vigtigste trin for faktisk at skrive kommentarer i kode. Apostrofen er den specifikke tekstprotokol, som Visual Basic -kompilatoren genkender til kommentarer. Uden dette vil computeren forsøge at læse kommentarerne som kode.
