Partilhar via


Propriedades da fonte de dados (OLE DB)

O provedor OLE DB SQL Server Native Client implementa as propriedades da fonte de dados da seguinte maneira.

ID da propriedade DESCRIÇÃO
DBPROP_CURRENTCATALOG Leitura/gravação: leitura/gravação Padrão: nenhum

Descrição: o valor de DBPROP_CURRENTCATALOG relata o banco de dados atual para uma sessão de provedor OLE DB SQL Server Native Client. A definição do valor da propriedade tem o mesmo efeito de definir o banco de dados atual usando a instrução USE database do Transact-SQL.

A partir do SQL Server 2005, se você chamar sp_defaultdb e especificar o nome do banco de dados em letras minúsculas, mesmo que o banco de dados tenha sido originalmente criado com um nome de caso misto, DBPROP_CURRENTCATALOG retornará o nome em letras minúsculas. Nas versões anteriores do SQL Server, DBPROP_CURRENTCATALOG retornará as maiúsculas e minúsculas esperadas.
DBPROP_MULTIPLECONNECTIONS Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE

Descrição: se a conexão estiver executando um comando que não gera um conjunto de linhas ou que gera um conjunto de linhas que não é um cursor de servidor e você executar um outro comando, será criada uma nova conexão para executar o novo comando, se DBPROP_MULTIPLECONNECTIONS for VARIANT_TRUE.

O provedor OLE DB SQL Server Native Client não criará outra conexão se DBPROP_MULTIPLECONNECTION estiver VARIANT_FALSE ou se uma transação estiver ativa na conexão. O provedor OLE DB SQL Server Native Client retornará DB_E_OBJECTOPEN se DBPROP_MULTIPLECONNECTIONS for VARIANT_FALSE e retornar E_FAIL se houver uma transação ativa. As transações e o bloqueio são gerenciados pelo SQL Server por conexão. Se uma segunda conexão for gerada, os comandos nas conexões separadas não compartilharão bloqueios. Para assegurar um comando não bloqueie o outro, mantenha os bloqueios em linhas solicitadas pelo outro comando. Isto também se aplica à criação de várias sessões.

Cada sessão tem uma conexão separada.

No conjunto de propriedades específico do provedor DBPROPSET_SQLSERVERDATASOURCE, o provedor OLE DB SQL Server Native Client define as propriedades adicionais da fonte de dados a seguir.

ID da propriedade DESCRIÇÃO
SSPROP_ENABLEFASTLOAD Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE

Descrição: para habilitar a cópia em massa da memória, a propriedade SSPROP_ENABLEFASTLOAD deve ser definida como VARIANT_TRUE. Com essa propriedade definida na fonte de dados, a sessão recém-criada permite que o consumidor acesse a interface IRowsetFastLoad.

Se a propriedade for definida como VARIANT_TRUE, a interface IRowsetFastLoad ficará disponível por meio de IOpenRowset::OpenRowset, solicitando a interface IID_IRowsetFastLoad ou definindo SSPROP_IRowsetFastLoad como VARIANT_TRUE.
SSPROP_ENABLEBULKCOPY Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE

Descrição: para habilitar a cópia em massa de arquivos, a propriedade SSPROP_ENABLEBULKCOPY deve ser definida como VARIANT_TRUE. Com essa propriedade definida na fonte de dados, o acesso do consumidor à interface IBCPSession está disponível no nível de Sessions.

SSPROP_IRowsetFastLoad também deve ser definido como VARIANT_TRUE.

Consulte Também

Objetos de fonte de dados (OLE DB)