Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método DataRecordset.SetPrimaryKey (Visio)

Office 2013 and later

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.

Observação Observação

This Visio object or member is available only to licensed users of Visio Professional 2013.

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

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

Parâmetros

Nome

Obrigatório/opcional

Tipo de dados

Descrição

PrimaryKeySettings

Obrigatório

VisPrimaryKeySettings

A configuração de chave primária para o conjunto de registros de dados. Consulte Comentários para obter os valores possíveis.

PrimaryKey()

Obrigatório

[SAFE-ARRAY]

Uma matriz de variáveis String .

Valor de Retorno

Nothing

Você pode usar o método SetPrimaryKey para especificar a configuração de chave primária e o nome da coluna de chave primária ou colunas para o conjunto de registros de dados. Você pode especificar 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 você não especificar uma chave primária) é visKeyRowOrder, que significa que o Visio identifica linhas do conjunto de registros de dados por ordem de linha.

Você pode especificar que o conjunto de registros de dados tenha um chave primária composta ou de coluna única. 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 uma linha de forma exclusiva. Os valores possíveis para PrimaryKeySettings são mostrados nesta tabela.

Constante

Valor

Descrição

visKeyRowOrder

1

Usar a ordem das linhas como a chave primária.

visKeySingle

2

Usar uma única coluna como coluna de chaves primárias.

visKeyComposite

3

Usar várias colunas como colunas de chaves primárias.

Para o parâmetro PrimaryKey(), passe uma matriz de uma ou mais cadeias de caracteres que representam o nome de uma ou mais colunas que você deseja definir como coluna(s) de chaves primárias. 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.

Você pode usar o método GetPrimaryKey para determinar a configuração atual de chave primária para o conjunto de registros de dados, bem como o nome de uma ou mais colunas, se houver, definidas no momento como colunas de chaves primárias.

Este Microsoft Visual Basic for Applications (VBA) macro 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 chave primária. A macro localiza mais recentemente criado o conjunto de registros de dados associado ao documento, especifica a configuração de chave primária (visKeySingle, para indicar uma chave primária de coluna única) e define o nome da coluna de chave primária.

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
Mostrar: