Enumeração GCHandleType
Dica
The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.
Representa os tipos de identificadores que a classe GCHandle pode alocar.
Namespace: System.Runtime.InteropServices
Assembly: mscorlib (em mscorlib.dll)
Sintaxe
[SerializableAttribute]
[ComVisibleAttribute(true)]
public enum GCHandleType
[SerializableAttribute]
[ComVisibleAttribute(true)]
public enum class GCHandleType
[<SerializableAttribute>]
[<ComVisibleAttribute(true)>]
type GCHandleType
<SerializableAttribute>
<ComVisibleAttribute(True)>
Public Enumeration GCHandleType
Membros
| Nome do membro | Descrição | |
|---|---|---|
| Normal | Esse tipo de identificador representa um identificador opaco, o que significa que não é possível resolver o endereço do objeto fixo por meio do identificador. Você pode usar este tipo para controlar um objeto e impedir sua coleção pelo coletor de lixo. Este membro de enumeração é útil quando um cliente não gerenciado contém somente a referência, que é indetectável do coletor de lixo, para um objeto gerenciado. |
|
| Pinned | Esse tipo de identificador é semelhante ao Normal, mas permite que o endereço do objeto fixado seja coletado. Isso impede que o coletor de lixo mova o objeto e, portanto, prejudica a eficiência do coletor de lixo. Usa o método Free para liberar o identificador alocado, assim que possível. |
|
| Weak | Esse tipo de identificador é usado para controlar um objeto, mas permite que ele seja coletado. Quando um objeto for coletado, o conteúdo de GCHandle será zerado. Referências Weak são zeradas antes do finalizador ser executado, então mesmo que o finalizador levante o objeto, a referência Weak ainda é zerada. |
|
| WeakTrackResurrection | Esse tipo de identificador é semelhante ao Weak, mas o identificador não é zerado se o objeto é reativado durante a finalização. |
Informações de Versão
Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Confira Também
GCHandle
Namespace System.Runtime.InteropServices
Retornar ao início