CA2002: Não bloquear objetos com identidade fraca
Property | Valor |
---|---|
ID da regra | CA2002 |
Título | Não bloquear objetos com identidade fraca |
Categoria | Confiabilidade |
Correção interruptiva ou sem interrupção | Sem interrupção |
Habilitado por padrão no .NET 8 | Não |
Causa
Um thread tenta adquirir um bloqueio em um objeto que tem uma identidade fraca.
Descrição da regra
Diz-se que um objeto tem uma identidade fraca quando puder ser acessado diretamente em todos os limites de domínio do aplicativo. Um thread que tente adquirir um bloqueio em um objeto com uma identidade fraca pode ser bloqueado por um segundo thread em um domínio de aplicativo diferente com um bloqueio no mesmo objeto.
Os seguintes tipos têm uma identidade fraca e são sinalizados pela regra:
Matrizes de tipos de valor, incluindo tipos integrais, tipos de ponto flutuante e Boolean.
Como corrigir violações
Para corrigir uma violação dessa regra, use um objeto de um tipo que não esteja na lista da seção Descrição.
Quando suprimir avisos
É seguro suprimir o aviso se o objeto bloqueado for this
ou Me
e a visibilidade do tipo de objeto self for privada ou interna e a instância não estiver acessível usando nenhuma referência pública.
Caso contrário, não suprima um aviso dessa regra.
Suprimir um aviso
Para suprimir apenas uma violação, adicione diretivas de pré-processador ao arquivo de origem a fim de desabilitar e, em seguida, reabilitar a regra.
#pragma warning disable CA2002
// The code that's violating the rule is on this line.
#pragma warning restore CA2002
Para desabilitar a regra em um arquivo, uma pasta ou um projeto, defina a severidade como none
no arquivo de configuração.
[*.{cs,vb}]
dotnet_diagnostic.CA2002.severity = none
Para obter mais informações, confira Como suprimir avisos de análise de código.
Regras relacionadas
CA2213: Campos descartáveis devem ser descartados
Exemplo
O exemplo a seguir mostra alguns bloqueios de objetos que violam a regra.
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) { }
}
}