MetadataSerializationContext.UpdateModel Metoda

Definice

Obor názvů:

Microsoft.AnalysisServices.Tabular.Serialization

Sestavení:

Microsoft.AnalysisServices.Tabular.dll

Balíček:

Microsoft.AnalysisServices v19.87.7

Přetížení

UpdateModel(Model, Object)	Aktualizuje poskytnuté Model na základě obsahu dokumentů metadat uložených v kontextu.
UpdateModel(Model, MetadataDeserializationOptions, Object)	Aktualizuje poskytnuté Model na základě obsahu dokumentů metadat uložených v kontextu.

UpdateModel(Model, Object)

Aktualizuje poskytnuté Model na základě obsahu dokumentů metadat uložených v kontextu.

public void UpdateModel (Microsoft.AnalysisServices.Tabular.Model model, object context = default);

member this.UpdateModel : Microsoft.AnalysisServices.Tabular.Model * obj -> unit

Public Sub UpdateModel (model As Model, Optional context As Object = Nothing)

Parametry

model

Model

Model, který se má aktualizovat.

context

Object

Volitelný kontext uživatele, který bude přidružen k operaci serializace.

Výjimky

ArgumentNullException

Zadaný model je odkaz null (Nothing v jazyce Visual Basic).

InvalidOperationException

Do kontextu nejsou načteny žádné dokumenty metadat.

Poznámky

Obsah dokumentů v kontextu, který je v takové operaci aktualizace podporovaný, má určitá omezení:

• Nemůžou pouze aktualizovat konkrétní vlastnosti v objektu, lze ho použít pouze k aktualizaci celého objektu a také k jakémukoli podřízeného objektu, který je součástí jeho stromu metadat.
• Objekty Database a\nebo Model nelze v této operaci aktualizovat, pouze objekty metadat, které jsou podřízené objekty modelu, ať už přímé nebo nepřímé.
• Neexistuje žádná záruka žádného konkrétního pořadí, ve kterém budou dokumenty v kontextu zpracovány, zajistěte, aby mezi dokumenty nebyly žádné závislosti.
• Neexistuje žádná záruka, že cílový model v případě selhání zůstane nedotčen; Pokud metoda selhala a vyvolá se výjimka, cílový model mohl být částečně aktualizován a zahrnovat některé změny založené na dokumentech, které byly již zpracovány před dokumentem, který selhal, a aktivoval výjimku.

Operace deserializace obsahu metadat dokumentů v kontextu, stejně jako aktualizace modelu podle obsahu, může vyvolat výjimky, které jsou specifické pro styl obsahu, který je deserializován; Například deserializace obsahu TMDL může vést k TmdlFormatException nebo TmdlSerializationException, který je vyvolán kvůli chybám v dokumentech.

UpdateModel(Model, MetadataDeserializationOptions, Object)

Aktualizuje poskytnuté Model na základě obsahu dokumentů metadat uložených v kontextu.

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 -> unit

Public Sub UpdateModel (model As Model, options As MetadataDeserializationOptions, Optional context As Object = Nothing)

Parametry

model

Model

Model, který se má aktualizovat.

options

MetadataDeserializationOptions

Možnosti akce deserializace.

context

Object

Volitelný kontext uživatele, který bude přidružen k operaci serializace.

Výjimky

ArgumentNullException

• Zadaný model je odkaz null (Nothing v jazyce Visual Basic).
• Zadaná instance možností je odkaz null (Nothing v jazyce Visual Basic).

InvalidOperationException

Do kontextu nejsou načteny žádné dokumenty metadat.

Poznámky

Obsah dokumentů v kontextu, který je v takové operaci aktualizace podporovaný, má určitá omezení:

• Nemůžou pouze aktualizovat konkrétní vlastnosti v objektu, lze ho použít pouze k aktualizaci celého objektu a také k jakémukoli podřízeného objektu, který je součástí jeho stromu metadat.
• Objekty Database a\nebo Model nelze v této operaci aktualizovat, pouze objekty metadat, které jsou podřízené objekty modelu, ať už přímé nebo nepřímé.
• Neexistuje žádná záruka žádného konkrétního pořadí, ve kterém budou dokumenty v kontextu zpracovány, zajistěte, aby mezi dokumenty nebyly žádné závislosti.
• Neexistuje žádná záruka, že cílový model v případě selhání zůstane nedotčen; Pokud metoda selhala a vyvolá se výjimka, cílový model mohl být částečně aktualizován a zahrnovat některé změny založené na dokumentech, které byly již zpracovány před dokumentem, který selhal, a aktivoval výjimku.

Operace deserializace obsahu metadat dokumentů v kontextu, stejně jako aktualizace modelu podle obsahu, může vyvolat výjimky, které jsou specifické pro styl obsahu, který je deserializován; Například deserializace obsahu TMDL může vést k TmdlFormatException nebo TmdlSerializationException, který je vyvolán kvůli chybám v dokumentech.