MetadataSerializationContext.UpdateModel Método

Definição

Namespace:

Microsoft.AnalysisServices.Tabular.Serialization

Assembly:

Microsoft.AnalysisServices.Tabular.dll

Pacote:

Microsoft.AnalysisServices v19.87.2

Sobrecargas

UpdateModel(Model, Object)	Atualiza o Model fornecido com base no conteúdo dos documentos de metadados armazenados no contexto.
UpdateModel(Model, MetadataDeserializationOptions, Object)	Atualiza o Model fornecido com base no conteúdo dos documentos de metadados armazenados no contexto.

UpdateModel(Model, Object)

Atualiza o Model fornecido com base no conteúdo dos documentos de metadados armazenados no contexto.

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)

Parâmetros

model

Model

O modelo a ser atualizado.

context

Object

Um contexto de usuário opcional que será associado à operação de serialização.

Exceções

ArgumentNullException

O modelo especificado é uma referência nula (Nothing no Visual Basic).

InvalidOperationException

Não há documentos de metadados carregados no contexto.

Comentários

Há certas limitações no conteúdo dos documentos no contexto que têm suporte em tal operação de atualização:

• Eles não podem apenas atualizar propriedades específicas em um objeto, ele só pode ser usado para atualizar o objeto inteiro, bem como qualquer objeto filho incluído em sua árvore de metadados.
• Os objetos Database e\ou Model não podem ser atualizados nesta operação, apenas objetos de metadados que são filhos, diretos ou indiretos, do modelo.
• Não há garantia de nenhuma ordem específica na qual os documentos no contexto serão processados, verifique se não há dependências entre documentos.
• Não há garantia de que o modelo de destino permanecerá intacto em caso de falha; se o método falhou e uma exceção for gerada, o modelo de destino poderá ter sido parcialmente atualizado e incluir algumas alterações baseadas em documentos que já foram processados antes do documento que falhou e disparou a exceção.

A operação de desserializar o conteúdo de metadados dos documentos no contexto, bem como atualizar o modelo de acordo com o conteúdo, pode gerar exceções específicas ao estilo do conteúdo que está sendo desserializado; por exemplo, uma desserialização do conteúdo TMDL pode resultar em um TmdlFormatException ou um TmdlSerializationException gerado para erros nos documentos.

UpdateModel(Model, MetadataDeserializationOptions, Object)

Atualiza o Model fornecido com base no conteúdo dos documentos de metadados armazenados no contexto.

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)

Parâmetros

model

Model

O modelo a ser atualizado.

options

MetadataDeserializationOptions

As opções para a ação de desserialização.

context

Object

Um contexto de usuário opcional que será associado à operação de serialização.

Exceções

ArgumentNullException

• O modelo especificado é uma referência nula (Nothing no Visual Basic).
• A instância de opções especificada é uma referência nula (Nothing in Visual Basic).

InvalidOperationException

Não há documentos de metadados carregados no contexto.

Comentários

Há certas limitações no conteúdo dos documentos no contexto que têm suporte em tal operação de atualização:

• Eles não podem apenas atualizar propriedades específicas em um objeto, ele só pode ser usado para atualizar o objeto inteiro, bem como qualquer objeto filho incluído em sua árvore de metadados.
• Os objetos Database e\ou Model não podem ser atualizados nesta operação, apenas objetos de metadados que são filhos, diretos ou indiretos, do modelo.
• Não há garantia de nenhuma ordem específica na qual os documentos no contexto serão processados, verifique se não há dependências entre documentos.
• Não há garantia de que o modelo de destino permanecerá intacto em caso de falha; se o método falhou e uma exceção for gerada, o modelo de destino poderá ter sido parcialmente atualizado e incluir algumas alterações baseadas em documentos que já foram processados antes do documento que falhou e disparou a exceção.

A operação de desserializar o conteúdo de metadados dos documentos no contexto, bem como atualizar o modelo de acordo com o conteúdo, pode gerar exceções específicas ao estilo do conteúdo que está sendo desserializado; por exemplo, uma desserialização do conteúdo TMDL pode resultar em um TmdlFormatException ou um TmdlSerializationException gerado para erros nos documentos.