Table of contents
TOC
Recolher sumário
Expandir sumário

Método Getprimarykey (Visio)DataRecordset.GetPrimaryKey Method (Visio)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Obtém a 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.Gets the primary key setting and the name of the primary key column or columns for the data recordset.

Observação Este objeto do Visio ou membro está disponível somente para usuários licenciados do Visio Professional 2013.Note This Visio object or member is available only to licensed users of Visio Professional 2013.

SintaxeSyntax

expressão . GetPrimaryKey ( PrimaryKeySettings , PrimaryKey() )expression . GetPrimaryKey( PrimaryKeySettings , PrimaryKey() )

expressão Uma expressão que retorna um objeto DataRecordset .expression An expression that returns a DataRecordset object.

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
PrimaryKeySettingsPrimaryKeySettingsObrigatórioRequiredVisPrimaryKeySettingsVisPrimaryKeySettingsCheck-out de parâmetro. A configuração de chave primária para o conjunto de registros de dados. Consulte comentários para os valores possíveis.Out parameter. The primary key setting for the data recordset. See Remarks for possible values.
PrimaryKey()PrimaryKey()ObrigatórioRequiredStringStringCheck-out de parâmetro. Uma matriz de variáveis String .Out parameter. An array of String variables.

Valor de retornoReturn Value

NadaNothing

ComentáriosRemarks

Você pode usar o método GetPrimaryKey para determinar a existente principal chave configuração para um conjunto de registros de dados e o nome da coluna de chave primária ou colunas se uma chave primária foi especificada. O método retorna a configuração de chave primária para o conjunto de registros de dados na PrimaryKeySettings check-out do parâmetro, como um valor da enumeração VisPrimaryKeySettings . O padrão (quando tiver sido especificada sem chave primária) é visKeyRowOrder , que significa que o Microsoft Visio identifica linhas do conjunto de registros de dados por ordem de linha.You can use the GetPrimaryKey method to determine the existing primary key setting for a data recordset and the name of the primary key column or columns if a primary key has been specified. The method returns the primary key setting for the data recordset in the PrimaryKeySettings out parameter, as a value from the VisPrimaryKeySettings enumeration. The default (when no primary key has been specified) is visKeyRowOrder , which means that Microsoft Visio identifies data recordset rows by row order.

Um conjunto de registros de dados para o qual uma chave primária foi especificada pode ter um única ou compostas colunas de chave primária. Uma chave primária de coluna única baseia a identificação de linha nos valores em uma única coluna. Uma chave primária composta usa duas ou mais colunas para identificar uma linha com exclusividade. Os valores possíveis para PrimaryKeySettings são mostrados nesta tabela.A data recordset for which a primary key has been specified can have single or composite primary key columns. A single-column primary key bases row identification on the values in a single column. A composite primary key uses two or more columns to identify a row uniquely. Possible values for PrimaryKeySettings are shown in this table.

ConstanteConstant* * O valor * *Value **DescriçãoDescription
visKeyRowOrdervisKeyRowOrder11Usar a ordem das linhas como a chave primária.Use row order as the primary key.
visKeySinglevisKeySingle22Usar uma única coluna como coluna de chaves primárias.Use a single column as the primary key column.
visKeyCompositevisKeyComposite33Usar várias colunas como colunas de chaves primárias.Use multiple columns as primary key columns.

Para o PrimaryKey() parâmetro out, passe uma matriz de cadeias de caracteres de sem dimensão. Se a chave primária definindo retornado é visKeySingle ou visKeyComposite , o método também retorna uma matriz de cadeias de caracteres de nome de coluna de chave primária na PrimaryKey() parâmetro out. Se a configuração de chave primária for visKeyRowOrder , o padrão, o método retorna uma matriz vazia.For the PrimaryKey() out parameter, pass a dimensionless array of strings. If the primary key setting returned is visKeySingle or visKeyComposite , the method also returns an array of primary key column name strings in the PrimaryKey() out parameter. If the primary key setting is visKeyRowOrder , the default, the method returns an empty array.

Você pode usar o método Setprimarykey para especificar a configuração de chave primária para o conjunto de registros de dados, bem como o nome da coluna ou colunas que você deseja definir como a coluna de chave primária ou colunas. Quando você define chaves primárias, certifique-se de que a coluna ou colunas que você selecionar a ser colunas de chave primária contenham valores exclusivos (ou conjuntos de valor) para cada linha.You can use the DataRecordset.SetPrimaryKey method to specify the primary key setting for the data recordset as well as the name of the column or columns that you want to set as the primary key column or columns. When you set primary keys, make sure that the column or columns you pick to be primary key columns contain unique values (or value sets) for each row.

ExemploExample

Este Microsoft Visual Basic for Applications (VBA) macro mostra como você pode usar o método GetPrimaryKey para determinar a configuração de chave primária para um conjunto de registros de dados, bem como o nome da primeira coluna de chave primária. A macro localiza o mais recente criado o conjunto de registros de dados associado ao documento e, se uma chave primária tiver sido especificada, imprime na janela imediata o valor da configuração de chave primária e o nome da primeira coluna de chave primária para os dados conjunto de registros. Se não existir chave primária, imprime a configuração de chave primária e a declaração "Sem chave primária."This Microsoft Visual Basic for Applications (VBA) macro shows how you can use the GetPrimaryKey method to determine the primary key setting for a data recordset as well as the name of the first primary key column. The macro finds the most recently created data recordset associated with the document and, if a primary key has been specified, prints in the Immediate window the value of the primary key setting and the name of the first primary key column for the data recordset. If no primary key exists, it prints the primary key setting and the statement "No primary key."

Antes de executar essa macro, crie pelo menos um conjunto de registros de dados no documento atual e, se desejar, especifique uma chave primária usando o método SetPrimaryKey .Before running this macro, create at least one data recordset in the current document and, if you want, specify a primary key by using the SetPrimaryKey method.

Public Sub GetPrimaryKey_Example() 

    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim intCount As Integer 
    Dim astrPrimaryKeyColumns() As String 
    Dim vsoKeySettings As VisPrimaryKeySettings 


    intCount = ThisDocument.DataRecordsets.Count 
    Set vsoDataRecordset = ThisDocument.DataRecordsets(intCount) 
    vsoDataRecordset.GetPrimaryKey vsoKeySettings, astrPrimaryKeyColumns 

    If vsoKeySettings = visKeyRowOrder Then 
        Debug.Print vsoKeySettings, "No primary key" 
    Else 
        Debug.Print vsoKeySettings, astrPrimaryKeyColumns(0) 
    End If 

End Sub
© 2018 Microsoft