LogProviderBase.CanUpdate(String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
确定日志提供程序是否支持将包 XML 升级到更高版本的日志提供程序。
public:
virtual bool CanUpdate(System::String ^ CreationName);
public virtual bool CanUpdate (string CreationName);
abstract member CanUpdate : string -> bool
override this.CanUpdate : string -> bool
Public Overridable Function CanUpdate (CreationName As String) As Boolean
参数
- CreationName
- String
用于创建对象的实例的字符串。
返回
如果参数中指定的 CreationName
日志提供程序能够更新其对象元数据,则为 true;否则为 false。 默认值为 false。
注解
在传送能够更新日志提供程序包 XML 的日志提供程序的较新版本时,在日志提供程序中重写此方法。 如果返回 true
运行时引擎将调用方法 Update 来更新日志提供程序的包 XML。
例如,通过重写 SaveToXml 方法,部署日志提供程序的版本 A
,并将某些自定义属性存储在包 XML 中。 在将来的日期,你提供不再支持此属性的日志提供程序版本 B
,并且具有较新的属性。 当运行时引擎发现 Version 包中包含的日志提供程序的属性是 A
,但计算机上安装的日志提供程序是 B
,它会调用此方法来查看日志提供程序是否能够更新包 XML。 如果返回 true
,运行时引擎将调用 Update 该方法,以便更新 XML。