CA2012: ValueTasks'i doğru kullanma

Özellik	Değer
Kural Kimliği	CA2012
Başlık	ValueTask’leri doğru kullanın
Kategori	Güvenilirlik
Hataya neden olan veya bozulmayan düzeltme	Hataya neden olmayan
.NET 8'de varsayılan olarak etkin	Öneri olarak

Neden

Üye ValueTask çağrısından döndürülen bir örnek, özel durumlara, bozulmaya veya düşük performansa yol açabilecek şekilde kullanılır.

Kural açıklaması

ValueTask üye çağrılarından döndürülen örneklerin doğrudan beklenmeleri amaçlanmıştır. Bir ValueTask'i birden çok kez kullanma veya tamamlanmadan önce sonucuna doğrudan erişme girişimi bir özel durum veya bozulmaya neden olabilir. Böyle bir ValueTask'in yoksayılması büyük olasılıkla işlevsel bir hatanın göstergesidir ve performansı düşürebilir.

İhlalleri düzeltme

Genel olarak, ValueTasks atılması veya yerel değişkenler veya alanlar gibi diğer konumlarda depolanması yerine doğrudan beklenmelidir.

Uyarıların ne zaman bastırılması gerekiyor?

Rastgele üye çağrılarından döndürülen nesneler için ValueTask , çağıranın ValueTask bir kez ve yalnızca bir kez tüketilmesi gerektiğini (örneğin, bekleniyor) varsayması gerekir. Ancak geliştirici, çağrılan üyeyi de denetlerse ve uygulaması hakkında tam bilgiye sahipse, örneğin dönüş ValueTask her zaman bir Task nesneyi sarmalarsa, geliştirici uyarıyı gizlemenin güvenli olduğunu biliyor olabilir.

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

#pragma warning disable CA2012
// The code that's violating the rule is on this line.
#pragma warning restore CA2012

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA2012.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Ayrıca bkz.

• Güvenilirlik kuralları