Unity的[Obsolete]属性

参考：https://www.tutorialspoint.com/What-are-obsolete-attributes-in-Chash
参考：https://docs.microsoft.com/en-us/dotnet/api/system.obsoleteattribute?view=net-6.0
参考：https://stackoverflow.com/questions/31804260/do-unity-functions-that-are-obsolete-still-work

C#自身就有一个ObsoleteAttribute类，其实Unity用的就是它：

namespace System
{[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Enum | AttributeTargets.Constructor | AttributeTargets.Method | AttributeTargets.Property | AttributeTargets.Field | AttributeTargets.Event | AttributeTargets.Interface | AttributeTargets.Delegate, Inherited = false)]public sealed class ObsoleteAttribute : Attribute{public ObsoleteAttribute();public ObsoleteAttribute(string message);public ObsoleteAttribute(string message, bool error);public bool IsError { get; }public string Message { get; }}
}

只要把这个Attribute加到Method上面，编译器会去检测，当Method被调用时，就发出Warning或Error。可以看到ObsoleteAttribute的构造函数最多接受俩参数，第二个参数为true，则编译器会编译失败，生成Error，否则生成Warning，具体的信息由第一个参数message表示。

用法很简单，用于过时的Method上，Unity官方在更新它的C#代码时，经常使用这个Attribute，写法如下：

using System;public class Demo {// 保留原本的代码, 添加Obsolete属性[Obsolete("Old Method shouldn't be used! Use New Method instead", true)]static void OldMethod() {Console.WriteLine("This is the old method!");}static void NewMethod() {Console.WriteLine("This is the new method!");}public static void Main() {OldMethod();}
}

也可以啥都不写[Obsolete]:

public class TestAnimation : MonoBehaviour
{// 输出Assets\TestAnimation.cs(49,9): warning CS0618: 'TestAnimation.FFF()' is obsolete: 'FF'[Obsolete("FF")]public void FFF(){}// 输出Assets\TestAnimation.cs(56,9): warning CS0612: 'TestAnimation.SSS()' is obsolete    [Obsolete]// 其实这玩意儿对于代码执行, 没有任何影响public void SSS(){}void Start(){FFF();SSS();// 必须得用上才会有编译提示}
}

最后顺便说一句，这一部分的内容是写到C#编译器里的(ObsoleteAttribute is effectively hard-coded into the C# compiler )，所以要想实现自己版本的CustomObsoleteAttribute，几乎是不太可能的。

Unity的[Obsolete]属性相关推荐

unity材质球属性无法修改
unity材质球属性无法修改出现的问题情况: 解决办法出现的问题情况: 如图,unity材质球属性是灰色的无法修改解决办法找到材质球然后对原来的材质球进行复制(Crtl+D),再将复制后的材质 ...
Unity 灯光设置 —— 灯光属性
Unity 灯光属性 Type:灯光类型,所有类型的灯光都其实共用一个组件,本质上是一样的. Color : 灯光颜色 Mode : 灯光模型有Realtime,Baked,Mixed三种 Reati ...
Unity之ASE 属性面板详解
前言我们详细的讲解下ASE编辑器的属性面板. 我们先来看下大致的面板信息,如果对某一条属性有疑问,可以往后查找 1.General 通用面板 Shader Name: Editable text b ...
【Unity】Inspector属性
Attribute(属性)的作用直接体现在Inspector窗口中,通过使用Attribute,可以对Inspector窗口的内容进行灵活展现和管理,相当于一个辅助工具. RequireCompone ...
Unity修改材质属性（包含自建Shader）
Shader的属性窗口定义很多属性,例如: 而我想更改他的Lerp end值,就需要拿到这个值: GetComponent<Renderer>().material.SetFloat( ...
【Unity】编辑器属性
using UnityEngine; using System.Collections;// 会在编辑模式下运行Update FixedUpdate OnGUI [ExecuteInEditMode] ...
Unity:RectTransform面板属性获取
如图,transform.Position和rect.transform.position是一个东西,经过检测,数值一样. anchoredPosition(或transform.Position,或 ...
Unity 2017 Game Optimization 读书笔记（3）Scripting Strategies Part 3
1.Avoid retrieving string properties from GameObjects 通常来讲,从C#的object中获取string 属性没有额外的内存开销,但是从Unity中 ...
C# Obsolete
Obsolete 属性将某个程序实体标记为一个建议不再使用的实体.每次使用被标记为已过时的实体时,随后将生成警告或错误,这取决于属性是如何配置的.例如: 上面在Main函数中调用,只产生了一个警告的信 ...
Unity官方教程Ruby大冒险的自学笔记
Unity官方教程Ruby大冒险的自学笔记一. //正确例子: void Update(){//获取运动矢量moveX = Input.GetAxisRaw("Horizontal&quo ...

Unity的[Obsolete]属性

Unity的[Obsolete]属性相关推荐

最新文章

热门文章