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 -> boolPublic 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を更新できるようにします。