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.

Observação

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

Sintaxe

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

Nada

Comentários

Use o método SetPrimaryKey para especificar a configuração da chave primária e o nome da coluna de chave primária ou colunas para o conjunto de registros 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.

Você pode especificar que o conjunto de registros 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.

Constant	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 da coluna ou colunas que você deseja 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.

Use o método GetPrimaryKey para determinar a configuração de chave primária atual para o conjunto de registros de dados, bem como o nome da coluna ou colunas, se houver, que atualmente são definidas como a coluna de chave primária ou colunas.

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.