4. Methods.md

4 Funksiyalar

1.0 Nomlash

Funksiyaning nomlari qisqa va aniq bo'lishi kerak shu bilan birgalikda u nima vazifani bajarishi haqida qisqacha ma'no anglatishi lozim.

1.0.0 Kalit so'zlar

Funksiyani nomlashda u nima vazifa bajarishiga qarab, shunga oid kalit so'zlaridan foydalanish kerak.

Tavsiya etiladi

public List<Student> GetStudents()
{
	...
}

Tavsiya etilmaydi

public List<Student> Students()
{
	...
}

1.0.1 Asinxron funksiyalar

Asinxron funksiyalar Async kalit so'zi bilan tugashi kerak va u funksiya Task yoki ValueTask tipida qiymat qaytaradi.

Tavsiya etiladi

public async ValueTask<List<Student>> GetStudentsAsync()
{
	...
}

Tavsiya etilmaydi

public async ValueTask<List<Student>> GetStudents()
{
	...
}

1.0.2 Kiruvchi qiymatlar

Kiruvchi qiymatlar obyektning qaysi xususiyatiga tayinlanishi yoki keyinchalik qidirib topish uchun ham aniq bo'lishi kerak.

Tavsiya etiladi

public async ValueTask<Student> GetStudentByNameAsync(string studentName)
{
	...
}

Tavsiya etilmaydi

public async ValueTask<Student> GetStudentByNameAsync(string text)
{
	...
}

Umuman tavsiya etilmaydi

public async ValueTask<Student> GetStudentByNameAsync(string name)
{
	...
}