Propriedades e comportamentos do conjunto de linhas
Estas são as propriedades do conjunto de linhas do provedor OLE DB do SQL Server Native Client.
ID da propriedade |
Descrição |
|---|---|
DBPROP_ABORTPRESERVE |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: o comportamento de um conjunto de linhas depois de uma operação de anulação é determinado por esta propriedade. VARIANT_FALSE: o provedor OLE DB do SQL Server Native Client invalida conjuntos de linhas depois de uma operação de anulação. A funcionalidade do objeto de conjunto de linhas está praticamente perdida. Ela dá suporte apenas para operações IUnknown e a versão de identificadores de linha e acessador pendentes. VARIANT_TRUE: o provedor OLE DB do SQL Server Native Client mantém um conjunto de linhas válido. |
DBPROP_ACCESSORDER |
Leitura/gravação: leitura/gravação Padrão: DBPROPVAL_AO_RANDOM Descrição: ordem de acesso. A ordem em que as colunas devem ser acessadas no conjunto de linhas. DBPROPVAL_AO_RANDOM: a coluna pode ser acessada em qualquer ordem. DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: as colunas associadas como objetos de armazenamento podem apenas ser acessadas na ordem seqüencial determinada pelo ordinal de coluna. DBPROPVAL_AO_SEQUENTIAL: todas as colunas devem ser acessadas na ordem seqüencial determinada pelo ordinal de coluna. |
DBPROP_APPENDONLY |
Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
DBPROP_BLOCKINGSTORAGEOBJECTS |
Leitura/gravação: somente leitura Padrão: VARIANT_TRUE Descrição: os objetos de armazenamento do provedor OLE DB do SQL Server Native Client são bloqueados usando outros métodos de conjunto de linhas. |
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client dá suporte a indicadores para identificação de linha do conjunto de linhas quando DBPROP_BOOKMARKS ou DBPROP_LITERALBOOKMARKS é VARIANT_TRUE. A definição de qualquer uma das propriedades como VARIANT_TRUE não habilita o posicionamento do conjunto de linhas por indicador. Defina DBPROP_IRowsetLocate ou DBPROP_IRowsetScroll como VARIANT_TRUE para criar um conjunto de linhas que dê suporte ao posicionamento do conjunto de linhas por indicador. O provedor OLE DB do SQL Server Native Client usa um cursor do MicrosoftSQL Server para dar suporte a um conjunto de linhas que contenha indicadores. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server. .gif "Observação") Observação
A definição destas propriedades em conflito com outras propriedades de definição de cursor do provedor OLE DB do SQL Server Native Client provoca um erro. Por exemplo, a definição de DBPROP_BOOKMARKS como VARIANT_TRUE quando DBPROP_OTHERINSERT também é VARIANT_TRUE gera um erro quando o consumidor tenta abrir um conjunto de linhas.
|
DBPROP_BOOKMARKSKIPPED |
Leitura/gravação: somente leitura Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client retornará DB_E_BADBOOKMARK se o consumidor especificar um indicador inválido ao posicionar ou pesquisar um conjunto de linhas com indicadores. |
DBPROP_BOOKMARKTYPE |
Leitura/gravação: somente leitura Padrão: DBPROPVAL_BMK_NUMERIC Descrição: o provedor OLE DB do SQL Server Native Client implementa apenas indicadores numéricos. Um indicador do provedor OLE DB do SQL Server Native Client é um número inteiro sem sinal de 32 bits, tipo DBTYPE_UI4. |
DBPROP_CACHEDEFERRED |
Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client dá suporte à busca e rolagem regressiva em conjuntos de linhas não seqüenciais. O provedor OLE DB do SQL Server Native Client cria um conjunto de linhas com suporte de cursor quando DBPROP_CANFETCHBACKWARDS ou DBPROP_CANSCROLLBACKWARDS é VARIANT_TRUE. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server. |
DBPROP_CANHOLDROWS |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: por padrão, o provedor OLE DB do SQL Server Native Client retornará DB_E_ROWSNOTRELEASED se o consumidor tentar obter mais linhas para um conjunto de linhas enquanto existirem alterações pendentes nessas linhas atualmente no conjunto. Este comportamento pode ser modificado. A definição de DBPROP_CANHOLDROWS e DBPROP_IRowsetChange como VARIANT_TRUE implica um conjunto de linhas com indicadores. Se as duas propriedades forem VARIANT_TRUE, a interface IRowsetLocate estará disponível no conjunto de linhas e DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS serão ambos VARIANT_TRUE. Os conjuntos de linhas do provedor OLE DB do SQL Server Native Client que contêm indicadores têm suporte dos cursores do SQL Server. |
DBPROP_CHANGEINSERTEDROWS |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: esta propriedade só poderá ser definida como VARIANT_TRUE se o conjunto de linhas estiver usando um cursor controlado por conjunto de chaves. |
DBPROP_COLUMNRESTRICT |
Leitura/gravação: somente leitura Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client define a propriedade como VARIANT_TRUE quando uma coluna em um conjunto de linhas não pode ser alterada pelo consumidor. Outras colunas no conjunto de linhas podem ser atualizáveis e as linhas em si podem ser excluídas. Quando a propriedade é VARIANT_TRUE, o consumidor examina o membro dwFlags da estrutura DBCOLUMNINFO para determinar se o valor de uma coluna individual poderá ser gravado ou não. Para colunas modificáveis, dwFlags exibe DBCOLUMNFLAGS_WRITE. |
DBPROP_COMMANDTIMEOUT |
Leitura/gravação: leitura/gravação Padrão: 0 Descrição: por padrão, o tempo limite do provedor OLE DB do SQL Server Native Client não se esgota no método ICommand::Execute. |
DBPROP_COMMITPRESERVE |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: o comportamento de um conjunto de linhas depois de uma operação de confirmação é determinado por esta propriedade. VARIANT_TRUE: o provedor OLE DB do SQL Server Native Client mantém um conjunto de linhas válido. VARIANT_FALSE: o provedor OLE DB do SQL Server Native Client invalida conjuntos de linhas depois de uma operação de confirmação. A funcionalidade do objeto de conjunto de linhas está praticamente perdida. Ela dá suporte apenas para operações IUnknown e a versão de identificadores de linha e acessador pendentes. |
DBPROP_DEFERRED |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: em caso de definição como VARIANT_TRUE, o provedor OLE DB do SQL Server Native Client tenta usar um cursor de servidor para o conjunto de linhas. As colunas Text, ntext e image não são retornadas do servidor até serem acessadas pelo aplicativo. |
DBPROP_DELAYSTORAGEOBJECTS |
Leitura/gravação: somente leitura Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client dá suporte ao modo de atualização imediata em objetos de armazenamento. As alterações feitas a dados em um objeto de fluxo seqüencial são imediatamente enviadas para o SQL Server. As modificações são confirmadas com base no modo de transação de conjunto de linhas. |
DBPROP_HIDDENCOLUMNS |
Leitura/gravação: somente leitura Padrão: VARIANT_FALSE Descrição: contagem de coluna oculta Se DBPROP_UNIQUEROWS for VARIANT_TRUE, a propriedade DBPROP_HIDDENCOLUMNS retornará o número de colunas "ocultas" adicionais incluídas pelo provedor para identificar com exclusividade as linhas dentro do conjunto de linhas. Essas colunas são retornadas por IColumnsInfo::GetColumnInfo e IColumnsRowset::GetColumnsRowset. No entanto, elas não são incluídas na contagem de linhas retornadas pelo argumento pcColumns retornado por IColumnsInfo::GetColumnInfo. Para determinar o número total de colunas representadas na estrutura prgInfo retornada por IColumnsInfo::GetColumnInfo, incluindo as colunas ocultas, o consumidor adicionará o valor de DBPROP_HIDDENCOLUMNS à contagem de colunas retornadas de IColumnsInfo::GetColumnInfo em pcColumns. Se DBPROP_UNIQUEROWS for VARIANT_FALSE, DBPROP_HIDDENCOLUMNS será zero. |
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo |
Leitura/gravação: somente leitura Padrão: VARIANT_TRUE Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para estas interfaces em todos os conjuntos de linhas. |
DBPROP_IColumnsRowset |
Leitura/gravação: leitura/gravação Padrão: VARIANT_TRUE Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para a interface IColumnsRowset. |
DBPROP_IConnectionPointContainer |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: IConnectionPointContainer. Se for VARIANT_TRUE, o conjunto de linhas terá suporte para a interface especificada. Se for VARIANT_FALSE, o conjunto de linhas não terá suporte para a interface especificada. Os provedores que têm suporte para a interface devem aceitar a propriedade associada a essa interface com um valor de VARIANT_TRUE. Essas propriedades são usadas para solicitar interfaces por ICommandProperties::SetProperties. |
DBPROP_IMultipleResults |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client tem suporte para a interface IMultipleResults. |
DBPROP_IRowsetChange DBPROP_IRowsetUpdate |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para as interfaces IRowsetChange e IRowsetUpdate. Um conjunto de linhas criado usando DBPROP_IRowsetChange igual a VARIANT_TRUE exibe comportamentos de modo de atualização imediatos. Quando DBPROP_IRowsetUpdate é VARIANT_TRUE, DBPROP_IRowsetChange também é VARIANT_TRUE. O conjunto de linhas exibe comportamento de modo de atualização com atraso. O provedor OLE DB do SQL Server Native Client usa um cursor do SQL Server para dar suporte a conjuntos de linhas que expõem IRowsetChange ou IRowsetUpdate. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server. |
DBPROP_IRowsetIdentity |
Leitura/gravação: leitura/gravação Padrão: VARIANT_TRUE Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para a interface IRowsetIdentity. Se um conjunto de linhas der suporte para essa interface, qualquer uma das duas alças de linha que represente a mesma linha subjacente sempre refletirá os mesmos dados e estado. Consumidores podem chamar o método IRowsetIdentity:: IsSameRow para comparar duas alças de linha para ver se elas se referem à mesma instância de linha. |
DBPROP_IRowsetLocate DBPROP_IRowsetScroll |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client pode expor as interfaces IRowsetLocate e IRowsetScroll. Quando DBPROP_IRowsetLocate é VARIANT_TRUE, DBPROP_CANFETCHBACKWARDS e DBPROP_CANSCROLLBACKWARDS também são VARIANT_TRUE. Quando DBPROP_IRowsetScroll é VARIANT_TRUE, DBPROP_IRowsetLocate também é VARIANT_TRUE e ambas as interfaces estão disponíveis no conjunto de linhas. São exigidos indicadores para qualquer interface. O provedor OLE DB do SQL Server Native Client define DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS como VARIANT_TRUE quando o consumidor solicita qualquer uma das interfaces. O provedor OLE DB do SQL Server Native Client usa cursores do SQL Server para dar suporte a IRowsetLocate e IRowsetScroll. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server. A definição destas propriedades em conflito com outras propriedades de definição de cursor do provedor OLE DB do SQL Server Native Client provoca um erro. Por exemplo, a definição de DBPROP_IRowsetScroll como VARIANT_TRUE quando DBPROP_OTHERINSERT também é VARIANT_TRUE gera um erro quando o consumidor tenta abrir um conjunto de linhas. |
DBPROP_IRowsetResynch |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client expõe a interface IRowsetResynch sob demanda. O provedor OLE DB do SQL Server Native Client pode expor a interface em qualquer conjunto de linhas. |
DBPROP_ISupportErrorInfo |
Leitura/gravação: leitura/gravação Padrão: VARIANT_TRUE Descrição: o provedor OLE DB do SQL Server Native Client expõe a ISupportErrorInfo em conjuntos de linhas. |
DBPROP_ILockBytes |
Esta interface não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar a propriedade gera um erro. |
DBPROP_ISequentialStream |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client expõe a interface ISequentialStream para dar suporte a dados de comprimento variável e longo armazenados no SQL Server. |
DBPROP_IStorage |
Esta interface não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar a propriedade gera um erro. |
DBPROP_IStream |
Esta interface não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar a propriedade gera um erro. |
DBPROP_IMMOBILEROWS |
Leitura/gravação: leitura/gravação Padrão: VARIANT_TRUE Descrição: a propriedade só é VARIANT_TRUE para cursores de conjunto de chaves do SQL Server; é VARIANT_FALSE para todos os outros cursores. VARIANT_TRUE: o conjunto de linhas não reorganizará as linhas inseridas ou atualizadas. Para IRowsetChange::InsertRow, as linhas serão exibidas no fim do conjunto de linhas. Para IRowsetChange::SetData, se o conjunto de linhas não for ordenado, a posição das linhas atualizadas não será alterada. Se o conjunto de linhas for ordenado e IRowsetChange::SetData alterar uma coluna que é usada para ordenar o conjunto de linhas, a linha não será movida. Se o conjunto de linhas for criado em um conjunto de colunas-chave (geralmente, um conjunto de linhas para o qual DBPROP_OTHERUPDATEDELETE é VARIANT_TRUE, mas DBPROP_OTHERINSERT é VARIANT_FALSE), a alteração do valor de uma coluna-chave será geralmente equivalente à exclusão da linha atual e à inserção de uma nova linha. Portanto, a linha poderá parecer mover ou até mesmo desaparecer do conjunto de linhas, se DBPROP_OWNINSERT for VARIANT_FALSE, embora a propriedade DBPROP_IMMOBILEROWS seja VARIANT_TRUE. VARIANT_FALSE: se o conjunto de linhas for ordenado, as linhas inseridas serão exibidas na ordem correta do conjunto de linhas. Se o conjunto de linhas não for ordenado, a linha inserida aparecerá no final. Se IRowsetChange::SetData alterar uma coluna que é usada para ordenar o conjunto de linhas, a linha será movida. Se o conjunto de linhas não for ordenado, a posição da linha não será alterada. |
DBPROP_LITERALIDENTITY |
Leitura/gravação: somente leitura Padrão: VARIANT_TRUE Descrição: esta propriedade é sempre VARIANT_TRUE. |
DBPROP_LOCKMODE |
Leitura/gravação: leitura/gravação Padrão: DBPROPVAL_LM_NONE Descrição: nível de bloqueio executado pelo conjunto de linhas (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW). Observação
Ao usar o isolamento do instantâneo em uma transação, se um conjunto de linhas for aberto usando um conjunto de chaves ou um cursor de servidor dinâmico e o modo de bloqueio estiver definido como DBPROPVAL_LM_SINGLEROW, ocorrerá um erro durante a busca de uma linha se algum outro usuário tiver atualizado essa linha desde que a transação foi iniciada. Para outros tipos de cursor e modos de bloqueio, se algum outro usuário tiver atualizado a linha desde o início da transação, não ocorrerá um erro até o usuário tentar atualizar a linha. Em ambos os casos, esses erros são gerados pelo servidor.
|
DBPROP_MAXOPENROWS |
Leitura/gravação: somente leitura Padrão: 0 Descrição: o provedor OLE DB do SQL Server Native Client não limita o número de linhas que podem estar ativas em conjuntos de linhas. |
DBPROP_MAXPENDINGROWS |
Leitura/gravação: somente leitura Padrão: 0 Descrição: o provedor OLE DB do SQL Server Native Client não limita o número de linhas do conjunto de linhas com alterações pendentes. |
DBPROP_MAXROWS |
Leitura/gravação: leitura/gravação Padrão: 0 Descrição: por padrão, o provedor OLE DB do SQL Server Native Client não limita o número de linhas em um conjunto de linhas. Quando o consumidor define DBPROP_MAXROWS, o provedor OLE DB do SQL Server Native Client usa a instrução SET ROWCOUNT para limitar o número de linhas no conjunto de linhas. SET ROWCOUNT pode causar conseqüências não intencionais na execução de instrução do SQL Server. Para obter mais informações, consulte SET ROWCOUNT. |
DBPROP_MAYWRITECOLUMN |
Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
DBPROP_MEMORYUSAGE |
Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
DBPROP_NOTIFICATIONGRANULARITY |
Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
DBPROP_NOTIFICATIONPHASES |
Leitura/gravação: somente leitura Padrão: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT Descrição: o provedor OLE DB do SQL Server Native Client dá suporte a todas as fases de notificação. |
DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE |
Leitura/gravação: somente leitura Padrão: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO Descrição: as fases de notificação do provedor OLE DB do SQL Server Native Client podem ser canceladas antes de uma tentativa para executar a modificação de conjunto de linhas indicada. O provedor OLE DB do SQL Server Native Client não dá suporte ao cancelamento de fase após a conclusão da tentativa. |
DBPROP_ORDEREDBOOKMARKS |
Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: a definição de propriedades de visibilidade de alterações faz com que o provedor OLE DB do SQL Server Native Client use cursores do SQL Server para dar suporte ao conjunto de linhas. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server. |
DBPROP_QUICKRESTART |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: em caso de definição como VARIANT_TRUE, o provedor OLE DB do SQL Server Native Client tenta usar um cursor de servidor para o conjunto de linhas. |
DBPROP_REENTRANTEVENTS |
Leitura/gravação: somente leitura Padrão: VARIANT_TRUE Descrição: os conjuntos de linhas do provedor OLE DB do SQL Server Native Client são reentrantes e poderão retornar DB_E_NOTREENTRANT se um consumidor tentar acessar um método de conjunto de linhas não-reentrante de um retorno de chamada de notificação. |
DBPROP_REMOVEDELETED |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client altera o valor da propriedade com base na visibilidade de alterações feitas nos dados do SQL Server expostos pelo conjunto de linhas. VARIANT_TRUE: as linhas excluídas pelo consumidor ou outros usuários do SQL Server são removidos do conjunto de linhas quando o conjunto de linhas é atualizado. DBPROP_OTHERINSERT é VARIANT_TRUE. VARIANT_ FALSE: as linhas excluídas pelo consumidor ou outros usuários do SQL Server não são removidos do conjunto de linhas quando o conjunto de linhas é atualizado. O valor de status de linha para linhas excluídas do SQL Server no conjunto de linhas é DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT é VARIANT_TRUE. Esta propriedade só tem valor para conjuntos de linhas com suporte de cursores do SQL Server. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server. Quando a propriedade DBPROP_REMOVEDELETED é implementada em um conjunto de linhas de cursor do conjunto de chaves, as linhas excluídas são removidas no momento da busca e é possível para os métodos de busca de linhas, como GetNextRows e GetRowsAt, retornar S_OK e menos linhas do que solicitado. Observe que este comportamento não significa que a condição DB_S_ENDOFROWSET e que o número de linhas retornadas nunca serão zero se houver alguma linha restante. |
DBPROP_REPORTMULTIPLECHANGES |
Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
DBPROP_RETURNPENDINGINSERTS |
Leitura/gravação: somente leitura Padrão: VARIANT_FALSE Descrição: quando um método que busca linhas é chamado, o provedor OLE DB do SQL Server Native Client não retorna linhas de inserção pendentes. |
DBPROP_ROWRESTRICT |
Leitura/gravação: somente leitura Padrão: VARIANT_TRUE Descrição: os conjuntos de linhas do provedor OLE DB do SQL Server Native Client não dão suporte para direitos de acesso baseados na linha. Se a interface IRowsetChange for exposta em um conjunto de linhas, o método SetData poderá ser chamado pelo consumidor. |
DBPROP_ROWSET_ASYNCH |
Leitura/gravação: leitura/gravação Padrão: 0 Descrição: fornece processamento de conjunto de linhas assíncrono. Esta propriedade está no grupo de propriedades Conjunto de linhas e no conjunto de propriedades DBPROPSET_ROWSET. Tipo é VT_14. O único valor na máscara de bits suportado pelo SQL Server Native Client é DBPROPVAL_ASYNCH_INITIALIZE. |
DBPROP_ROWTHREADMODEL |
Leitura/gravação: somente leitura Padrão: DBPROPVAL_RT_FREETHREAD Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para o acesso a seus objetos de vários threads de execução de um único consumidor. |
DBPROP_SERVERCURSOR |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: em caso de uma definição, um cursor do SQL Server é usado para dar suporte ao conjunto de linhas. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server. |
DBPROP_SERVERDATAONINSERT |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: dados de servidor na inserção. VARIANT_TRUE: no momento em que uma inserção é transmitida ao servidor, o provedor recupera dados do servidor para atualizar o cache de linha local. VARIANT_FALSE: o provedor não recupera valores de servidor para linhas recentemente inseridas. |
DBPROP_STRONGIDENTITY |
Leitura/gravação: somente leitura Padrão: VARIANT_TRUE Descrição: identidade de linha forte. Se forem permitidas inserções em um conjunto de linhas (IRowsetChange ou IRowsetUpdate será true), e DBPROP_UPDATABILITY for definida para dar suporte a InsertRows, o valor de DBPROP_STRONGIDENTITY dependerá da propriedade DBPROP_CHANGEINSERTEDROWS (será VARIANT_FALSE se o valor da propriedade DBPROP_CHANGEINSERTEDROWS for VARIANT_FALSE). |
DBPROP_TRANSACTEDOBJECT |
Leitura/gravação: somente leitura Padrão: VARIANT_FALSE Descrição: o provedor OLE DB do SQL Server Native Client dá suporte apenas para objetos transacionados. Para obter mais informações, consulte Transações. |
DBPROP_UNIQUEROWS |
Leitura/gravação: leitura/gravação Padrão: VARIANT_FALSE Descrição: linhas exclusivas. VARIANT_TRUE: cada linha é identificada exclusivamente por seus valores de coluna. O conjunto de colunas que identificam exclusivamente a linha tem a propriedade DBCOLUMNFLAGS_KEYCOLUMN definida na estrutura DBCOLUMNINFO retornada do método GetColumnInfo. VARIANT_FALSE: as linhas podem ou não ser identificadas exclusivamente por seus valores de coluna. As colunas de chave podem ou não ser sinalizadas com DBCOLUMNFLAGS_KEYCOLUMN. |
DBPROP_UPDATABILITY |
Leitura/gravação: leitura/gravação Padrão: 0 Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para todos os valores de DBPROP_UPDATABILITY. A definição de DBPROP_UPDATABILITY não cria um conjunto de linhas modificável. Para tornar um conjunto de linhas modificável, defina DBPROP_IRowsetChange ou DBPROP_IRowsetUpdate. |
O provedor OLE DB do SQL Server Native Client define o conjunto de propriedades específico do provedor, DBPROPSET_SQLSERVERROWSET, como mostrado nesta tabela.
ID da propriedade |
Descrição |
|---|---|
SSPROP_COLUMN_ID |
Coluna: ColumnID Leitura/gravação: somente leitura Tipo: VT_U12 | VT_ARRAY Padrão: VT_EMPTY Descrição: uma matriz de valores de número inteiro que representam a posição ordinal (de base 1) de uma coluna de resultados da cláusula COMPUTE dentro da instrução Transact-SQL SELECT atual. Este é o provedor OLE DB do SQL Server Native Client equivalente do atributo SQL_CA_SS_COLUMN_ID do ODBC. |
SSPROP_COMPUTE_BYLIST |
Coluna: ComputeByList Leitura/gravação: somente leitura Tipo: VT_BOOL Padrão: VARIANT_FALSE Descrição: um valor booleano que indica que a coluna faz parte do conjunto de resultados COMPUTE BY. Este é o provedor OLE DB do SQL Server Native Client equivalente do atributo SQL_CA_SS_COMPUTE_BYLIST do ODBC. Observação
A propriedade OLE DB é um valor booleano, mas o atributo do ODBC é realmente uma lista de valores resumidos não assinados com todos os ordinais de coluna fazendo parte de uma cláusula BY.
VARIANT_TRUE: a coluna se origina em uma instrução COMPUTE BY. VARIANT_FALSE: a coluna é uma coluna normal; não se origina na instrução COMPUTE BY. |
SSPROP_COMPUTE_ID |
Coluna: ComputeID Leitura/gravação: somente leitura Tipo: VT_U12 Padrão: 0 Descrição: a ID de cálculo de uma linha que é o resultado de uma cláusula COMPUTE na instrução Transact-SQL SELECT atual. Este é o provedor OLE DB do SQL Server Native Client equivalente do atributo SQL_CA_SS_COMPUTE_ID do ODBC. |
SSPROP_DEFERPREPARE |
Coluna: Não Leitura/gravação: leitura/gravação Tipo: VT_BOOL Padrão: VARIANT_TRUE Descrição: VARIANT_TRUE: na execução preparada, a preparação de comando é adiada até que ICommand::Execute é chamada ou uma operação de metapropriedade é executada. Se a propriedade for definida como VARIANT_FALSE: a instrução está preparada quando ICommandPrepare::Prepare é executada. |
SSPROP_IRowsetFastLoad |
Coluna: Não Leitura/gravação: leitura/gravação Tipo: VT_BOOL Padrão: VARIANT_FALSE Descrição: defina esta propriedade como VARIANT_TRUE para abrir um conjunto de linhas de carga rápida por IOpenRowset::OpenRowset. Você não pode definir essa propriedade em ICommandProperties::SetProperties. |
SSPROP_ISSAsynchStatus |
Coluna: Não Leitura/gravação: leitura/gravação Tipo: VT_BOOL Padrão: VARIANT_FALSE Descrição: defina esta propriedade como VARIANT_TRUE para habilitar operações assíncronas que usam a interface ISSAsynchStatus. |
SSPROP_MAXBLOBLENGTH |
Coluna: Não Leitura/gravação: leitura/gravação Tipo: VT_I4 Padrão: o provedor não restringe o tamanho do texto retornado pelo servidor e o valor da propriedade é definido como seu máximo. Por exemplo, 2147483647. Descrição: o provedor OLE DB do SQL Server Native Client executa uma instrução SET TEXTSIZE para restringir o comprimento dos dados BLOB (Objeto Binário Grande) retornados em uma instrução SELECT. |
SSPROP_NOCOUNT_STATUS |
Coluna: NoCount Leitura/gravação: somente leitura Tipo: VT_BOOL Padrão: VARIANT_FALSE Descrição: um valor booleano que representa o status de SET NOCOUNT ON/OFF no SQL Server: VARIANT_TRUE: quando SET NOCOUNT ON VARIANT_FALSE: quando SET NOCOUNT OFF |
SSPROP_QP_NOTIFICATION_MSGTEXT |
Coluna: Não Leitura/gravação: leitura/gravação Tipo: VT_BSTR (1 a 2.000 caracteres permitidos) Padrão: cadeia de caracteres vazia Descrição: o texto de mensagem da notificação de consulta. Esta propriedade é definida pelo usuário e não tem nenhum formato definido. |
SSPROP_QP_NOTIFICATION_OPTIONS |
Coluna: Não Leitura/gravação: leitura/gravação Tipo: VT_BSTR Padrão: cadeia de caracteres vazia Descrição: as opções de notificação de consulta. Essas opções são especificadas em uma cadeia de caracteres com name=value. O usuário é responsável por criar o serviço e ler as notificações da fila. A sintaxe da cadeia de caracteres das opções de notificação de consulta é a seguinte: service=<service-name>[;(local database=<database>|broker instance=<broker instance>)] Por exemplo: service=mySSBService;local database=mydb |
SSPROP_QP_NOTIFICATION_TIMEOUT |
Coluna: Não Leitura/gravação: leitura/gravação Tipo: VT_UI4 Padrão: 432.000 segundos (5 dias) Mínimo: 1 segundo Máximo: 2^31-1 segundos Descrição: o número de segundos que a notificação de consulta permanece ativa. |
Histórico de alterações
Conteúdo atualizado |
|---|
A descrição de DBPROP_ROWSET_ASYNCH foi atualizada. |