Tipos que possuem recursos nativo devem ser descartáveis

Artigo
08/25/2010

TypeName	TypesThatOwnNativeResourcesShouldBeDisposable
CheckId	CA1049
Category (Categoria)	Microsoft.Design
Quebrando alterar	Não separável

Causa

Um tipo faz referência a um System.IntPtr campo, um System.UIntPtr campo, ou um System.Runtime.InteropServices.HandleRef campo, mas não implementa System.IDisposable.

Descrição da regra

Esta regra pressupõe que IntPtr, UIntPtr, e HandleRef os campos armazenam os ponteiros para os recursos não gerenciados. Tipos de alocar recursos não gerenciados devem implementar IDisposable para permitir que chamadores versão esses recursos por demanda e reduzir os tempos de vida dos objetos que contém os recursos.

O padrão de design recomendado para limpar recursos não gerenciados é fornecer um implícita e um meio explícito disponível esses recursos usando o Object.Finalize método e o IDisposable.Dispose método, respectivamente. O coletor de lixo chamar o Finalize método de um objeto em algum momento indeterminado após o objeto é determinado de não estar acessível. Depois de Finalize é chamado, um lixo adicional coleção é necessária para liberar o objeto. The Dispose método permite que o chamador explicitamente liberar recursos sob demanda, mais cedo do que os recursos poderiam ser liberados se deixada para o coletor de lixo. Após a limpeza de recursos não gerenciados, Dispose deve chamar o GC.SuppressFinalize método para permitir que o coletor de lixo que Finalize não é mais precisa ser chamado; isso elimina a necessidade da coleta de lixo adicional e reduz o tempo de vida do objeto.

Como corrigir violações

Para corrigir uma violação dessa regra, implementar IDisposable.

Quando suprimir avisos

É seguro eliminar um aviso essa regra se o tipo não faz referência a um recurso não gerenciado.Caso contrário, não eliminar um aviso essa regra sistema autônomo falha para implementar IDisposable pode fazer com que recursos não gerenciados se torne não disponível ou subutilizados.

Exemplo

O exemplo a seguir mostra um tipo que implementa IDisposable Para limpar um recurso não gerenciado.

Imports System

Namespace DesignLibrary

    Public Class UnmanagedResources
        Implements IDisposable

       Dim unmanagedResource As IntPtr
       Dim disposed As Boolean = False

       Sub New 
           ' Allocate the unmanaged resource ...
       End Sub

       Overloads Sub Dispose() Implements IDisposable.Dispose
           Dispose(True)
           GC.SuppressFinalize(Me)
       End Sub

       Protected Overloads Overridable Sub Dispose(disposing As Boolean)
           If Not(disposed) Then

               If(disposing) Then
                   ' Release managed resources.
               End If

               ' Free the unmanaged resource ...

               unmanagedResource = IntPtr.Zero

               disposed = True

           End If
       End Sub

       Protected Overrides Sub Finalize()
           Dispose(False)
       End Sub

    End Class

End Namespace

using System;

namespace DesignLibrary
{
    public class UnmanagedResources : IDisposable
    {
        IntPtr unmanagedResource;
        bool disposed = false;

        public UnmanagedResources() 
        {
            // Allocate the unmanaged resource ...
        }

        public void Dispose() 
        {
            Dispose(true);
            GC.SuppressFinalize(this); 
        }

        protected virtual void Dispose(bool disposing)
        {
            if(!disposed)
            {
                if(disposing)
                {
                    // Release managed resources.
                }

                // Free the unmanaged resource ...

                unmanagedResource = IntPtr.Zero;

                disposed = true;
            }
        }

        ~UnmanagedResources()
        {
            Dispose(false);
        }
    }
}