Método DataRecordset.SetPrimaryKey (Visio)

Define o valor da configuração de chave primária e o nome de uma ou mais colunas de chaves primárias para o conjunto de registros de dados.

Sintaxe

expressão. SetPrimaryKey (PrimaryKeySettings, PrimaryKey())

expressão Uma expressão que devolve um objeto DataRecordset .

Parâmetros

Valor de retorno

Nada

Comentários

Utilize o método SetPrimaryKey para especificar a definição da chave primária e o nome da coluna ou colunas da chave primária para o conjunto de registos de dados. Especifique a configuração de chave primária para o conjunto de registros de dados passando um valor da enumeração VisPrimaryKeySettings para o parâmetro PrimaryKeySettings. O padrão (quando nenhuma chave primária é especificada) é visKeyRowOrder, que significa que o Microsoft Office Visio identifica as linhas do conjunto de registros de dados por ordem das linhas.

Pode especificar que o conjunto de registos de dados tem uma única coluna ou uma chave primária composta. Uma chave primária de coluna única baseia a identificação da linha nos valores de uma única coluna. Uma chave primária composta usa duas ou mais colunas para identificar exclusivamente uma linha. Os valores possíveis para PrimaryKeySettings são mostrados nesta tabela.

Para o parâmetro PrimaryKey(), transmita uma matriz de uma ou mais cadeias que representem o nome da coluna ou colunas que pretende definir como as colunas de chave primária. O valor passado para o parâmetro PrimaryKeySettings deve ser consistente com o número de itens da matriz. Ao definir as chaves primárias, verifique se a(s) coluna(s) selecionada(s) como coluna(s) de chaves primárias contém(êm) valores (ou conjuntos de valores) exclusivos para cada linha.

Utilize o método GetPrimaryKey para determinar a definição de chave primária atual para o conjunto de registos de dados, bem como o nome da coluna ou colunas, se existirem, que estão atualmente definidas como colunas ou colunas de chave primária.

Exemplo

Essa macro do Microsoft Visual Basic for Applications (VBA) mostra como você pode usar o método SetPrimaryKey para especificar a configuração de chave primária para um conjunto de registros de dados, bem como o nome da coluna de chaves primárias. A macro localiza o conjunto de registros de dados criado mais recentemente e associado ao documento, especifica a configuração da chave primária (visKeySingle, para indicar uma chave primária de uma única coluna) e define o nome da coluna de chaves primárias.

Antes de executar essa macro, crie pelo menos um conjunto de registros de dados no documento atual e substitua a variável columnName no código pelo nome da coluna no conjunto de registros de dados que deseja especificar como a coluna de chaves primárias.

Public Sub SetPrimaryKey_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim intCount As Integer 
    Dim aPrimaryKeyColumns() As String 
     
    intCount = ThisDocument.DataRecordsets.Count 
    aPrimaryKeyColumns(0) = "columnName " 
    Set vsoDataRecordset = ThisDocument.DataRecordsets(intCount) 
    vsoDataRecordset.SetPrimaryKey visKeySingle, aPrimaryKeyColumns 
    
End Sub

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.