提供 ObsoleteAttribute 消息

更新：2007 年 11 月

原因

没有指定使用 System.ObsoleteAttribute 属性标记的类型或成员的 ObsoleteAttribute.Message 属性。

规则说明

ObsoleteAttribute 用于标记被否决的库类型和成员。库使用者应避免使用任何标记为已过时的类型或成员，因为这种类型或成员可能不受支持，最终将从更新版本的库中移除。编译使用 ObsoleteAttribute 标记的类型或成员时，将显示属性 (Attribute) 的 Message 属性 (Property)，为用户提供有关已过时类型或成员的信息。该信息通常包括库设计器还将支持已过时类型或成员的时间长度，以及首选的替代类型或成员。

如何修复冲突

要修复与该规则的冲突，请将 message 参数添加到 ObsoleteAttribute 构造函数。

何时禁止显示警告

由于 Message 属性提供有关已过时类型或成员的关键信息，因此不要禁止显示此规则发出的警告。

示例

下面的示例演示一个具有正确声明的 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";
            }
        }
    };
}

请参见

参考

System.ObsoleteAttribute