Dodawanie komentarzy w ASP

• Kwiecień 28, 2024

Czasami są to proste rzeczy, które dezorientują ludzi. Jak dodajesz komentarze do kodu ASP, aby był bardziej czytelny i udokumentowany?

To bardzo proste - wystarczy wstawić pojedynczy cudzysłów (') na początku linii ASP. Twój kod może więc wyglądać tak:

„inicjalizuj zmienne”
CurrMonth = żądanie („m”)
CurrDay = żądanie („d”)

Zauważ, że umieszczam apostrof przed I po moim komentarzu. Nie musisz tego robić. Ale używam edytora TextPad (który bardzo polecam) i automatycznie podkreśla rzeczy na podstawie tego, gdzie zaczyna się i kończy apostrof. Umieszczając jeden na każdym końcu moich komentarzy, zmieniam je na inny kolor.

Komentarze NIE są interpretowane, więc możesz umieścić w nich co tylko chcesz. Jednak chociaż komentarze są ważne, aby śledzić to, co robisz, NIE polecam umieszczania mnóstwa komentarzy w kodzie. Pamiętaj, że cały plik musi zostać przeanalizowany i przetworzony, zanim wynik zostanie wysłany do użytkownika końcowego. Jeśli napiszesz Wojnę i Pokój w swoich komentarzach, minie trochę czasu, zanim ten plik dotrze do użytkownika końcowego - co oznacza, że ​​mogą się poddać i pójść gdzie indziej. Chcesz, aby Twoje strony ASP na żywo były maksymalnie usprawnione.

Dlatego zalecam umieszczanie komentarzy powyżej każdego większego bloku kodu, więc jeśli będziesz musiał wejść i debugować go kilka miesięcy później, możesz zapamiętać, co robiłeś. Może dodaj wiersz lub dwa u góry z ostatnią datą zmiany i nazwiskiem autora. Ale zostaw solidną dokumentację osobno. Ostatecznym celem kodu ASP jest stworzenie strony internetowej dla użytkownika - w tym sensie szybkie działanie ma podstawowe znaczenie.

Instrukcje Wideo: Retransmisja - spotkanie na ASP z Bogusławem Wołoszańskim (Kwiecień 2024).