Compartilhar via


Sobre as propriedades do OLE DB

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. Os consumidores 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, para propriedades de conjunto de linhas, um indicador de se ela pode ser aplicada em uma base coluna por coluna.

Uma propriedade é identificada por um GUID e um inteiro que representa a ID da 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 da fonte de dados, o grupo de propriedades de sessão, o grupo de propriedades do conjunto de linhas, o grupo de propriedades da tabela e o grupo de propriedades da coluna. Há propriedades em cada um desses grupos de propriedades.

Definir valores de propriedade envolve:

  1. Determinando as propriedades para as quais definir valores.

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

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

  4. Alocando 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 a esse conjunto de propriedades.

  5. Preenchendo a estrutura DBPROP para cada propriedade.

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

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

Consulte Também

Criando um aplicativo de provedor OLE DB de cliente nativo do SQL Server
Propriedades (OLE DB)