Compartilhar via


Definir o descritor de tipo de um parâmetro

Um descritor de tipo contém propriedades que descrevem o tipo de dados de um parâmetro. Um descritor de tipo pode definir um campo, uma entidade ou uma coleção de entidades. Para obter mais informações, consulte TypeDescriptor.

Para definir o descritor de tipo de um parâmetro

  1. Na janela Detalhes do Método BDC, escolha o descritor de tipo do parâmetro.

  2. Na barra de menus, escolha Exibir, Janela de Propriedades.

  3. Na janela Propriedades, defina as propriedades do descritor de tipo.

    Os procedimentos a seguir descrevem como definir um descritor de tipo como um campo, uma entidade ou uma coleção de entidades.

Para definir um campo

  1. Na janela Propriedades, defina a propriedade Nome do descritor de tipo como o nome de um campo no tipo que representa a entidade (por exemplo, FirstName).

  2. Na lista ao lado da propriedade TypeName, escolha o tipo de dados apropriado (por exemplo, Int32).

    Para obter informações sobre outros parâmetros opcionais, consulte TypeDescriptor.

Para definir uma entidade

  1. Na janela Propriedades, defina a propriedade Nome como um nome que descreve a entidade (por exemplo, Contato).

  2. Defina a propriedade TypeName como o nome totalmente qualificado do tipo que representa a entidade. Esse tipo pode ser uma classe em seu projeto, um tipo definido em um assembly que você referencia em sua solução ou um tipo definido no modelo de objeto BDC.

    • Para uma classe em seu projeto, escolha a seta para baixo ao lado da propriedade TypeName, escolha a guia Projeto Atual na caixa de diálogo exibida e escolha a classe no projeto.

      O nome totalmente qualificado inclui o namespace e o nome da classe, seguidos pelo nome do sistema LOB. O exemplo a seguir define o valor da propriedade TypeName como uma classe no projeto.

      MyBDCNamespace.BdcModel1.Contact, BdcModel1

    • Para um tipo localizado em um assembly na solução, o nome totalmente qualificado inclui o nome do tipo, o nome do assembly, o número de versão, a cultura e o token de chave pública.

      O exemplo a seguir define o valor da propriedade TypeName como um tipo definido em um assembly que você referencia na solução.

      MyNamespace.Contact, myAssemblyName, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089

    • Para um tipo definido no modelo de objeto BDC, o nome totalmente qualificado inclui o namespace e o nome do tipo.

      O exemplo a seguir define o valor da propriedade TypeName como um tipo no modelo de objeto BDC.

      Microsoft.BusinessData.Runtime.DynamicType

  3. Na janela Detalhes do Método BDC, abra a lista que aparece para o descritor de tipo e escolha Editar.

    A janela BDC Exploreré aberta.

  4. No BDC Explorer, abra o menu de atalho do descritor de tipo e escolha Adicionar Descritor de Tipo.

    Um novo descritor de tipo é adicionado como filho ao descritor de tipo de entidade. Configure esse descritor de tipo como um campo.

  5. Repita a etapa 4 para adicionar um descritor de tipo filho para cada campo da entidade.

Para definir uma coleção de entidades

  1. Na janela Detalhes do Método BDC, escolha o descritor de tipo do parâmetro desejado.

  2. Na barra de menus, escolha Exibir, Janela de Propriedades.

  3. Na janela Propriedades, defina a propriedade Nome como um nome que descreve a entidade (por exemplo, Contatos).

  4. Defina a propriedade IsCollection como True. Isso indica que esse descritor de tipo é uma coleção de entidades.

  5. Defina a propriedade TypeName como uma cadeia de caracteres que contém uma referência à interface IEnumerable<T>, bem como o nome totalmente qualificado do tipo que representa a entidade. Esse tipo pode ser uma classe em seu projeto, um tipo definido em um assembly que você referencia em sua solução ou um tipo definido no modelo de objeto BDC.

    • Para uma classe em seu projeto, escolha a seta para baixo ao lado da propriedade TypeName, escolha a guia Projeto Atual na caixa de diálogo exibida e escolha a classe no projeto.

      O nome totalmente qualificado inclui o namespace e o nome da classe, seguidos pelo nome do sistema LOB.

      O exemplo a seguir define o valor da propriedade TypeName como uma coleção de classes no projeto.

      System.Collections.Generic.IEnumerable1 [MyBDCNamespace.BdcModel1.Contact, BdcModel1]`

    • Para um tipo localizado em um assembly na solução, o nome totalmente qualificado inclui o nome do tipo, o nome do assembly, o número de versão, a cultura e o token de chave pública.

      O exemplo a seguir define o valor da propriedade TypeName como uma coleção de tipos em um assembly que você referencia na solução.

      System.Collections.Generic.IEnumerable1 [MyNamespace.Contact, myAssemblyName, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]`

    • Para um tipo definido no modelo de objeto BDC, o nome totalmente qualificado inclui somente o namespace e o nome do tipo.

      O exemplo a seguir define o valor da propriedade TypeName como uma coleção de tipos definidos no modelo de objeto BDC.

      System.Collections.Generic.IEnumerable1 [Microsoft.BusinessData.Runtime.DynamicType]`

  6. Na janela Detalhes do Método BDC, abra a lista que aparece para o descritor de tipo e escolha Editar.

    A janela BDC Exploreré aberta.

  7. No BDC Explorer, abra o menu de atalho do descritor de tipo e escolha Adicionar Descritor de Tipo.

    Um novo descritor de tipo é adicionado como filho ao descritor de tipo da coleção. Configure esse descritor de tipo como uma entidade.