Método PackTombstoneKey
Converte a chave de linha da tabela especificada no formato usado para a chave de linha na tabela de marcas de exclusão.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)
Sintaxe
'Declaração
Public Function PackTombstoneKey ( _
tableName As String, _
columnValues As Object() _
) As Byte()
'Uso
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[]
Parâmetros
- tableName
Tipo: System. . :: . .String
O nome da tabela que contém a linha.
- columnValues
Tipo: array<System. . :: . .Object> [] () [] []
Uma matriz que contém os valores de coluna da chave de linha.
Valor de retorno
Tipo: array<System. . :: . .Byte> [] () [] []
Uma matriz de bytes que representa o valor da chave de linha na tabela de marcas de exclusão.
Exceções
| Exceção | Condição |
|---|---|
| ArgumentException | A tabela especificada não existe. - ou - Nenhuma chave de linha foi definida para a tabela especificada. - ou - O número de elementos em columnValues é diferente do número de colunas na chave de linha definida para a tabela especificada. |
| ArgumentNullException | tableName é nulo. - ou - columnValues is null. |
Comentários
A chave de linha identifica cada linha exclusivamente em uma tabela controlada para o sistema de controle. A chave de linha pode ser uma chave primária da tabela ou uma coluna do tipo uniqueidentifier que possui o atributo ROWGUIDCOL aplicado (coluna ROWGUID). O tipo de chave de linha usado para uma tabela é especificado passando um dos valores de TrackingKeyType quando o controle está habilitado na tabela.
A tabela de marcas de exclusão (__sysOCSDeletedRows) usa uma representação genérica deste valor armazenada na coluna __sysRK. A coluna __sysRK identifica exclusivamente dados na tabela de marcas de exclusão associados a uma linha específica de uma tabela controlada específica.
No caso em que a chave de linha é uma chave primária que consiste em uma única coluna ou onde a chave de linha é a coluna ROWGUID, a matriz columnValues deve ter um único elemento: o valor dessa coluna. Porém, no caso de uma chave primária que consiste em várias colunas, a matriz columnValues deve conter os valores de cada uma das colunas na linha que compõe a chave primária. As colunas devem ser posicionadas na matriz na ordem na qual são definidas na definição de chave primária; ou seja, colunas definidas antes na definição de chave primária devem ter um índice inferior na matriz do que as definida depois delas.