Compartilhar via


CA1041: Fornecer ObsoleteAttribute mensagem

TypeName

ProvideObsoleteAttributeMessage

CheckId

CA1041

<strong>Categoria</strong>

Microsoft.design

Alteração significativa

Não-separável

Causa

Um tipo ou membro é marcado por meio de um System.ObsoleteAttribute atributo que não tem seu ObsoleteAttribute.Message a propriedade especificada.

Descrição da regra

ObsoleteAttributeé usado para marcar obsoletas de biblioteca de tipos e membros.Os consumidores de biblioteca devem evitar o uso de qualquer tipo ou membro que está marcado como obsoleto.Isso ocorre porque ele talvez não tenham suporte e, eventualmente, será removido de versões posteriores da biblioteca.Quando um tipo ou membro marcado por meio de ObsoleteAttribute é compilado, o Message a propriedade do atributo é exibida.Isso permite que as informações do usuário sobre o tipo obsoleto ou membro.Essas informações geralmente incluem quanto tempo o obsoleto tipo ou membro será suportado pelos designers de biblioteca e a substituição preferencial para usar.

Como corrigir violações

Para corrigir uma violação desta regra, adicione a message parâmetro para o ObsoleteAttribute construtor.

Quando suprimir avisos

Não suprimir um aviso desta regra porque o Message propriedade fornece informações essenciais sobre o tipo obsoleto ou membro.

Exemplo

O exemplo a seguir mostra um membro obsoleto que tenha declarado corretamente ObsoleteAttribute.

Imports System

Namespace DesignLibrary

    Public Class ObsoleteAttributeOnMember

        <ObsoleteAttribute("This property is obsolete and will " & _
             "be removed in a future version. Use the FirstName " & _
             "and LastName properties instead.", False)> _
        ReadOnly Property Name As String
            Get
                Return "Name"
            End Get
        End Property

        ReadOnly Property FirstName As String
            Get
                Return "FirstName"
            End Get
        End Property

        ReadOnly Property LastName As String
            Get
                Return "LastName"
            End Get
        End Property

    End Class

End Namespace
using System;

namespace DesignLibrary
{
    public class ObsoleteAttributeOnMember
    {
        [ObsoleteAttribute("This property is obsolete and will " +
             "be removed in a future version. Use the FirstName " +
             "and LastName properties instead.", false)]
        public string Name
        {
            get
            {
                return "Name";
            }
        }

        public string FirstName
        {
            get
            {
                return "FirstName";
            }
        }

        public string LastName
        {
            get
            {
                return "LastName";
            }
        }

    }
}
using namespace System;

namespace DesignLibrary
{
    public ref class ObsoleteAttributeOnMember
    {
    public:
        [ObsoleteAttribute("This property is obsolete and will " 
            "be removed in a future version. Use the FirstName " 
            "and LastName properties instead.", false)]
        property String^ Name
        {
            String^ get()
            {
               return "Name";
            }
        }

        property String^ FirstName
        {
            String^ get()
            {
               return "FirstName";
            }
        }

        property String^ LastName
        {
            String^ get()
            {
               return "LastName";
            }
        }
    };
}

Consulte também

Referência

System.ObsoleteAttribute