CA2250: Kullan ThrowIfCancellationRequested
Özellik | Değer |
---|---|
Kural Kimliği | CA2250 |
Başlık |
ThrowIfCancellationRequested komutunu kullanma |
Kategori | Kullanım |
Hataya neden olan veya bozulmayan düzeltme | Hataya neden olmayan |
.NET 9'da varsayılan olarak etkin | Öneri olarak |
Neden
Bu kural, oluşturmadan önce onaylayan IsCancellationRequested koşullu deyimlere bayrak ekler OperationCanceledException.
Kural açıklaması
komutunu çağırarak CancellationToken.ThrowIfCancellationRequested()da aynı şeyi gerçekleştirebilirsiniz.
İhlalleri düzeltme
İhlalleri düzeltmek için koşullu deyimini çağrısıyla ThrowIfCancellationRequested()değiştirin.
using System;
using System.Threading;
public void MySlowMethod(CancellationToken token)
{
// Violation
if (token.IsCancellationRequested)
throw new OperationCanceledException();
// Fix
token.ThrowIfCancellationRequested();
// Violation
if (token.IsCancellationRequested)
throw new OperationCanceledException();
else
DoSomethingElse();
// Fix
token.ThrowIfCancellationRequested();
DoSomethingElse();
}
Imports System
Imports System.Threading
Public Sub MySlowMethod(token As CancellationToken)
' Violation
If token.IsCancellationRequested Then
Throw New OperationCanceledException()
End If
' Fix
token.ThrowIfCancellationRequested()
' Violation
If token.IsCancellationRequested Then
Throw New OperationCanceledException()
Else
DoSomethingElse()
End If
' Fix
token.ThrowIfCancellationRequested()
DoSomethingElse()
End Sub
Uyarıların ne zaman bastırılması gerekiyor?
Bu kuraldan gelen uyarıları engellemek güvenlidir.
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 CA2250
// The code that's violating the rule is on this line.
#pragma warning restore CA2250
Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini none
olarak ayarlayın.
[*.{cs,vb}]
dotnet_diagnostic.CA2250.severity = none
Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.