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。
例如,你部署日志提供者的版本 A ,并通过覆盖 SaveToXml 方法,在包 XML 中存储一些自定义属性。 未来你会发布不再支持该属性、改用新属性的日志提供者版本 B 。 当运行时引擎发现 Version 包中日志提供者的属性是 A,但计算机上安装的日志提供者是 B时,它调用该方法来查看日志提供者是否能够更新包的 XML。 如果你返回 true,运行时引擎会调用该 Update 方法,允许你更新 XML。