2011-11-23 27 views
10

"Bu" yazdığınızda. , Genellikle tüm rutinleri, olayları almak ve içindedir. Ve eğer sadece birini seçerek olmadan uzun listedeki rutinleri biri üzerinde ayakta duruyorum, genellikle yanında bir tarifini geçerli sınıfın ... daha fazlası.Özel oluşturulan sınıflar için intellisense nasıl edinilir?

Bunu nasıl yapabilirim? İki rutine sahip CAR adında bir sınıfım olduğunu varsayalım: speed_up() ve brake().

CAR mycar = new CAR(); 
mycar. 

cevap

23

bir sınıf veya bir yöntem üzerinde, daha doğrusu bir "//" yorumun daha. Eğer (aksi bir XML yorum olarak da bilinir), bir "///" üçlü çizgi yaparsanız, bu size Yorumda sınıf veya yöntem hakkında bilgi doldurmak için izin vermek için bir kestirme gerçekleştirir. açıklama görünecektir zaman sonra intellisense thats aracılığıyla sınıf veya yöntemi erişirken

Bu da böyle

/// <summary> 
    /// 
    /// </summary> 
    /// <param name="sender"></param> 
    /// <param name="e"></param> 
    void Method(object sender, EventArgs e) 

olarak kodunuzda görünür. /// girdikten ve anlamlı IntelliSense içinde niyet görüntüler, böylece sen yöntemleri ve özellikleri her biri için bunu yapabilirsiniz

/// <summary> 
/// This is my speed up method 
/// </summary> 
public void speed_up(){ ...} 

altında gibi dolmaya ederek yöntemlere özetini ekleyerek

+0

Çok basit. : D Teşekkürler. – Fares

+0

Intellisense ile ad alanlarıyla kombinasyon halinde sorun keşfettim: [link] http://stackoverflow.com/questions/23562307/intellisense-not-shown-on-public-classes-but-on-private-ones [link] can you can onaylamak? –

8

intellisense görünecektir sizin sınıfları ve üyelerini, XML comments, ver: nasıl o tipleri, iki fonksiyonları bir açıklama görmek için benim sınıf kullanarak kişiyi yapabilirsiniz. Görsel stüdyoda bunu yapmanın en kolay yolu, yorum eklemek istediğinizin üzerine /// yazarakdır. Örneğin

:

/// <summary> 
/// Class level summary documentation goes here.</summary> 
/// <remarks> 
/// Longer comments can be associated with a type or member through 
/// the remarks tag.</remarks> 
public class TestClass : TestInterface 
{ 
    /// <summary> 
    /// Store for the name property.</summary> 
    private string _name = null; 

    /// <summary> 
    /// The class constructor. </summary> 
    public TestClass() { } 

    /// <summary> 
    /// Description for SomeMethod.</summary> 
    /// <param name="s"> Parameter description for s goes here.</param> 
    /// <seealso cref="System.String"> 
    /// You can use the cref attribute on any tag to reference a type or member 
    /// and the compiler will check that the reference exists. </seealso> 
    public void SomeMethod(string s) 
    { 
    } 
} 

yukarıda here bulunmuştur.


Ayrıca bakınız: How do you get XML comments to appear in a different project (dll)?

+1

Sanırım eğik çizgi başka bir şekilde yuvarlak gibi görünüyor /// ' – V4Vendetta

+0

Oops, fark ettim, teşekkürler. –

3

Her tip yapılar için Görsel stüdyoda Kullanılabilir XML belgeleri biçimini kullanın (yani sınıf, yöntemleri, özellikleri ...)

erişmek için, bildiriminden önce on line tipi /// olmalıdır.

/// 
    public void Method(string p){... 

alırsınız gibi bir şey: Mesela

/// <summary> 
    /// 
    /// </summary> 
    /// <param name="p"></param> 
    public void Method(string p){... 

yazarsanız /// < hatta sözlerden veya exemple gibi mevcut XML öğelerinin listesini alacak Daha fazla bilgi için, bkz. http://msdn.microsoft.com/en-us/magazine/cc302121.aspx

2

Aşağıdaki gibi yorum ekleyebilirsiniz:

/// <summary> 
/// This sppeds up the car 
/// </summary> 
public void speed_up() 
{ } 
2

Böyle Üzerinde bir yorum koymak zorunda:

/// <summary> 
/// This is my function. 
/// </summary> 
/// <param name="myParameter">This parameter is very important.</param> 
/// <returns>It returns always 42.</returns> 
public int MyFunction(string myParameter) 
{ 
    return 42; 
} 

İşlevin <summary> kullanımını ve Paramaters <param name=""> anlamını tarif edebilir. Fonksiyonun bir dönüş değeri varsa, bunu <returns> etiketiyle tanımlayabilirsiniz. Desteklenen bazı mor etiketler vardır, üç \ sonra yorumunuzu yazdığınızda, görsel stüdyo tarafından listelenecektir.

1

Yöntemler için belge yorumları eklemeniz gerekir. bunu '///' yazarak veya görsel stüdyo eklentisini kullanarak el ile yapabilirsiniz. GhostDoc iyi adlandırma kurallarını izlerseniz, bu konuda size yardımcı olacaktır.

+0

Özel sınıflar için her şey için intellisense alıyorum ama sınıfta ve üyeler içinde /// işinin çalışmasına rağmen çözümde atıfta bulunulan herhangi bir özel dll'deki hiçbir şey için ... – gg89

İlgili konular