PackTombstoneKey 方法
將指定之資料表中的資料列索引鍵轉換成標記資料表中資料列索引鍵所使用的格式。
命名空間： System.Data.SqlServerCe
組件： System.Data.SqlServerCe (在 System.Data.SqlServerCe.dll 中)
語法
'宣告
Public Function PackTombstoneKey ( _
tableName As String, _
columnValues As Object() _
) As Byte()
'用途
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[]
參數
- tableName
型別：System. . :: . .String
包含此資料列的資料表名稱。
- columnValues
型別：array<System. . :: . .Object> [] () [] []
包含資料列索引鍵之資料行值的陣列。
傳回值
型別：array<System. . :: . .Byte> [] () [] []
位元組陣列，這個陣列代表標記資料表中資料列索引鍵的值。
例外
| 例外狀況 | 條件 |
|---|---|
| ArgumentException | 指定的資料表不存在。 -或- 尚未針對指定的資料表定義任何資料列索引鍵。 -或- columnValues 中的元素數目與針對指定資料表定義之資料列索引鍵中的資料行數目不同。 |
| ArgumentNullException | tableName 是 null。 -或- columnValues 是 null。 |
備註
此資料列索引鍵可向追蹤系統唯一識別追蹤資料表中的每個資料列。此資料列索引鍵可以是資料表的主索引鍵或是已套用 ROWGUIDCOL 屬性之 uniqueidentifier 類型的資料行 (ROWGUID 資料行)。用於資料表之資料列索引鍵類型的指定方式為，在針對資料表啟用追蹤時，傳遞 TrackingKeyType 的其中一個值。
標記資料表 (__sysOCSDeletedRows) 會使用這個值 (儲存在 __sysRK 資料行中) 的一般表示法。__sysRK 資料行可唯一識別標記資料表中與特定追蹤資料表之特定資料列相關聯的資料。
如果資料列索引鍵是由單一資料行所構成的主索引鍵，或者資料列索引鍵是 ROWGUID 資料行， columnValues 陣列就應該具有單一元素：該資料行的值。不過，如果主索引鍵是由多個資料行所構成，columnValues 陣列就應該包含資料列中構成主索引鍵之每個資料行的值。這些資料行應該按照它們在主索引鍵定義中定義的順序放置於陣列中。也就是說，在主索引鍵定義中較早定義的資料行應該比較晚定義的資料行具有較低的陣列索引。