Condividi tramite


Proprietà e comportamenti dei set di righe

Si applica a: SQL Server Azure SQL DatabaseIstanza gestita di SQL di Azure Azure SynapseAnalytics AnalyticsPlatform System (PDW)

Scaricare il driver OLE DB

Di seguito sono elencate le proprietà dei set di righe in OLE DB Driver per SQL Server:

ID proprietà Descrizione
DBPROP_ABORTPRESERVE R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: il comportamento di un set di righe dopo un'operazione di interruzione è determinato da questa proprietà.

VARIANT_FALSE: OLE DB Driver per SQL Server invalida i set di righe dopo un'operazione di interruzione. Le funzionalità dell'oggetto set di righe andranno perdute quasi del tutto. Supporta solo operazioni IUnknown e il rilascio di handle di riga e di funzione di accesso in attesa.

VARIANT_TRUE: OLE DB Driver per SQL Server gestisce un set di righe valido.
DBPROP_ACCESSORDER R/W (L/S): Lettura/Scrittura

Predefinito: DBPROPVAL_AO_RANDOM

Descrizione: ordine di accesso. Ordine in cui è necessario accedere alle colonne nel set di righe.

DBPROPVAL_AO_RANDOM: è possibile accedere alla colonna in qualsiasi ordine.

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: è possibile accedere a colonne associate come oggetti di archiviazione solo in ordine sequenziale, determinato dall'ordinale di colonna.

DBPROPVAL_AO_SEQUENTIAL: è necessario accedere a tutte le colonne in ordine sequenziale, determinato dall'ordinale di colonna.
DBPROP_APPENDONLY Questa proprietà del set di righe non viene implementata da OLE DB Driver per SQL Server. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_BLOCKINGSTORAGEOBJECTS R/W (L/S): Sola lettura

Predefinito: VARIANT_TRUE

Descrizione: gli oggetti di archiviazione in OLE DB Driver per SQL Server vengono bloccati usando altri metodi del set di righe.
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server supporta i segnalibri per l'identificazione delle righe nel set di righe quando DBPROP_BOOKMARKS o DBPROP_LITERALBOOKMARKS è VARIANT_TRUE.

L'impostazione di una delle proprietà su VARIANT_TRUE non consente il posizionamento del set di righe in base al segnalibro. Impostare DBPROP_IRowsetLocate o DBPROP_IRowsetScroll su VARIANT_TRUE per creare un set di righe che supporta il posizionamento dei set di righe in base al segnalibro.

OLE DB Driver per SQL Server usa un cursore Microsoft SQL Server per supportare un set di righe contenente segnalibri. Per altre informazioni, vedere Set di righe e cursori SQL Server.

Nota: L'impostazione di queste proprietà in conflitto con altre proprietà di definizione del cursore per il driver OLE DB per SQL Server causa un errore. Impostando, ad esempio, DBPROP_BOOKMARKS su VARIANT_TRUE quando anche DBPROP_OTHERINSERT è VARIANT_TRUE, viene generato un errore durante il tentativo di apertura di un set di righe da parte di un consumer.
DBPROP_BOOKMARKSKIPPED R/W (L/S): Sola lettura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server restituisce DB_E_BADBOOKMARK se il consumer indica un segnalibro non valido quando si posiziona o si cerca un set di righe con segnalibro.
DBPROP_BOOKMARKTYPE R/W (L/S): Sola lettura

Predefinito: DBPROPVAL_BMK_NUMERIC

Descrizione: OLE DB Driver per SQL Server implementa solo i segnalibri numerici. Un segnalibro di OLE DB Driver per SQL Server è un intero senza segno a 32 bit di tipo DBTYPE_UI4.
DBPROP_CACHEDEFERRED Questa proprietà del set di righe non viene implementata da OLE DB Driver per SQL Server. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server supporta il recupero e lo scorrimento a ritroso in set di righe non sequenziali. Il driver OLE DB per SQL Server crea un set di righe supportato dal cursore quando DBPROP_CANFETCHBACKWARDS o DBPROP_CANSCROLLBACKWARDS è VARIANT_TRUE. Per altre informazioni, vedere Set di righe e cursori SQL Server.
DBPROP_CANHOLDROWS R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: Per impostazione predefinita, OLE DB Driver per SQL Server restituisce DB_E_ROWSNOTRELEASED se il consumer tenta di ottenere più righe per un set di righe mentre sono presenti modifiche in sospeso sulle righe nel set di righe. È possibile modificare questo comportamento.

L'impostazione di DBPROP_CANHOLDROWS e DBPROP_IRowsetChange su VARIANT_TRUE produce un set di righe con segnalibro. Se entrambe le proprietà sono VARIANT_TRUE, l'interfaccia IRowsetLocate è disponibile nel set di righe e DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS sono entrambe VARIANT_TRUE.

I set di righe di OLE DB Driver per SQL Server che contengono segnalibri sono supportati dai cursori SQL Server.
DBPROP_CHANGEINSERTEDROWS R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: questa proprietà può essere impostata solo su VARIANT_TRUE se il set di righe usa un cursore gestito da keyset.
DBPROP_COLUMNRESTRICT R/W (L/S): Sola lettura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server imposta la proprietà su VARIANT_TRUE quando una colonna in un set di righe non può essere modificata dal consumer. È possibile che le altre colonne nel set di righe siano aggiornabili e le righe stesse possano essere eliminate.

Quando la proprietà è VARIANT_TRUE, il consumer esamina il membro dwFlags della struttura DBCOLUMNINFO per determinare se è possibile o meno scrivere il valore di una singola colonna. Per le colonne modificabili, dwFlags indica DBCOLUMNFLAGS_WRITE.
DBPROP_COMMANDTIMEOUT R/W (L/S): Lettura/Scrittura

Predefinito: 0

Descrizione: Per impostazione predefinita, OLE DB Driver per SQL Server non raggiunge il timeout nel metodo ICommand::Execute.
DBPROP_COMMITPRESERVE R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: il comportamento di un set di righe dopo un'operazione di commit è determinato da questa proprietà.

VARIANT_TRUE: OLE DB Driver per SQL Server gestisce un set di righe valido.

VARIANT_FALSE: OLE DB Driver per SQL Server invalida i set di righe dopo un'operazione di commit. Le funzionalità dell'oggetto set di righe andranno perdute quasi del tutto. Supporta solo operazioni IUnknown e il rilascio di handle di riga e di funzione di accesso in attesa.
DBPROP_DEFERRED R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: se impostata su VARIANT_TRUE, OLE DB Driver per SQL Server tenta di usare un cursore server per il set di righe. Le colonne di tipo text, ntext e image non vengono restituite dal server fino a quando l'applicazione non vi accede.
DBPROP_DELAYSTORAGEOBJECTS R/W (L/S): Sola lettura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server supporta la modalità di aggiornamento immediato negli oggetti di archiviazione.

Le modifiche apportate ai dati in un oggetto flusso sequenziale vengono immediatamente inviate a SQL Server. Viene eseguito il commit delle modifiche in base alla modalità di transazione del set di righe.
DBPROP_HIDDENCOLUMNS R/W (L/S): Sola lettura

Predefinito: VARIANT_FALSE

Descrizione: numero di colonne nascoste

Se DBPROP_UNIQUEROWS è VARIANT_TRUE, la proprietà DBPROP_HIDDENCOLUMNS restituisce il numero di colonne nascoste (hidden) aggiuntive inserite dal provider per identificare in modo univoco le righe all'interno del set di righe. Queste colonne vengono restituite da IColumnsInfo::GetColumnInfo e IColumnsRowset::GetColumnsRowset. Non sono tuttavia incluse nel conteggio delle righe restituite dall'argomento pcColumns restituito da IColumnsInfo::GetColumnInfo.

Per determinare il numero totale di colonne rappresentate nella struttura prgInfo restituita da IColumnsInfo::GetColumnInfo, incluse le colonne nascoste, il consumer aggiunge il valore di DBPROP_HIDDENCOLUMNS al conteggio delle colonne restituite da IColumnsInfo::GetColumnInfo in pcColumns. Se DBPROP_UNIQUEROWS è VARIANT_FALSE, il valore di DBPROP_HIDDENCOLUMNS è zero.
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo R/W (L/S): Sola lettura

Predefinito: VARIANT_TRUE

Descrizione: OLE DB Driver per SQL Server supporta queste interfacce in tutti i set di righe.
DBPROP_IColumnsRowset R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_TRUE

Descrizione: OLE DB Driver per SQL Server supporta l'interfaccia IColumnsRowset.
DBPROP_IConnectionPointContainer R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: IConnectionPointContainer. Se impostata su VARIANT_TRUE, il set di righe supporta l'interfaccia specificata. Se impostata su VARIANT_FALSE, il set di righe non supporta l'interfaccia specificata. I provider che supportano un'interfaccia devono supportare la proprietà associata all'interfaccia con un valore VARIANT_TRUE. Tali proprietà vengono utilizzate principalmente per richiedere interfacce tramite ICommandProperties::SetProperties.
DBPROP_IMultipleResults R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server supporta l'interfaccia IMultipleResults.
DBPROP_IRowsetChange DBPROP_IRowsetUpdate R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server supporta le interfacce IRowsetChange e IRowsetUpdate.

Un set di righe creato tramite DBPROP_IRowsetChange uguale a VARIANT_TRUE indica comportamenti basati sulla modalità di aggiornamento immediato.

Quando DBPROP_IRowsetUpdate è VARIANT_TRUE, anche DBPROP_IRowsetChange è VARIANT_TRUE. Il set di righe indica un comportamento basato sulla modalità di aggiornamento posticipato.

OLE DB Driver per SQL Server usa un cursore SQL Server per supportare i set di righe che espongono IRowsetChange o IRowsetUpdate. Per altre informazioni, vedere Set di righe e cursori SQL Server.
DBPROP_IRowsetIdentity R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_TRUE

Descrizione: OLE DB Driver per SQL Server supporta l'interfaccia IRowsetIdentity. Se un set di righe supporta questa interfaccia, qualsiasi coppia di handle di riga che rappresenta la stessa riga sottostante rifletterà sempre gli stessi dati e lo stesso stato. I consumer possono chiamare il metodo IRowsetIdentity:: IsSameRow per confrontare due handle di riga e determinare se fanno riferimento alla stessa istanza di riga.
DBPROP_IRowsetLocate DBPROP_IRowsetScroll R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server può esporre le interfacce IRowsetLocate e IRowsetScroll.

Quando DBPROP_IRowsetLocate è VARIANT_TRUE, anche DBPROP_CANFETCHBACKWARDS e DBPROP_CANSCROLLBACKWARDS sono VARIANT_TRUE.

Se DBPROP_IRowsetScroll è VARIANT_TRUE, anche DBPROP_IRowsetLocate è VARIANT_TRUE ed entrambe le interfacce sono disponibili nel set di righe.

I segnalibri sono necessari per entrambe le interfacce. Il driver OLE DB per SQL Server imposta DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS su VARIANT_TRUE quando il consumer richiede una delle interfacce.

OLE DB Driver per SQL Server usa i cursori SQL Server per supportare IRowsetLocate e IRowsetScroll. Per altre informazioni, vedere Set di righe e cursori SQL Server.

L'impostazione di queste proprietà in conflitto con altre proprietà di definizione del cursore per il driver OLE DB per SQL Server causa un errore. Impostando, ad esempio, DBPROP_IRowsetScroll su VARIANT_TRUE quando anche DBPROP_OTHERINSERT è VARIANT_TRUE, viene generato un errore durante il tentativo di apertura di un set di righe da parte del consumer.
DBPROP_IRowsetResynch R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server espone l'interfaccia IRowsetResynch su richiesta. OLE DB Driver per SQL Server può esporre l'interfaccia su qualsiasi set di righe.
DBPROP_ISupportErrorInfo R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_TRUE

Descrizione: OLE DB Driver per SQL Server espone l'interfaccia ISupportErrorInfo su set di righe.
DBPROP_ILockBytes Questa interfaccia non viene implementata da OLE DB Driver per SQL Server. Il tentativo di lettura o scrittura della proprietà genera un errore.
DBPROP_ISequentialStream R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server espone l'interfaccia ISequentialStream per supportare dati di tipo long a lunghezza variabile archiviati in SQL Server.
DBPROP_IStorage Questa interfaccia non viene implementata da OLE DB Driver per SQL Server. Il tentativo di lettura o scrittura della proprietà genera un errore.
DBPROP_IStream Questa interfaccia non viene implementata da OLE DB Driver per SQL Server. Il tentativo di lettura o scrittura della proprietà genera un errore.
DBPROP_IMMOBILEROWS R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_TRUE

Descrizione: la proprietà è VARIANT_TRUE solo per i cursori keyset SQL Server, mentre è VARIANT_FALSE per tutti gli altri cursori.

VARIANT_TRUE: il set di righe non riordinerà le righe inserite o aggiornate. Per IRowsetChange::InsertRow, le righe vengono visualizzate alla fine del set di righe. Per IRowsetChange::SetData, se il set di righe non viene ordinato, la posizione delle righe aggiornate non viene modificata. Se il set di righe viene ordinato e IRowsetChange::SetData modifica una colonna usata per ordinare il set di righe, la riga non viene spostata. Se il set di righe è basato su un set di colonne chiave, in genere un set di righe per cui DBPROP_OTHERUPDATEDELETE è VARIANT_TRUE ma DBPROP_OTHERINSERT è VARIANT_FALSE, la modifica del valore di una colonna chiave equivale in genere all'eliminazione della riga corrente e all'inserimento di una nuova. Può pertanto sembrare che la riga venga spostata o non più visualizzata nel set di righe, se DBPROP_OWNINSERT è VARIANT_FALSE, anche se la proprietà DBPROP_IMMOBILEROWS è VARIANT_TRUE.

VARIANT_FALSE: se il set di righe viene ordinato, le righe inserite vengono visualizzate nell'ordine corretto del set di righe. Se il set di righe non viene ordinato, la riga inserita viene visualizzata alla fine. Se IRowsetChange::SetData modifica una colonna usata per ordinare il set di righe, la riga viene spostata. Se il set di righe non viene ordinato, la posizione della riga non viene modificata.
DBPROP_LITERALIDENTITY R/W (L/S): Sola lettura

Predefinito: VARIANT_TRUE

Descrizione: questa proprietà è sempre VARIANT_TRUE.
DBPROP_LOCKMODE R/W (L/S): Lettura/Scrittura

Predefinito: DBPROPVAL_LM_NONE

Descrizione: livello di blocco eseguito dal set di righe (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW).

Nota: quando si usa l'isolamento dello snapshot in una transazione, se un set di righe viene aperto usando un cursore server dinamico o keyset e la modalità di blocco è impostata su DBPROPVAL_LM_SINGLEROW, si verifica un errore durante il recupero di una riga se questa è stata aggiornata da un altro utente dall'avvio della transazione. Per altri tipi di cursore e modalità di blocco, se un altro utente ha aggiornato la riga dall'avvio della transazione, non si verifica alcun errore fino a quando l'utente non tenta di aggiornare la riga. In entrambi i casi, questi errori vengono generati dal server.
DBPROP_MAXOPENROWS R/W (L/S): Sola lettura

Predefinito: 0

Descrizione: OLE DB Driver per SQL Server non limita il numero di righe che possono essere attive nei set di righe.
DBPROP_MAXPENDINGROWS R/W (L/S): Sola lettura

Predefinito: 0

Descrizione: OLE DB Driver per SQL Server non limita il numero di righe nel set di righe con modifiche in sospeso.
DBPROP_MAXROWS R/W (L/S): Lettura/Scrittura

Predefinito: 0

Descrizione: per impostazione predefinita OLE DB Driver per SQL Server non limita il numero di righe attive in set di righe. Quando il consumer imposta DBPROP_MAXROWS, il driver OLE DB per SQL Server usa l'istruzione SET ROWCOUNT per limitare il numero di righe nel set di righe.

SET ROWCOUNT può provocare conseguenze impreviste nell'esecuzione di istruzioni SQL Server. Per altre informazioni, vedere SET ROWCOUNT.
DBPROP_MAYWRITECOLUMN Questa proprietà del set di righe non viene implementata da OLE DB Driver per SQL Server. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_MEMORYUSAGE Questa proprietà del set di righe non viene implementata da OLE DB Driver per SQL Server. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_NOTIFICATIONGRANULARITY Questa proprietà del set di righe non viene implementata da OLE DB Driver per SQL Server. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_NOTIFICATIONPHASES R/W (L/S): Sola lettura

Impostazione predefinita: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT

Descrizione: OLE DB Driver per SQL Server supporta tutte le fasi di notifica.
DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE R/W (L/S): Sola lettura

Impostazione predefinita: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

Descrizione: le fasi di notifica di OLE DB Driver per SQL Server sono annullabili prima di un tentativo di esecuzione della modifica del set di righe indicata. OLE DB Driver per SQL Server non supporta l'annullamento della fase al termine del tentativo.
DBPROP_ORDEREDBOOKMARKS Questa proprietà del set di righe non viene implementata da OLE DB Driver per SQL Server. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: l'impostazione delle proprietà di visibilità delle modifiche fa in modo che OLE DB Driver per SQL Server usi cursori SQL Server per supportare il set di righe. Per altre informazioni, vedere Set di righe e cursori SQL Server.
DBPROP_QUICKRESTART R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: se impostata su VARIANT_TRUE, OLE DB Driver per SQL Server tenta di usare un cursore server per il set di righe.
DBPROP_REENTRANTEVENTS R/W (L/S): Sola lettura

Predefinito: VARIANT_TRUE

Descrizione: i set di righe di OLE DB Driver per SQL Server sono rientranti e possono restituire DB_E_NOTREENTRANT se un consumer tenta di accedere a un metodo del set di righe non rientrante da un callback di notifica.
DBPROP_REMOVEDELETED R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server modifica il valore della proprietà in base alla visibilità delle modifiche ai dati di SQL Server esposti dal set di righe.

VARIANT_TRUE: le righe eliminate dal consumer o da altri utenti di SQL Server vengono rimosse dal set di righe quando questo viene aggiornato. DBPROP_OTHERINSERT è VARIANT_TRUE.

VARIANT_FALSE: le righe eliminate dal consumer o da altri utenti di SQL Server vengono rimosse dal set di righe quando questo viene aggiornato. Il valore dello stato di riga per righe di SQL Server eliminate nel set di righe è DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT è VARIANT_TRUE.

Questa proprietà ha valore solo per i set di righe supportati da cursori SQL Server. Per altre informazioni, vedere Set di righe e cursori SQL Server.

Quando la proprietà DBPROP_REMOVEDELETED viene implementata in un set di righe del cursore keyset, le righe eliminate vengono rimosse in fase di recupero ed è possibile che i metodi di recupero righe, ad esempio GetNextRows e GetRowsAt, restituiscano sia S_OK sia un numero minore di righe rispetto al necessario. Si noti che questo comportamento non implica la condizione DB_S_ENDOFROWSET. Inoltre, il numero di righe restituito non sarà mai pari a zero se vi sono righe rimanenti.
DBPROP_REPORTMULTIPLECHANGES Questa proprietà del set di righe non viene implementata da OLE DB Driver per SQL Server. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_RETURNPENDINGINSERTS R/W (L/S): Sola lettura

Predefinito: VARIANT_FALSE

Descrizione: quando viene chiamato un metodo che recupera righe, OLE DB Driver per SQL Server non restituisce righe di inserimento in sospeso.
DBPROP_ROWRESTRICT R/W (L/S): Sola lettura

Predefinito: VARIANT_TRUE

Descrizione: OLE DB Driver per SQL Server non supporta i diritti di accesso in base alla riga. Se l'interfaccia IRowsetChange è esposta in un set di righe, il metodo SetData può essere chiamato dal consumer.
DBPROP_ROWSET_ASYNCH R/W (L/S): Lettura/Scrittura

Predefinito: 0

Descrizione: consente l'elaborazione asincrona dei set di righe. Questa proprietà è inclusa nel gruppo di proprietà Rowset e nel set di proprietà DBPROPSET_ROWSET. Il tipo è VT_14.

L'unico valore nella maschera di bit supportata da OLE DB Driver per SQL Server è DBPROPVAL_ASYNCH_INITIALIZE.
DBPROP_ROWTHREADMODEL R/W (L/S): Sola lettura

Predefinito: DBPROPVAL_RT_FREETHREAD

Descrizione: OLE DB Driver per SQL Server supporta l'accesso ai relativi oggetti da più thread di esecuzione di un singolo consumer.
DBPROP_SERVERCURSOR R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: se impostata, viene utilizzato un cursore SQL Server per supportare il set di righe. Per altre informazioni, vedere Set di righe e cursori SQL Server.
DBPROP_SERVERDATAONINSERT R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: dati server in fase di inserimento.

VARIANT_TRUE: quando viene trasmesso un inserimento al server, il provider recupera i dati dal server per aggiornare la cache locale delle righe.

VARIANT_FALSE: il provider non recupera i valori server per le nuove righe inserite.
DBPROP_STRONGIDENTITY R/W (L/S): Sola lettura

Predefinito: VARIANT_TRUE

Descrizione: identità di riga forte. Se in un set di righe gli inserimenti sono consentiti, ovvero se IRowsetChange o IRowsetUpdate è true, e la proprietà DBPROP_UPDATABILITY è impostata per il supporto di InsertRows, il valore di DBPROP_STRONGIDENTITY dipende dalla proprietà DBPROP_CHANGEINSERTEDROWS (è VARIANT_FALSE se il valore della proprietà DBPROP_CHANGEINSERTEDROWS è VARIANT_FALSE).
DBPROP_TRANSACTEDOBJECT R/W (L/S): Sola lettura

Predefinito: VARIANT_FALSE

Descrizione: OLE DB Driver per SQL Server supporta solo oggetti in transazioni. Per altre informazioni, vedere Transazioni.
DBPROP_UNIQUEROWS R/W (L/S): Lettura/Scrittura

Predefinito: VARIANT_FALSE

Descrizione: righe univoche.

VARIANT_TRUE: ogni riga viene identificata in modo univoco dai relativi valori di colonna. Per il set di colonne che identificano in modo univoco la riga, il set DBCOLUMNFLAGS_KEYCOLUMN nella struttura DBCOLUMNINFO viene restituito dal metodo GetColumnInfo.

VARIANT_FALSE: le righe possono o non possono essere identificate in modo univoco dai relativi valori di colonna. Le colonne chiave possono o non possono essere contrassegnate con DBCOLUMNFLAGS_KEYCOLUMN.
DBPROP_UPDATABILITY R/W (L/S): Lettura/Scrittura

Predefinito: 0

Descrizione: OLE DB Driver per SQL Server supporta tutti i valori DBPROP_UPDATABILITY. L'impostazione di DBPROP_UPDATABILITY non consente di creare un set di righe modificabile. Per rendere modificabile un set di righe, impostare DBPROP_IRowsetChange o DBPROP_IRowsetUpdate.

Il driver OLE DB per SQL Server definisce il set di proprietà DBPROPSET_SQLSERVERROWSET specifico del provider in questa tabella.

ID proprietà Descrizione
SSPROP_COLUMN_ID Colonna: ColumnID

R/W (L/S): Sola lettura

Tipo: VT_U12 | VT_ARRAY

Predefinito: VT_EMPTY

Descrizione: matrice di valori integer che rappresenta la posizione ordinale (base 1) di una colonna di risultati della clausola COMPUTE all'interno dell'istruzione Transact-SQL SELECT. È l'equivalente di OLE DB Driver per SQL Server dell'attributo ODBC SQL_CA_SS_COLUMN_ID.
SSPROP_DEFERPREPARE Colonna: No

R/W (L/S): Lettura/Scrittura

Digitare: VT_BOOL

Predefinito: VARIANT_TRUE

Descrizione: VARIANT_TRUE: in esecuzione preparata la preparazione del comando è posticipata fino a quando non viene chiamato ICommand::Execute o non viene eseguita un'operazione di metaproprietà. Se la proprietà è impostata su

VARIANT_FALSE: l'istruzione viene preparata quando si esegue ICommandPrepare::Prepare.
SSPROP_IRowsetFastLoad Colonna: No

R/W (L/S): Lettura/Scrittura

Digitare: VT_BOOL

Predefinito: VARIANT_FALSE

Descrizione: impostare questa proprietà su VARIANT_TRUE per aprire un set di righe di caricamento rapido con IOpenRowset::OpenRowset. Non è possibile impostare questa proprietà in ICommandProperties::SetProperties.
SSPROP_ISSAsynchStatus Colonna: No.

R/W (L/S): Lettura/Scrittura

Digitare: VT_BOOL

Predefinito: VARIANT_FALSE

Descrizione: impostare questa proprietà su VARIANT_TRUE per abilitare le operazioni asincrone con l'interfaccia ISSAsynchStatus.
SSPROP_ISSDataClassification R/W (L/S): Lettura/Scrittura

Digitare: VT_BOOL

Predefinito: VARIANT_TRUE

Descrizione: OLE DB Driver per SQL Server supporta il recupero di informazioni sulla classificazione della riservatezza mediante l'interfaccia ISSDataClassification.
SSPROP_MAXBLOBLENGTH Colonna: No

R/W (L/S): Lettura/Scrittura

Digitare: VT_I4

Predefinito: il provider non limita le dimensioni del testo restituito dal server e il valore della proprietà è impostato sul valore massimo, ad esempio 2147483647.

Descrizione: OLE DB Driver per SQL Server esegue un'istruzione SET TEXTSIZE per limitare la lunghezza dei dati BLOB (Binary Large Object Block, oggetto binario di grandi dimensioni) restituiti in un'istruzione SELECT.
SSPROP_NOCOUNT_STATUS Colonna: NoCount

R/W (L/S): Sola lettura

Digitare: VT_BOOL

Predefinito: VARIANT_FALSE

Descrizione: valore booleano che rappresenta lo stato di SET NOCOUNT ON/OFF in SQL Server:

VARIANT_TRUE: con SET NOCOUNT ON

VARIANT_TRUE: con SET NOCOUNT OFF
SSPROP_QP_NOTIFICATION_MSGTEXT Colonna: No

R/W (L/S): Lettura/Scrittura

Digitare: VT_BSTR (da 1 a 2000 caratteri consentiti)

Predefinito: stringa vuota

Descrizione: testo del messaggio della notifica delle query. Il testo è definito dall'utente e non ha un formato definito.
SSPROP_QP_NOTIFICATION_OPTIONS Colonna: No

R/W (L/S): Lettura/Scrittura

Digitare: VT_BSTR

Predefinito: stringa vuota

Descrizione: Opzioni di notifica delle query. Tali opzioni vengono specificate in una stringa con name=value. L'utente è responsabile della creazione del servizio e della lettura delle notifiche all'esterno della coda. La sintassi delle opzioni delle notifiche delle query è la seguente:

service=<service-name>[;(local database=<database>&#124;broker instance=<broker instance>)]

Ad esempio:

service=mySSBService;local database=mydb
SSPROP_QP_NOTIFICATION_TIMEOUT Colonna: No

R/W (L/S): Lettura/Scrittura

Digitare: VT_UI4

Predefinito: 432000 secondi (5 giorni)

Minimo: 1 secondo

Massimo: 2^31-1 secondi

Descrizione: Numero di secondi durante i quali la notifica di query deve rimanere attiva.

Vedere anche

Set di righe