Język programowania Microsoft Visual Basic od wielu lat jest popularny w kręgach programistów. Programiści używają go do wszelkiego rodzaju projektów. Warianty tego języka programowania są używane na stronach internetowych, a inne typy programów Visual Basic są używane w wielu aplikacjach Windows, z których korzystamy na co dzień. Jednym z podstawowych elementów Visual Basic jest możliwość dołączania komentarzy, które są notatkami osadzonymi w kodzie, które nie mają funkcjonalnego celu kodu. Visual Basic używa określonego protokołu, aby odróżnić je od kodu. Dodawanie komentarzy jest niezwykle ważne w większości projektów, aby pomóc osobom przeglądającym kod w prawidłowym odczytaniu modułów kodu. Jeśli chcesz dodać komentarze do Visual Basic, oto kilka podstawowych kroków, aby upewnić się, że zrobisz to poprawnie.
Kroki
Krok 1. Określ typ komentarza, który chcesz dodać
Programiści mają kilka różnych głównych celów dla komentarzy, które określają dokładny format i styl tego, co zostanie zawarte w komentarzu.
- Rozważ komentarze modułu kodu. Komentarze do modułu to komentarze wyższego poziomu, które zwykle opisują ogólne cele modułu kodu, a także inne informacje, takie jak prawa autorskie, autorstwo i inne.
- Oceń potrzebę komentarzy do procedury. Należy również skomentować różne procedury kodu funkcjonalnego. Komentarze dotyczące procedur odnoszą się do określonych funkcji kodu i pomagają ostrzec innych programistów o dokładnych wynikach procedury zgodnie z tym, jak jest napisana.
Krok 2. Wybierz szczegółowe kategorie wykorzystania komentarzy do kodu
Niektóre rodzaje komentarzy, takie jak komentarze dotyczące procedury, również występują w różnych formach. Zapoznaj się z tymi różnymi zastosowaniami, aby dodać do programu odpowiednie komentarze.
- Oceń wykorzystanie uwag dotyczących celu procedur. Opisują one, co robi procedura.
- Rozważ użycie komentarzy do wartości zwracanych przez funkcję. Pomogą one innym zrozumieć, jakie wartości są zwracane w drodze procedury.
- Dołącz komentarze warunkowe. Komentarze warunkowe mogą opisywać możliwe warunki błędów i obsługę błędów, a także warunki, które muszą zostać spełnione, aby kod działał poprawnie.
Krok 3. Wybierz format komentarzy
Pojawia się również kwestia dodawania komentarzy do określonych wierszy kodu.
- Korzystaj z komentarzy leworęcznych. Te komentarze zaczynają się po lewej stronie ekranu i ciągną się przez całą linię. Zazwyczaj koder musi arbitralnie zakończyć komentarz w prawej części ekranu, zejść do nowej linii i kontynuować komentarz.
- Używaj komentarzy w tekście. Komentarze w wierszu mają apostrof bezpośrednio po fragmencie kodu i są umieszczane w tym samym wierszu.
Krok 4. Użyj apostrofu, aby oznaczyć początek swoich komentarzy
Jest to kluczowy krok do faktycznego pisania komentarzy w kodzie. Apostrof to specyficzny protokół tekstowy rozpoznawany przez kompilator Visual Basic dla komentarzy. Bez tego komputer spróbuje odczytać komentarze jako kod.