Gerar código com as extensões da ferramenta de geração de código (Dynamics CRM 2015)

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

As extensões de desenvolvedor para Atualização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 fornecem uma biblioteca de extensão para a ferramenta de geração de código CrmSvcUtil.exe usada para gerar uma classe de contexto de dados e objetos de transferência de dados (DTOs) para todas as entidades de Microsoft Dynamics 365. Esse mecanismo segue o mesmo padrão do design que SqlMetal implementa na estrutura da entidade. A classe de contexto de dados é responsável por todas as operações de dados e fornece interfaces IQueryable para todas as entidades em Microsoft Dynamics 365. Você pode recuperar dados executando uma consulta LINQ nas propriedades definidas da entidade IQueryable. Você pode alterar dados usando os métodos AddObject, DeleteObject, UpdateObject e SaveChanges.

A extensão Microsoft.Xrm.Client.CodeGeneration da ferramenta de geração de código CrmSvcUtil.exe fornece os seguintes recursos:

• Gerencia estaticamente classes de entidade digitadas.

• Gera muitas para muitas classes de relacionamentos.

• Gera nomes de classe e nomes de propriedade com base em nomes de esquema de Microsoft Dynamics 365.

• Gera uma classe de contexto de dados de Serviços de Dados do WCF compatível (Astoria/OData) para gerenciar entidades.

Neste tópico

Classes de entidade

Classes de contexto de dados

Classes de entidade

As classes de entidade geradas pela ferramenta de geração de código fornecem os seguintes recursos:

• Suporte para atributos da anotação de Serviços de Dados do WCF (Astoria/OData).

• Acessadores de atributos de entidade fortemente tipados, que proporcionam o seguinte:

  • Mapeamento de tipos de dados de Microsoft Dynamics 365 para tipos de dados padrão do CLR.

  • Acessadores para relacionamento de muitos-para-um, incluindo:

    • Carregamento preguiçoso da entidade relacionada.

    • Acessadores para IDs de chave estrangeira.

  • Acessadores de relacionamento muitos-para-muitos, que proporcionam carregamento preguiçoso do conjunto da entidade relacionada.

Classes de contexto de dados

As classes de contexto de dados geradas por CrmSvcUtil.exe com a extensão Microsoft.Xrm.Client.CodeGeneration usam os Serviços de Dados do WCF IUpdatable e Interface de IExpandProvider como uma consequência da herança da classe CrmOrganizationServiceContext. Para obter mais informações, consulte a seguinte documentação do .NET: Interface de IUpdatable e Interface de IExpandProvider. Essas interfaces incluem os seguintes recursos:

• Fornece operações de leitura, criação, atualização e exclusão para gerenciar entidades.

• Fornece operações para definir link, adicionar link e remover link para gerenciar relacionamentos (1-para-N, N-para-1 e N-para-N).

• Oferece suporte para DataServiceHostFactory para expor serviços Web e serviços REST.

• Fornece um provedor de consulta LINQ para consultas digitadas estática ou dinamicamente.

• As consultas dinâmicas não exigem geração de código

• Lida com cachê em segundo plano.

Uma única classe de contexto será gerada para fornecer acessadores do conjunto de entidade estaticamente digitados. Além disso, várias subclasses são geradas para fornecer recursos mais avançados do portal usando os recursos de interceptor de consulta e alteração dos Serviços de Dados do WCF.

Confira Também

AddObject
DeleteObject
UpdateObject
SaveChanges
Extensões de desenvolvedor do Microsoft Dynamics CRM 2015
Modelo de objeto do contexto das extensões de desenvolvedor (Dynamics CRM 2015)
Parâmetros de uso e da linha de comando da extensão CrmSvcUtil.exe (Dynamics CRM 2015)
Use os arquivos de classe gerados

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais