Partilhar via


Propriedades de conjunto de linhas (OLE DB)

A propriedade DBPROPSET_ROWSET contém as propriedades a seguir. Todas estas propriedades estão no grupo de propriedades Rowset. Propriedades adicionais são definidas em DBPROPSET_SSCE_ROWSET.

ID da propriedade

Descrição

DBPROP_ABORTPRESERVE

  • Tipo: VT_BOOL

  • Leitura/gravação típica: somente leitura

  • Descrição: preservar na anulação

  • Observações: para este provedor, o valor é sempre VARIANT_FALSE. Isso indica que, após a anulação de uma transação, as únicas operações permitidas em um conjunto de linhas são: liberar identificadores de linha e acessador e liberar o conjunto de linhas.

DBPROP_ACCESSORDER

  • Tipo: VT_I4

  • Leitura/gravação: somente leitura

  • Descrição: ordem de acesso

  • Observações: para este provedor, o valor é sempre DBPROPVAL_AO_RANDOM.

DBPROP_BLOCKINGSTORAGEOBJECTS

  • Tipo: VT_BOOL

  • Leitura/gravação típica: somente leitura

  • Descrição: objetos de armazenamento de bloqueio

  • Observações: para este provedor, o valor é sempre VARIANT_TRUE.

DBPROP_BOOKMARKS

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura/gravação

  • Descrição: usar indicadores

  • Observações: especifica se o conjunto de linhas dá suporte a indicadores. O provedor aceita os seguintes valores:

    • VARIANT_TRUE, que indica que o conjunto de linhas dá suporte a indicadores. A coluna 0 serve de indicador para as linhas. Nessa coluna, é obtido um valor indicador. Isso pode ser usado para reposicionar a linha.

    • VARIANT_FALSE, que indica que o conjunto de linhas não dá suporte a indicadores. O conjunto de linhas é seqüencial, e os valores das propriedades DBPROP_LITERALBOOKMARKS e DBPROP_ORDEREDBOOKMARKS são ignorados.

DBPROP_BOOKMARKTYPE

  • Tipo: VT_UI4

  • Leitura/gravação típica: somente leitura

  • Descrição: tipo de indicador

  • Observações: especifica o tipo de indicador aceito pelo conjunto de linhas. Para este provedor, o valor é sempre DBPROPVAL_BMK_NUMERIC. Isso indica que o tipo de indicador é numérico. Os indicadores numéricos se baseiam nas propriedades de uma linha e não dependem dos valores das colunas da linha. Por exemplo, um indicador numérico pode se basear na posição absoluta da linha dentro do conjunto de linhas, ou na ID que o mecanismo de armazenamento atribuiu a uma linha quando ela foi criada. A modificação de colunas da linha não altera a validade de indicadores numéricos.

    Os indicadores são do tipo DBTYPE_UI4. Em versões anteriores ao SQL Server Compact 3.5, os indicadores eram do tipo DBTYPE_I4

DBPROP_CANFETCHBACKWARDS

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura/gravação

  • Descrição: buscar no sentido inverso

  • Observações: especifica se o conjunto de linhas pode efetuar buscas no sentido inverso. O provedor aceita os seguintes valores:

    • VARIANT_TRUE, que indica que cRows em IRowset::GetNextRows pode ser negativo. Quando é negativo, esse método busca linhas no sentido inverso a partir da linha especificada.

    • VARIANT_FALSE, que indica que cRows não pode ser negativo.

DBPROP_CANHOLDROWS

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura

  • Descrição: manter linhas

  • Observações: para este provedor, essa propriedade é sempre VARIANT_FALSE.

DBPROP_CANSCROLLBACKWARDS

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura

  • Descrição: rolar no sentido inverso

  • Observações: para este provedor, essa propriedade é sempre VARIANT_FALSE. Isso indica que IRowsOffset não deve ser negativo.

DBPROP_CHANGEINSERTEDROWS

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura

  • Descrição: alterar linhas inseridas

  • Observações: para este provedor, o valor é sempre VARIANT_TRUE. Isso indica que o consumidor poderá chamar IRowsetChange::DeleteRows ou IRowsetChange::SetData para linhas recém-inseridas. Uma linha recém-inserida é definida como uma linha para a qual a inserção foi transmitida ao armazenamento de dados, em vez de uma linha de inserção pendente.

DBPROP_COMMITPRESERVE

  • Tipo: VT_BOOL

  • Leitura/gravação típica: somente leitura

  • Descrição: preservar na confirmação

  • Observações: para este provedor, o valor é sempre VARIANT_TRUE. Isso indica que, após uma confirmação que preserva, o conjunto de linhas permanece ativo. Ou seja, você pode buscar novas linhas, atualizar, excluir e inserir linhas e assim por diante.

DBPROP_DEFERRED

  • Tipo: VT_BOOL

  • Leitura/gravação típica: somente leitura

  • Descrição: adiar coluna

  • Observações: para este provedor, o valor é sempre VARIANT_TRUE. Isso indica que os dados da coluna não são buscados até o acessador ser usado na coluna.

DBPROP_DELAYSTORAGEOBJECTS

  • Tipo: VT_BOOL

  • Leitura/gravação típica: somente leitura

  • Descrição: atrasar atualizações de objetos de armazenamento

  • Observações: para este provedor, o valor é sempre VARIANT_TRUE. Isso indica que também são usados objetos de armazenamento no modo de atualização atrasada.

DBPROP_IAccessor

DBPROP_IColumnsInfo

DBPROP_IConvertType

DBPROP_IRowset

DBPROP_IRowsetChange

DBPROP_IRowsetInfo

DBPROP_IRowsetUpdate

DBPROP_ISupportErrorInfo

DBPROP_IRowsetIndex

DBPROP_IRowsetCurrentIndex

DBPROP_IRowsetBookmark

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura/gravação, exceto conforme descrito abaixo.

  • Observações: se o valor de qualquer uma destas propriedades for definido como VARIANT_TRUE, o conjunto de linhas dará suporte à interface especificada. Estas propriedades são usadas principalmente para solicitar interfaces através de ICommandProperties::SetProperties. As seguintes propriedades são somente leitura e sempre VARIANT_TRUE:

    • DBPROP_IAccessor

    • DBPROP_IColumnsInfo

    • BPROP_IConvertType

    • DBPROP_IRowset

    • DBPROP_IRowsetInfo

    • DBPROP_ISupportErrorInfo

    A definição de DBPROP_IRowsetUpdate como VARIANT_TRUE define automaticamente DBPROP_IRowsetChange como VARIANT_TRUE. A definição de DBPROP_IRowsetCurrentIndex como VARIANT_TRUE define automaticamente DBPROP_IRowsetIndex como VARIANT_TRUE.

DBPROP_ILockBytes

DBPROP_ISequentialStream

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura/gravação

  • Observações: se o valor dessa propriedade for definido como VARIANT_TRUE, a coluna especificada será tratada como um objeto de armazenamento que revela a interface determinada.

DBPROP_IMMOBILEROWS

  • Tipo: VT_BOOL

  • Leitura/gravação típica: somente leitura

  • Descrição: linhas imóveis

  • Observações: para este provedor, o valor é sempre VARIANT_FALSE. Isso indica que, se o conjunto de linhas for ordenado, as linhas inseridas e as linhas atualizadas (onde uma ou mais das colunas dos critérios de ordenação são atualizadas) seguirão os critérios de ordenação do conjunto de linhas. Se o conjunto de linhas não for ordenado, não será garantido que as linhas inseridas apareçam em uma determinada posição, e a posição das linhas atualizadas não será alterada. Essa propriedade será significativa somente se DBPROP_OWNINSERT estiver definida como VARIANT_TRUE.

DBPROP_LOCKMODE

  • Tipo: VT_I4

  • Leitura/gravação: leitura

  • Descrição: modo de bloqueio

  • Observações: para este provedor, o valor é sempre DBPROPVAL_LM_SINGLEROW.

DBPROP_MAXOPENROWS

  • Tipo: VT_I4

  • Leitura/gravação típica: leitura

  • Descrição: máximo de linhas abertas

  • Observações: esse valor é sempre 1 para o SQL Server Compact 3.5.

DBPROP_MAXROWS

  • Tipo: VT_I4

  • Leitura/gravação típica: somente leitura

  • Descrição: máximo de linhas

  • Observações: especifica o número máximo de linhas que podem ser retornadas em um conjunto de registros. Se não houver nenhum limite, o valor será NULL. Para este provedor, o valor é sempre 0.

DBPROP_OTHERINSERT

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura/gravação

  • Descrição: inserção de outro

  • Observações: as tabelas base são True; outras são False.

DBPROP_OTHERUPDATEDELETE

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura/gravação

  • Descrição: alterações dos outros visíveis

  • Observações: especifica um dos seguintes valores:

    • VARIANT_TRUE, que indica que o conjunto de linhas pode ver atualizações e exclusões feitas por um usuário que não seja um consumidor do conjunto de linhas. Por exemplo, vamos supor que um usuário que não seja um consumidor do conjunto de linhas atualize os dados subjacentes a uma linha ou exclua a linha. Se a linha estiver totalmente liberada, qualquer consumidor do conjunto de linhas verá essa alteração na próxima vez que a buscar. Isso inclui as atualizações e exclusões feitas por outras partes na mesma transação e as atualizações e exclusões feitas por partes externas à transação. O nível de isolamento da transação não afeta a capacidade do conjunto de linhas de ver atualizações e exclusões feitas por outras partes na mesma transação, como outros conjuntos de linhas na mesma sessão. Entretanto, ele restringe a capacidade do conjunto de linhas de ver atualizações e exclusões feitas por partes externas à transação.

    • VARIANT_FALSE, que indica que o conjunto de linhas não pode ver atualizações e exclusões feitas pelos outros.

DBPROP_OWNINSERT

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura/gravação

  • Descrição: as próprias inserções visíveis

DBPROP_OWNUPDATEDELETE

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura/gravação

  • Descrição: as próprias alterações visíveis

DBPROP_QUICKRESTART

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura/gravação

  • Descrição: reinício rápido

DBPROP_REMOVEDELETED

  • Tipo: VT_BOOL

  • Leitura/gravação típica: leitura

  • Descrição: remover linhas excluídas

  • Observações: para este provedor, o valor é sempre VARIANT_TRUE.

DBPROP_REPORTMULTIPLECHANGES

  • Tipo: VT_BOOL

  • Leitura/gravação típica: somente leitura

  • Descrição: relatar várias alterações

  • Observações: para este provedor, o valor é sempre VARIANT_TRUE.

DBPROP_ROWTHREADMODEL

  • Tipo: VT_I4

  • Leitura/gravação típica: somente leitura

  • Descrição: o modelo de threading de linhas especifica o modelo de threading dos conjuntos de linhas gerados pelo comando. Para este provedor, o valor é sempre DBPROPVAL_RT_SINGLETHREAD.

DBPROP_SERVERDATAONINSERT

  • Tipo: VT_BOOL

  • Leitura/gravação: leitura

  • Descrição: dados do servidor na inserção

  • Observações: para este provedor, o valor é sempre VARIANT_TRUE.

DBPROP_UPDATABILITY

  • Tipo: VT_I4

  • Leitura/gravação típica: leitura/gravação

  • Descrição: capacidade de atualização