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