CA2002: Auf Objekten mit schwacher Identität nicht sperren.
Eigenschaft | Wert |
---|---|
Regel-ID | CA2002 |
Titel | Auf Objekten mit schwacher Identität nicht sperren. |
Kategorie | Zuverlässigkeit |
Fix führt oder führt nicht zur Unterbrechung | Nicht unterbrechend |
Standardmäßig in .NET 8 aktiviert | Nein |
Ursache
Ein Thread versucht, eine Sperre für ein Objekt zu erhalten, das eine schwache Identität aufweist.
Regelbeschreibung
Ein Objekt hat eine schwache Identität, wenn ein Zugriff darauf über Grenzen von Anwendungsdomänen hinweg möglich ist. Ein Thread, der eine Sperre für ein Objekt zu erhalten versucht, das über eine schwache Identität verfügt, kann durch einen zweiten Thread in einer anderen Anwendungsdomäne blockiert werden, der eine Sperre für das gleiche Objekt besitzt.
Die folgenden Typen haben eine schwache Identität und werden durch die Regel gekennzeichnet:
Arrays von Werttypen, einschließlich Integraltypen, Gleitkommatypen und Boolean.
Behandeln von Verstößen
Um einen Verstoß gegen diese Regel zu beheben, verwenden Sie ein Objekt aus einem Typ, der nicht in der Liste im Abschnitt Beschreibung enthalten ist.
Wann sollten Warnungen unterdrückt werden?
Es ist sicher, die Warnung zu unterdrücken, wenn das gesperrte Objekt this
oder Me
ist und die Sichtbarkeit des eigenen Objekttyps privat oder intern ist. Die Instanz kann nicht mithilfe eines beliebigen öffentlichen Verweises aufgerufen werden.
Andernfalls sollten Sie keine Warnung dieser Regel unterdrücken.
Unterdrücken einer Warnung
Um nur eine einzelne Verletzung zu unterdrücken, fügen Sie der Quelldatei Präprozessoranweisungen hinzu, um die Regel zu deaktivieren und dann wieder zu aktivieren.
#pragma warning disable CA2002
// The code that's violating the rule is on this line.
#pragma warning restore CA2002
Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad in der Konfigurationsdatei auf none
fest.
[*.{cs,vb}]
dotnet_diagnostic.CA2002.severity = none
Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.
Ähnliche Regeln
CA2213: Verwerfbare Felder verwerfen.
Beispiel
Das folgende Beispiel zeigt einige Objektsperren, die gegen die Regel verstoßen.
Imports System
Imports System.IO
Imports System.Reflection
Imports System.Threading
Namespace ca2002
Class WeakIdentities
Sub SyncLockOnWeakId1()
SyncLock GetType(WeakIdentities)
End SyncLock
End Sub
Sub SyncLockOnWeakId2()
Dim stream As New MemoryStream()
SyncLock stream
End SyncLock
End Sub
Sub SyncLockOnWeakId3()
SyncLock "string"
End SyncLock
End Sub
Sub SyncLockOnWeakId4()
Dim member As MemberInfo =
Me.GetType().GetMember("SyncLockOnWeakId1")(0)
SyncLock member
End SyncLock
End Sub
Sub SyncLockOnWeakId5()
Dim outOfMemory As New OutOfMemoryException()
SyncLock outOfMemory
End SyncLock
End Sub
End Class
End Namespace
class WeakIdentities
{
void LockOnWeakId1()
{
lock (typeof(WeakIdentities)) { }
}
void LockOnWeakId2()
{
MemoryStream stream = new MemoryStream();
lock (stream) { }
}
void LockOnWeakId3()
{
lock ("string") { }
}
void LockOnWeakId4()
{
MemberInfo member = this.GetType().GetMember("LockOnWeakId1")[0];
lock (member) { }
}
void LockOnWeakId5()
{
OutOfMemoryException outOfMemory = new OutOfMemoryException();
lock (outOfMemory) { }
}
}