Sobre as propriedades do OLE DB do SQL Server Native Client

  • Artigo

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

Os consumidores definem valores de propriedade para solicitar um comportamento de objeto específico. Por exemplo, os consumidores usam propriedades para especificar as interfaces a serem expostas por um conjunto de linhas. Eles obtêm os valores de propriedade para determinar os recursos de um objeto, como um conjunto de linhas, uma sessão ou um objeto de fonte de dados.

Cada propriedade tem um valor, um tipo, uma descrição e um atributo de leitura/gravação e, no caso de propriedades de conjunto de linhas, um indicador que determina se ela pode ser aplicada por coluna.

Uma propriedade é identificada por um GUID e um inteiro que representam a ID de propriedade. Um conjunto de propriedades é um conjunto de todas as propriedades que compartilham o mesmo GUID. Além dos conjuntos de propriedades OLE DB predefinidos, o provedor OLE DB do SQL Server Native Client implementa conjuntos de propriedades e propriedades específicos do provedor neles. Cada propriedade pertence a um ou mais grupos de propriedades. Um grupo de propriedades é o grupo de todas as propriedades que se aplicam a um objeto específico. Alguns grupos de propriedades incluem o grupo de propriedades de inicialização, o grupo de propriedades de fonte de dados, o grupo de propriedades de sessão, o grupo de propriedades de conjunto de linhas, o grupo de propriedades de tabela e o grupo de propriedades de coluna. Há propriedades em cada um desses grupos de propriedade.

A definição dos valores de propriedade envolve:

  1. Determinar as propriedades para as quais definir valores.

  2. Determinar os conjuntos de propriedades que contêm as propriedades identificadas.

  3. Alocar uma matriz de estruturas DBPROPSET, uma para cada conjunto de propriedades identificadas.

  4. Alocar uma matriz de estruturas DBPROP para cada conjunto de propriedades. O número de elementos em cada matriz é o número de propriedades (identificadas na Etapa 1) que pertencem ao conjunto de propriedades.

  5. Preencher a estrutura DBPROP para cada propriedade.

  6. Preencher as informações (GUID do conjunto de propriedades, contagem do número de elementos e um ponteiro para a matriz DBPROP correspondente) na estrutura DBPROPSET para cada conjunto de propriedades.

  7. Chamar um método para definir propriedades e passar a contagem e a matriz de estruturas DBPROPSET.

Confira também

Criando um aplicativo provedor OLE DB do SQL Server Native Client
Propriedades (OLE DB)