Condividi tramite


Proprietà e comportamenti del set di righe (provider OLE DB di Native Client)

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

Si tratta delle proprietà del set di righe del provider OLE DB di SQL Server Native Client.

ID proprietà Descrizione
DBPROP_ABORTPRESERVE L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

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

VARIANT_FALSE: il provider OLE DB di SQL Server Native Client 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: il provider OLE DB di SQL Server Native Client gestisce un set di righe valido.
DBPROP_ACCESSORDER L/S: Lettura/Scrittura

Impostazione predefinita: 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 dal provider OLE DB di SQL Server Native Client. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_BLOCKINGSTORAGEOBJECTS L/S: Sola lettura

Impostazione predefinita: VARIANT_TRUE

Descrizione: blocco di oggetti di archiviazione del provider OLE DB di SQL Server Native Client usando altri metodi del set di righe.
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client supporta segnalibri per l'identificazione delle righe del 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.

Il provider OLE DB di SQL Server Native Client usa un cursore di Microsoft SQL Server per supportare un set di righe che contiene segnalibri. Per altre informazioni, vedere Set di righe e cursori SQL Server.

Nota: l'impostazione di queste proprietà in conflitto con altre proprietà del provider OLE DB di SQL Server Native Client che definiscono il cursore 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 L/S: Sola lettura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client restituisce DB_E_BADBOOKMARK se il consumer indica un segnalibro non valido durante il posizionamento o la ricerca di un set di righe con segnalibro.
DBPROP_BOOKMARKTYPE L/S: Sola lettura

Impostazione predefinita: DBPROPVAL_BMK_NUMERIC

Descrizione: il provider OLE DB di SQL Server Native Client implementa solo segnalibri numerici. Un segnalibro del provider OLE DB di SQL Server Native Client è intero senza segno a 32 bit, digitare DBTYPE_UI4.
DBPROP_CACHEDEFERRED Questa proprietà del set di righe non viene implementata dal provider OLE DB di SQL Server Native Client. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client supporta il recupero e lo scorrimento all'indietro in set di righe non sequenziali. Il provider OLE DB di SQL Server Native Client 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 L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: per impostazione predefinita, il provider OLE DB di SQL Server Native Client restituisce DB_E_ROWSNOTRELEASED se il consumer tenta di ottenere più righe per un set di righe mentre sono presenti modifiche in sospeso in quelle attualmente presenti 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 del provider OLE DB di SQL Server Native Client che contengono segnalibri sono supportati dai cursori di SQL Server.
DBPROP_CHANGEINSERTEDROWS L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

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

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client imposta la proprietà su VARIANT_TRUE quando non è possibile modificare una colonna in un set di righe 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 L/S: Lettura/Scrittura

Predefinito: 0

Descrizione: per impostazione predefinita, il provider OLE DB di SQL Server Native Client non scade nel metodo ICommand::Execute .
DBPROP_COMMITPRESERVE L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

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

VARIANT_TRUE: il provider OLE DB di SQL Server Native Client gestisce un set di righe valido.

VARIANT_FALSE: il provider OLE DB di SQL Server Native Client 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 L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: se impostato su VARIANT_TRUE provider OLE DB di SQL Server Native Client 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 L/S: Sola lettura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client supporta la modalità di aggiornamento immediato sugli 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 L/S: Sola lettura

Impostazione predefinita: 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 L/S: Sola lettura

Impostazione predefinita: VARIANT_TRUE

Descrizione: il provider OLE DB di SQL Server Native Client supporta queste interfacce in tutti i set di righe.
DBPROP_IColumnsRowset L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_TRUE

Descrizione: il provider OLE DB di SQL Server Native Client supporta l'interfaccia IColumnsRowset .
DBPROP_IConnectionPointContainer L/S: Lettura/Scrittura

Impostazione predefinita: 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 L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client supporta l'interfaccia IMultipleResults .
DBPROP_IRowsetChange DBPROP_IRowsetUpdate L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client 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.

Il provider OLE DB di SQL Server Native Client usa un cursore DI SQL Server per supportare set di righe che espongono IRowsetChange o IRowsetUpdate. Per altre informazioni, vedere Set di righe e cursori SQL Server.
DBPROP_IRowsetIdentity L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_TRUE

Descrizione: il provider OLE DB di SQL Server Native Client 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 L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client 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 provider OLE DB di SQL Server Native Client imposta DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS su VARIANT_TRUE quando il consumer richiede entrambe le interfacce.

Il provider OLE DB di SQL Server Native Client usa cursori DI 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 del provider OLE DB di SQL Server Native Client 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 L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client espone l'interfaccia IRowsetResynch su richiesta. Il provider OLE DB di SQL Server Native Client può esporre l'interfaccia in qualsiasi set di righe.
DBPROP_ISupportErrorInfo L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_TRUE

Descrizione: il provider OLE DB di SQL Server Native Client espone l'interfaccia ISupportErrorInfo nei set di righe.
DBPROP_ILockBytes Questa interfaccia non viene implementata dal provider OLE DB di SQL Server Native Client. Il tentativo di lettura o scrittura della proprietà genera un errore.
DBPROP_ISequentialStream L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client espone l'interfaccia ISequentialStream per supportare dati di lunghezza variabile lunghi archiviati in SQL Server.
DBPROP_IStorage Questa interfaccia non viene implementata dal provider OLE DB di SQL Server Native Client. Il tentativo di lettura o scrittura della proprietà genera un errore.
DBPROP_IStream Questa interfaccia non viene implementata dal provider OLE DB di SQL Server Native Client. Il tentativo di lettura o scrittura della proprietà genera un errore.
DBPROP_IMMOBILEROWS L/S: Lettura/Scrittura

Impostazione predefinita: 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 L/S: Sola lettura

Impostazione predefinita: VARIANT_TRUE

Descrizione: questa proprietà è sempre VARIANT_TRUE.
DBPROP_LOCKMODE L/S: Lettura/Scrittura

Impostazione predefinita: 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 L/S: Sola lettura

Predefinito: 0

Descrizione: il provider OLE DB di SQL Server Native Client non limita il numero di righe che possono essere attive nei set di righe.
DBPROP_MAXPENDINGROWS L/S: Sola lettura

Predefinito: 0

Descrizione: il provider OLE DB di SQL Server Native Client non limita il numero di righe del set di righe con modifiche in sospeso.
DBPROP_MAXROWS L/S: Lettura/Scrittura

Predefinito: 0

Descrizione: per impostazione predefinita, il provider OLE DB di SQL Server Native Client non limita il numero di righe in un set di righe. Quando il consumer imposta DBPROP_MAXROWS, il provider OLE DB di SQL Server Native Client 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 dal provider OLE DB di SQL Server Native Client. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_MEMORYUSAGE Questa proprietà del set di righe non viene implementata dal provider OLE DB di SQL Server Native Client. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_NOTIFICATIONGRANULARITY Questa proprietà del set di righe non viene implementata dal provider OLE DB di SQL Server Native Client. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_NOTIFICATIONPHASES L/S: Sola lettura

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

Descrizione: il provider OLE DB di SQL Server Native Client 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 L/S: Sola lettura

Impostazione predefinita: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

Descrizione: le fasi di notifica del provider OLE DB di SQL Server Native Client sono annullabili prima di un tentativo di eseguire la modifica del set di righe indicata. Il provider OLE DB di SQL Server Native Client non supporta l'annullamento della fase dopo il completamento del tentativo.
DBPROP_ORDEREDBOOKMARKS Questa proprietà del set di righe non viene implementata dal provider OLE DB di SQL Server Native Client. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: l'impostazione delle proprietà di visibilità delle modifiche fa sì che il provider OLE DB di SQL Server Native Client usi i cursori di SQL Server per supportare il set di righe. Per altre informazioni, vedere Set di righe e cursori SQL Server.
DBPROP_QUICKRESTART L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: se impostato su VARIANT_TRUE, il provider OLE DB di SQL Server Native Client tenta di usare un cursore server per il set di righe.
DBPROP_REENTRANTEVENTS L/S: Sola lettura

Impostazione predefinita: VARIANT_TRUE

Descrizione: i set di righe del provider OLE DB di SQL Server Native Client rientrano e possono restituire DB_E_NOTREENTRANT se un consumer tenta di accedere a un metodo di set di righe non partecipante da un callback di notifica.
DBPROP_REMOVEDELETED L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client modifica il valore della proprietà in base alla visibilità delle modifiche apportate 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 dal provider OLE DB di SQL Server Native Client. Il tentativo di lettura o scrittura del valore della proprietà genera un errore.
DBPROP_RETURNPENDINGINSERTS L/S: Sola lettura

Impostazione predefinita: VARIANT_FALSE

Descrizione: quando viene chiamato un metodo che recupera righe, il provider OLE DB di SQL Server Native Client non restituisce righe di inserimento in sospeso.
DBPROP_ROWRESTRICT L/S: Sola lettura

Impostazione predefinita: VARIANT_TRUE

Descrizione: i set di righe del provider OLE DB di SQL Server Native Client non supportano 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 L/S: Lettura/Scrittura

Predefinito: 0

Descrizione: fornisce 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 supportato da SQL Server Native Client è DBPROPVAL_ASYNCH_INITIALIZE.
DBPROP_ROWTHREADMODEL L/S: Sola lettura

Impostazione predefinita: DBPROPVAL_RT_FREETHREAD

Descrizione: il provider OLE DB di SQL Server Native Client supporta l'accesso ai relativi oggetti da più thread di esecuzione di un singolo consumer.
DBPROP_SERVERCURSOR L/S: Lettura/Scrittura

Impostazione predefinita: 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 L/S: Lettura/Scrittura

Impostazione predefinita: VARIANT_FALSE

Descrizione: dati server in fase di inserimento.

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

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

Impostazione predefinita: VARIANT_TRUE

Descrizione: identità di riga sicura. 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 L/S: Sola lettura

Impostazione predefinita: VARIANT_FALSE

Descrizione: il provider OLE DB di SQL Server Native Client supporta solo oggetti transazionati. Per altre informazioni, vedere Transazioni.
DBPROP_UNIQUEROWS L/S: Lettura/Scrittura

Impostazione predefinita: 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 meno essere identificate in modo univoco dai relativi valori di colonna. Le colonne chiave possono o non possono essere contrassegnate con DBCOLUMNFLAGS_KEYCOLUMN.
DBPROP_UPDATABILITY L/S: Lettura/Scrittura

Predefinito: 0

Descrizione: il provider OLE DB di SQL Server Native Client 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 provider OLE DB di SQL Server Native Client definisce il set di proprietà specifico del provider DBPROPSET_SQLSERVERROWSET come illustrato in questa tabella.

ID proprietà Descrizione
SSPROP_COLUMN_ID Colonna: ColumnID

L/S: Sola lettura

Tipo: VT_U12 | VT_ARRAY

Impostazione predefinita: 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. Si tratta dell'equivalente del provider OLE DB di SQL Server Native Client dell'attributo ODBC SQL_CA_SS_COLUMN_ID.
SSPROP_DEFERPREPARE Colonna: nessuna

L/S: Lettura/Scrittura

Tipo: VT_BOOL

Impostazione predefinita: 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: nessuna

L/S: Lettura/Scrittura

Tipo: VT_BOOL

Impostazione predefinita: 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: nessuna

L/S: Lettura/Scrittura

Tipo: VT_BOOL

Impostazione predefinita: VARIANT_FALSE

Descrizione: impostare questa proprietà su VARIANT_TRUE per consentire operazioni asincrone con l'interfaccia ISSAsynchStatus.
SSPROP_MAXBLOBLENGTH Colonna: nessuna

L/S: Lettura/Scrittura

Tipo: VT_I4

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

Descrizione: il provider OLE DB di SQL Server Native Client esegue un'istruzione SET TEXTSIZE per limitare la lunghezza dei dati BLOB (Binary Large Object) restituiti in un'istruzione SELECT.
SSPROP_NOCOUNT_STATUS Colonna: NoCount

L/S: Sola lettura

Tipo: VT_BOOL

Impostazione predefinita: 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: nessuna

L/S: Lettura/Scrittura

Tipo: VT_BSTR (1-2000 caratteri consentiti)

Impostazione predefinita: 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: nessuna

L/S: Lettura/Scrittura

Tipo: VT_BSTR

Impostazione predefinita: 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: nessuna

L/S: Lettura/Scrittura

Tipo: VT_UI4

Impostazione predefinita: 432000 secondi (5 giorni)

Valore minimo: 1 secondo

Valore massimo: 2^31-1 secondi

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

Vedi anche

Set di righe