2010-02-12 23 views
6

Temsilci parametreleri için xml yorumları/belgeleri nasıl sağlanır?

Func<string,string,string> MyFunc = (firstName,lastName) => string.Format("Given Name:{0} Surname:{1}", 
                      firstName, 
                      lastName); 

Nasıl sen ad ve soyad parametrelerini belgelenebilir olur

gibi bir temsilci verilen, yani (yöntem açıklamaları ve parametreler yaptığı gibi) onlar intellisense görünür mü?
Örnek:

Ben delege üzerinde gezdirin veya sahip intellisense açılır penceresini ben yazarken ve yukarıda yöntemle yaptığınız gibi, temsilci parametreler için bana açıklamaları anlatmak istiyorum
/// <summary> 
/// My Method 
/// </summary> 
/// <param name="firstName">The first name.</param> 
/// <param name="lastName">The last name.</param> 
/// <returns></returns> 
public string MyMethod(string firstName, string lastName) 
{ 
    return string.Format("Given Name:{0} Surname:{1}",firstName,lastName); 
} 

.

+0

Bana göre, anonim bir işlevi belgelemek garip görünüyor. – Foole

cevap

8

Bir temsilci türü alanı hala bir alandır ve bir yöntem değil — kendi içinde parametreler almaz. Parametreler, tip no'lu temsilci alanı alanına ait değil. İsterseniz türleri devrederken parametreler için yorumları yazabilirsiniz.

/// <summary> 
/// Tests something. 
/// </summary> 
/// <param name="test">Something that's going to be tested.</param> 
delegate void Test(int test); 

Func<string,string,string> üç parametreye sahip fonksiyonlar için genel bir delege. Belirli amaçlar için, her zaman soyutlanmış yöntemi temsil eden kendi temsilci türünüzü daha spesifik olarak bildirebilir ve kendi parametrelerine yorum ekleyebilirsiniz.

+0

Çok kötü Bu, bir 'Func için intellisense'nin alacağı dokümantasyonu sağlamanın bir yolu yoktur. Birçok durumda, bu tür bir deklare edilen değişkene atanacak işlevin belirli görevleri yerine getirmesi beklenir. ve neyin geçtiği ve neyin geri döndüğü hakkında belirli beklentiler var. –

İlgili konular