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
- tableName
Tipo: System. . :: . .String
Nome della tabella contenente la riga.
- 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.