Visual Studio Summary Nedir ve Nasıl Kullanılır? - Sanalkurs.net
Visual studio da kod yazarken farketmişsinizdir. Örn bir msgbox kullanırken hangi parametrenin ne işe yaradığının açıklaması vardır. O nasıl yapılır?
Bu dersin içeriği;
Summary nasıl hazırlanır?
Visual studio da summary nasıl kullanılır?
Summary, parametreli metodlarda, parametleri yazmak için parantez açtığınızda ilk parametrenin ne olduğu, değişken tipi, ne işe yaradaığı gibi bilgileri bize bir gösterdiği baloncuğa verilen addır. Şöyle ki, diyelim bir mail gönderme metodunuz var ve bir çok parametre alıyor. Şimdi bir yerde kullanmanız gerekti ve yazmaya başladınız.
yazdığınızda size resimdeki bir baloncuk açtı. İşte buna summary denir. Nadir kullandığınız metodlardaki aldığınız parametlerini amaçlarını zamanla unutabilirsiniz ancak summary kullandığınıza bu size o parametrelerin ne işe yaradığını söyleyecektir.
Tabi tekrar baktığınızda anlayacağınız şekilde yazdıysanız!!.
Şimdi Summary'nin ne olduğunu anladık. Sıra geldi bunu nasıl yapacağımıza?
Summary özelliğini bilmediğiniz zamanlarda yorum satırı yapmak istediğinizde yanlışlıkla iki " // " yerine " /// " tane attığınızda otomatik olarak parametre sayısına göre satırlar getirdiğini görmüşsünüzdür. Hatta "La bunlar ne?" deyip geri silmişsinizdir. Bende öyle oldu
Arkadaşlar işte o otomatik eklenen satırlar summary oluyor. Örneğini görelim:
Yazım şeklide resimdeki gibidir. Tanıdık geldi mi?
Şimdi bunu inceleyelim.
Bu kısım metodumuzun genel tanımı için verilen alandır. Metod ne işe yarıyor?, hangi işlemleri yapıyor?, amacı nedir? gibi soruların cevaplarını yazacağınız alandır. Parametrelerin sıralı gösterildiği satırın altında yazar.
/// <param name="mail_adresi"></param>
Bu kısım(lar) parametre sayısı kadar otomatik eklenir ve o parametrenin açıklamasını yazacağınız yerdir. O parametre ne işe yarıyor?, hangi işlemleri yapıyor?, amacı nedir? gibi soruların cevaplarını yazacağınız alandır. Parametreleri yazmaya başladığınızda açıklamalarda çıkar. "," ile diğer parametreye geçtiğinizde parametre açıklaması da değişir.
Bu kısım ise ilgili metodun geri dönderdiği derğer hakkında bilgi verir. Ancak metodunu yazarken summary baloncuğu içerisinde görünmüyor. En azından ben görmedim.
Metodunuzu hazırladınız. Parametreleri vs herşey tamamlandı.
Açık renkli satırı görüyorsunuz. Tanım satırının hemen üst satırı. O satıra gelip " /// " yazdığınız anda tüm satırlar otomatik olarak eklenmektedir. Yazacaklarınız da artık size kalmış. Parametre olmayan metodlarda da çalışır. Parametre almıyor diye yazılmaz diye bir şey yok. Her metod için yazabilirsiniz
NOT: Ekip işlerinde yani bir ekip ile çalıştığınızda summary ve yorum satırları hayati önem taşımaktadır. Yazdığınız kodlar ne işe yarıyorsa diğer adam gelip baktığında olayı hemen kavraması gerekir. Ona göre açıklayıcı bir şekilde yazmalısınız.
Bu dersimizde bu kadar arkdaşlar.
Photoshop'ta Arayüz Tasarımı (Ders 1)
InDesign'da Sudoku Oluşturma Plugini
C#'ı kullanarak bilgisayarı beklemeye almak