Proprietà e comportamenti dei set di righe
Di seguito vengono descritte le proprietà dei 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 in seguito a 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 per 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 degli oggetti di archiviazione del provider OLE DB di SQL Server Native Client utilizzando 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 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. Il provider OLE DB di SQL Server Native Client utilizza un cursore Microsoft SQL Server per supportare un set di righe contenente segnalibri. Per ulteriori informazioni, vedere Set di righe e cursori di Server SQL. .gif "Nota") Nota
L'impostazione di queste proprietà in conflitto con altre proprietà di definizione del cursore per il provider OLE DB di SQL Server Native Client provoca 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 quando si posiziona o si cerca 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 è un valore integer senza segno a 32 bit di tipo 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 inversi 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 ulteriori informazioni, vedere Set di righe e cursori di Server SQL. |
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 su tali 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 del provider OLE DB di SQL Server Native Client che contengono segnalibri sono supportati dai cursori 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 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 |
L/S: Lettura/Scrittura Impostazione predefinita: 0 Descrizione: per impostazione predefinita, non è previsto alcun timeout per il provider OLE DB di SQL Server Native Client 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 in seguito a 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 impostata su VARIANT_TRUE, il provider OLE DB di SQL Server Native Client tenta di utilizzare 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 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 |
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 utilizza un cursore SQL Server per supportare set di righe che espongono IRowsetChange o IRowsetUpdate. Per ulteriori informazioni, vedere Set di righe e cursori di Server SQL. |
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 una delle interfacce. Il provider OLE DB di SQL Server Native Client utilizza i cursori di SQL Server per supportare IRowsetLocate e IRowsetScroll. Per ulteriori informazioni, vedere Set di righe e cursori di Server SQL. L'impostazione di queste proprietà in conflitto con altre proprietà di definizione del cursore per il provider OLE DB di SQL Server Native Client provoca 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 tipo long a lunghezza variabile 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 verranno 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 utilizzata 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 utilizzata 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 utilizza l'isolamento dello snapshot in una transazione, se un set di righe viene aperto tramite 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 Impostazione predefinita: 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 Impostazione predefinita: 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 Impostazione predefinita: 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 utilizza 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 ulteriori 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 esecuzione della modifica del set di righe indicata. Il provider OLE DB di SQL Server Native Client non supporta l'annullamento della fase al termine 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 in modo che il provider OLE DB di SQL Server Native Client utilizzi cursori SQL Server per supportare il set di righe. Per ulteriori informazioni, vedere Set di righe e cursori di Server SQL. |
DBPROP_QUICKRESTART |
L/S: Lettura/Scrittura Impostazione predefinita: VARIANT_FALSE Descrizione: se impostata su VARIANT_TRUE, il provider OLE DB di SQL Server Native Client tenta di utilizzare 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 sono rientranti e possono restituire DB_E_NOTREENTRANT se un consumer tenta di accedere a un metodo del set di righe non rientrante da una richiamata 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 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 non 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 ulteriori informazioni, vedere Set di righe e cursori di Server SQL. 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 diritti di accesso basati sulla 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 Impostazione predefinita: 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 ulteriori informazioni, vedere Set di righe e cursori di Server SQL. |
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 in transazioni. Per ulteriori 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 Impostazione predefinita: 0 Descrizione: il provider OLE DB di SQL Server Native Client supporta tutti i valori di 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à DBPROPSET_SQLSERVERROWSET specifico del provider 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_COMPUTE_BYLIST |
Colonna: ComputeByList L/S: Sola lettura Tipo: VT_BOOL Impostazione predefinita: VARIANT_FALSE Descrizione: valore booleano che indica che la colonna fa parte del set di risultati COMPUTE BY. Si tratta dell'equivalente del provider OLE DB di SQL Server Native Client dell'attributo ODBC SQL_CA_SS_COMPUTE_BYLIST. Nota
La proprietà OLE DB è un valore booleano, ma l'attributo ODBC è in realtà un elenco di valori brevi senza segno con tutta la parte dei numeri ordinali di colonna di una clausola BY.
VARIANT_TRUE: la colonna proviene da un'istruzione COMPUTE BY. VARIANT_FALSE: la colonna è regolare e non proviene dall'istruzione COMPUTE BY. |
SSPROP_COMPUTE_ID |
Colonna: ComputeID L/S: Sola lettura Tipo: VT_U12 Impostazione predefinita: 0 Descrizione: ID di calcolo di una riga che corrisponde al risultato di una clausola COMPUTE nell'istruzione Transact-SQL SELECT corrente. Si tratta dell'equivalente del provider OLE DB di SQL Server Native Client dell'attributo ODBC SQL_CA_SS_COMPUTE_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 tramite 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 utilizzando 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 Block) 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>|broker instance=<broker instance>)] 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. |