MetadataSerializationContext.UpdateModel(Model, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
重要: TMDL はまだプレビュー段階であり、API サーフェスは GA より前に変更される可能性があります。
コンテキストに格納されているメタデータ ドキュメントの内容に基づいて、指定Modelされた を更新します。
public void UpdateModel (Microsoft.AnalysisServices.Tabular.Model model, object context = default);member this.UpdateModel : Microsoft.AnalysisServices.Tabular.Model * obj -> unitPublic Sub UpdateModel (model As Model, Optional context As Object = Nothing)パラメーター
- model
- Model
更新するモデル。
- context
- Object
シリアル化操作に関連付けられる省略可能なユーザー コンテキスト。
例外
指定されたモデルは null 参照です (Visual Basic では Nothing)。
コンテキストに読み込まれるメタデータ ドキュメントはありません。
注釈
このような更新操作でサポートされるコンテキスト内のドキュメントの内容には、特定の制限があります。
- オブジェクト内の特定のプロパティを更新するだけでなく、メタデータ ツリーに含まれる子オブジェクトと同様に、オブジェクト全体の更新にのみ使用できます。
- この操作では、Database オブジェクトおよび Model オブジェクトを更新することはできません。モデルの直接または間接の子であるメタデータ オブジェクトのみです。
- コンテキスト内のドキュメントが処理される特定の順序は保証されません。ドキュメント間に依存関係がないことを確認してください。
- 障害が発生した場合でもターゲット モデルがそのまま残る保証はありません。メソッドが失敗し、例外が発生した場合、ターゲット モデルが部分的に更新され、失敗して例外をトリガーしたドキュメントの前に既に処理されたドキュメントに基づくいくつかの変更が含まれている可能性があります。
コンテキスト内のドキュメントのメタデータ コンテンツを逆シリアル化する操作と、コンテンツに従ってモデルを更新する操作では、逆シリアル化されるコンテンツのスタイルに固有の例外が発生する可能性があります。たとえば、TMDL コンテンツを逆シリアル化すると、ドキュメント内の TmdlFormatException エラーに対して または TmdlSerializationException がスローされる可能性があります。