Condividi tramite


Metodo PackTombstoneKey

Converte la chiave della riga della tabella specificata nel formato utilizzato per la chiave della riga nella tabella tombstone.

Spazio dei nomi:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Sintassi

'Dichiarazione
Public Function PackTombstoneKey ( _
    tableName As String, _
    columnValues As Object() _
) As Byte()
'Utilizzo
Dim instance As SqlCeChangeTracking
Dim tableName As String
Dim columnValues As Object()
Dim returnValue As Byte()

returnValue = instance.PackTombstoneKey(tableName, _
    columnValues)
public byte[] PackTombstoneKey(
    string tableName,
    Object[] columnValues
)
public:
array<unsigned char>^ PackTombstoneKey(
    String^ tableName, 
    array<Object^>^ columnValues
)
member PackTombstoneKey : 
        tableName:string * 
        columnValues:Object[] -> byte[] 
public function PackTombstoneKey(
    tableName : String, 
    columnValues : Object[]
) : byte[]

Parametri

  • columnValues
    Tipo: array<System. . :: . .Object> [] () [] []
    Matrice contenente i valori di colonna della riga.

Valore restituito

Tipo: array<System. . :: . .Byte> [] () [] []
Matrice di byte che rappresenta il valore della chiave della riga nella tabella tombstone.

Eccezioni

Eccezione Condizione
ArgumentException

La tabella specificata non esiste

oppure

Non è stata definita alcuna chiave della riga per la tabella specificata.

oppure

Il numero di elementi nel parametro columnValues è diverso dal numero di colonne nella chiave della riga definita per la tabella specificata.

ArgumentNullException

Il parametro tableName è Null

oppure

Il parametro columnValues è Null

Osservazioni

La chiave della riga identifica in modo univoco, nel sistema di rilevamento, ogni riga di una tabella con rilevamento. La chiave della riga può essere la chiave primaria della tabella o di una colonna di tipo uniqueidentifier a cui è applicato l'attributo ROWGUIDCOL (colonna ROWGUID). Il tipo di chiave della riga utilizzato per una tabella viene specificato passando uno dei valori dell'oggetto TrackingKeyType quando il rilevamento è abilitato nella tabella.

Nella tabella tombstone (__sysOCSDeletedRows) viene utilizzata una rappresentazione generica di questo valore archiviato nella colonna __sysRK. La colonna __sysRK identifica in modo univoco i dati della tabella tombstone associata a una riga specifica di una tabella con rilevamento specifica.

Nel caso in cui la chiave della riga sia una chiave primaria costituita da una singola colonna o sia la colonna ROWGUID, la matrice columnValues deve disporre di un solo elemento, ovvero il valore di tale colonna. Tuttavia, nel caso di una chiave primaria costituita da più colonne, la matrice columnValues deve contenere i valori di tutte le colonne della riga che costituiscono la chiave primaria. Il posizionamento delle colonne nella matrice deve rispettare l'ordine con cui sono state indicate nella definizione della chiave primaria, ovvero le colonne indicate per prime nella definizione della chiave primaria devono disporre di un indice inferiore nella matrice rispetto a quelle indicate successivamente.

Vedere anche

Riferimento

SqlCeChangeTracking Classe

Membri SqlCeChangeTracking

Spazio dei nomi System.Data.SqlServerCe

EnableTracking

TrackingKeyType