CA1041: ObsoleteAttribute iletisi sağlayın

TypeName	ProvideObsoleteAttributeMessage
CheckId	CA1041
Kategori	Microsoft.Design
Değişiklik kesiliyor	Bölünemez

Neden

Türü veya üye olarak işaretlenmiş bir ObsoleteAttribute sahip olmadığı özniteliği, ObsoleteAttribute.Message belirtilen özelliği.

Kural Tanımı

ObsoleteAttributeKaldırılan kitaplık türleri ve üyeleri işaretlemek için kullanılır.Kitaplık tüketiciler herhangi bir tür ya da eski işaretlenmiş üye kullanımı kaçınmanız gerekir.Desteklenmiyor ve sonraki sürümlerinde bir kitaplık sonunda kaldırılacak olmasıdır.Türü veya üye olduğunda işaretlenmiş kullanarak ObsoleteAttribute derlenmiş, Message özniteliği özellik görüntülenir.Bu eski türü veya üye kullanıcı bilgilerini sağlar.Bu bilgiler genellikle ne kadar eski türü içerir veya üye kullanmak üzere kitaplık tasarımcıları ve tercih edilen değiştirme tarafından desteklenecektir.

İhlalleri düzeltmek nasıl

Bu kuralı ihlal düzeltmek için ekleme message parametresi ObsoleteAttribute kurucusu.

Uyarıları ne zaman

Çünkü bu kuraldan uyarı engelleme Message özelliği eski türü veya üye ile ilgili önemli bilgiler sağlar.

Örnek

Aşağıdaki örnek doğru bildirilmiş olan eski bir üye gösterir 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";
            }
        }
    };
}

Ayrıca bkz.

Başvuru

ObsoleteAttribute