Condividi tramite


Proprietà Rowset (OLE DB)

Il set di proprietà DBPROPSET_ROWSET contiene le proprietà descritte di seguito. Tutte queste proprietà fanno parte del gruppo di proprietà Rowset. Altre proprietà sono definite in DBPROPSET_SSCE_ROWSET.

ID proprietà

Descrizione

DBPROP_ABORTPRESERVE

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: sola lettura

  • Descrizione: Mantieni in caso di interruzione

  • Note: per questo provider, il valore è sempre VARIANT_FALSE. Indica che, dopo l'interruzione di una transazione, le sole operazioni consentite in un set di righe sono il rilascio degli handle di riga e di accesso e il rilascio del set di righe.

DBPROP_ACCESSORDER

  • Tipo: VT_I4

  • Lettura/scrittura: sola lettura

  • Descrizione: Ordine di accesso

  • Note: per questo provider, il valore è sempre DBPROPVAL_AO_RANDOM.

DBPROP_BLOCKINGSTORAGEOBJECTS

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: sola lettura

  • Descrizione: Blocco degli oggetti di archiviazione

  • Note: per questo provider, il valore è sempre VARIANT_TRUE.

DBPROP_BOOKMARKS

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura/scrittura

  • Descrizione: Utilizza segnalibri

  • Note: consente di specificare se il set di righe supporta i segnalibri. Il provider supporta i valori seguenti:

    • VARIANT_TRUE indica che il set di righe supporta i segnalibri. La colonna 0 è il segnalibro per le righe. L'utilizzo di questa colonna consente di ottenere un valore per il segnalibro, che può essere utilizzato per riposizionarsi sulla riga.

    • VARIANT_FALSE indica che il set di righe non supporta i segnalibri. Il set di righe è sequenziale e i valori delle proprietà DBPROP_LITERALBOOKMARKS e DBPROP_ORDEREDBOOKMARKS vengono ignorati.

DBPROP_BOOKMARKTYPE

  • Tipo: VT_UI4

  • Comportamento tipico lettura/scrittura: sola lettura

  • Descrizione: Tipo di segnalibro

  • Note: consente di specificare il tipo di segnalibro supportato dal set di righe. Per questo provider, il valore è sempre DBPROPVAL_BMK_NUMERIC. Indica che il segnalibro è di tipo numerico. I segnalibri numerici si basano sulle proprietà di una riga e non dipendono dai valori delle colonne della riga. Un segnalibro numerico, ad esempio, può essere basato sulla posizione assoluta della riga all'interno del set di righe o su un ID di riga assegnato dal motore di archiviazione al momento della creazione. Se si modificano le colonne della riga, la validità dei segnalibri numerici rimane inalterata.

    I segnalibri sono di tipo DBTYPE_UI4, mentre nelle versioni precedenti di SQL Server Compact sono di tipo DBTYPE_I4.

DBPROP_CANFETCHBACKWARDS

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura/scrittura

  • Descrizione: Cerca indietro

  • Note: consente di specificare se il set di righe è in grado di eseguire operazioni di recupero all'indietro. Il provider supporta i valori seguenti:

    • VARIANT_TRUE indica che cRows in IRowset::GetNextRows può essere negativo. Se negativo, questo metodo esegue un'operazione di recupero all'indietro delle righe a partire dalla riga specificata.

    • VARIANT_FALSE indica che cRows deve essere non negativo.

DBPROP_CANHOLDROWS

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura

  • Descrizione: Mantieni righe

  • Note: per questo provider, la proprietà è sempre VARIANT_FALSE.

DBPROP_CANSCROLLBACKWARDS

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura

  • Descrizione: Scorri indietro

  • Note: per questo provider, la proprietà è sempre VARIANT_FALSE. Indica che IRowsOffset deve essere non negativo.

DBPROP_CHANGEINSERTEDROWS

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura

  • Descrizione: Modifica righe inserite

  • Note: per questo provider, il valore è sempre VARIANT_TRUE. Indica che il consumer è in grado di chiamare IRowsetChange::DeleteRows o IRowsetChange::SetData per le righe appena inserite. Una riga appena inserita è una riga per cui l'inserimento è stato trasmesso all'archivio dati, a differenza di una riga inserita in sospeso.

DBPROP_COMMITPRESERVE

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: sola lettura

  • Descrizione: Mantieni in caso di commit

  • Note: per questo provider, il valore è sempre VARIANT_TRUE. Indica che dopo un commit che mantiene l'oggetto contenente i dati, il set di righe rimane attivo, ovvero è possibile recuperare nuove righe, aggiornare, eliminare e inserire righe e così via.

DBPROP_DEFERRED

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: sola lettura

  • Descrizione: Rinvia colonna

  • Note: per questo provider, il valore è sempre VARIANT_TRUE. Indica che i dati della colonna non vengono recuperati finché non si utilizza una funzione di accesso sulla colonna.

DBPROP_DELAYSTORAGEOBJECTS

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: sola lettura

  • Descrizione: Ritarda aggiornamenti degli oggetti di archiviazione

  • Note: per questo provider, il valore è sempre VARIANT_TRUE. Indica che gli oggetti di archiviazione vengono inoltre utilizzati in modalità di aggiornamento differito.

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

  • Comportamento tipico lettura/scrittura: lettura/scrittura, a eccezione di quanto specificato di seguito.

  • Note: se il valore di una di queste proprietà è impostato su VARIANT_TRUE, il set di righe supporta l'interfaccia specificata. Queste proprietà vengono utilizzate principalmente per richiedere le interfacce attraverso ICommandProperties::SetProperties. Le proprietà seguenti sono di sola lettura e sono sempre VARIANT_TRUE:

    • DBPROP_IAccessor

    • DBPROP_IColumnsInfo

    • BPROP_IConvertType

    • DBPROP_IRowset

    • DBPROP_IRowsetInfo

    • DBPROP_ISupportErrorInfo

    Se si imposta DBPROP_IRowsetUpdate su VARIANT_TRUE, DBPROP_IRowsetChange viene automaticamente impostato su VARIANT_TRUE. Se si imposta DBPROP_IRowsetCurrentIndex su VARIANT_TRUE, DBPROP_IRowsetIndex viene automaticamente impostato su VARIANT_TRUE.

DBPROP_ILockBytes

DBPROP_ISequentialStream

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura/scrittura

  • Note: se il valore di questa proprietà è impostato su VARIANT_TRUE, la colonna specificata viene considerata come oggetto di archiviazione che indica l'interfaccia specificata.

DBPROP_IMMOBILEROWS

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: sola lettura

  • Descrizione: Righe immobili

  • Note: per questo provider, il valore è sempre VARIANT_FALSE. Indica che, se il set di righe viene ordinato, le righe inserite e quelle aggiornate seguono i criteri di ordinamento del set di righe, quando vengono aggiornate una o più colonne nei criteri di ordinamento. Se il set di righe non viene ordinato, le righe inserite vengono visualizzate in ordine casuale e la posizione delle righe aggiornate non viene modificata. Questa proprietà è significativa solo se DBPROP_OWNINSERT è VARIANT_TRUE.

DBPROP_LOCKMODE

  • Tipo: VT_I4

  • Lettura/scrittura: lettura

  • Descrizione: Modalità di blocco

  • Note: per questo provider, il valore è sempre DBPROPVAL_LM_SINGLEROW.

DBPROP_MAXOPENROWS

  • Tipo: VT_I4

  • Comportamento tipico lettura/scrittura: lettura

  • Descrizione: Numero massimo righe aperte

  • Note: questo valore è 1 per SQL Server Compact.

DBPROP_MAXROWS

  • Tipo: VT_I4

  • Comportamento tipico lettura/scrittura: sola lettura

  • Descrizione: Numero massimo righe

  • Note: consente di specificare il numero massimo di righe che possono essere restituite in un set di righe. Se il valore è 0, non sussistono limiti. Per questo provider, il valore è sempre 0.

DBPROP_OTHERINSERT

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura/scrittura

  • Descrizione: Inserimenti di altri utenti visibili

  • Note: le tabelle di base sono True, le altre sono False.

DBPROP_OTHERUPDATEDELETE

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura/scrittura

  • Descrizione: Modifiche di altri utenti visibili

  • Note: consente di specificare uno dei valori seguenti:

    • VARIANT_TRUE indica che gli aggiornamenti e le eliminazioni eseguiti da un utente che non sia un consumer del set di righe possono essere visualizzati dal set di righe. Si supponga, ad esempio, che un utente che non sia un consumer del set di righe aggiorni i dati sottostanti una riga o elimini la riga. Se la riga viene rilasciata interamente, qualsiasi consumer del set di righe visualizzerà tale modifica durante il successivo recupero della riga. Sono inclusi gli aggiornamenti e le eliminazioni eseguiti da altre parti nella stessa transazione e gli aggiornamenti e le eliminazioni eseguiti da parti all'esterno della transazione. Il livello di isolamento della transazione non impedisce al set di righe di visualizzare gli aggiornamenti e le eliminazioni eseguiti da altre parti nella stessa transazione, ad esempio altri set di righe nella stessa sessione, ma limita la possibilità del set di righe di visualizzare gli aggiornamenti e le eliminazioni eseguiti da parti all'esterno della transazione.

    • VARIANT_FALSE indica che gli aggiornamenti e le eliminazioni eseguiti da altri non possono essere visualizzati dal set di righe.

DBPROP_OWNINSERT

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura/scrittura

  • Descrizione: Inserimenti locali visibili

DBPROP_OWNUPDATEDELETE

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura/scrittura

  • Descrizione: Modifiche locali visibili

DBPROP_QUICKRESTART

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura/scrittura

  • Descrizione: Riavvio rapido

DBPROP_REMOVEDELETED

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: lettura

  • Descrizione: Rimuovi righe eliminate

  • Note: per questo provider, il valore è sempre VARIANT_TRUE.

DBPROP_REPORTMULTIPLECHANGES

  • Tipo: VT_BOOL

  • Comportamento tipico lettura/scrittura: sola lettura

  • Descrizione: Riporta più modifiche

  • Note: per questo provider, il valore è sempre VARIANT_TRUE.

DBPROP_ROWTHREADMODEL

  • Tipo: VT_I4

  • Comportamento tipico lettura/scrittura: sola lettura

  • Descrizione: Modello di threading riga. Consente di specificare il modello di threading dei set di righe generati dal comando. Note: per questo provider, il valore è sempre VARIANT_TRUE.

DBPROP_SERVERDATAONINSERT

  • Tipo: VT_BOOL

  • Lettura/scrittura: lettura

  • Descrizione: Dati server all'inserimento

  • Note: per questo provider, il valore è sempre VARIANT_TRUE.

DBPROP_UPDATABILITY

  • Tipo: VT_I4

  • Comportamento tipico lettura/scrittura: lettura/scrittura

  • Descrizione: Aggiornabilità