Método DataRecordset.SetPrimaryKey (Visio)

Establece el valor de configuración de clave principal y el nombre de la columna o columnas principales del conjunto de registros de datos.

Nota:

Este objeto o miembro Visio solo se encuentra disponible para los usuarios con licencia de Visio Professional 2013.

Sintaxis

expresión. SetPrimaryKey (PrimaryKeySettings, PrimaryKey())

Expresión Expresión que devuelve un objeto DataRecordset .

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
PrimaryKeySettings	Obligatorio	VisPrimaryKeySettings	Configuración de la clave principal del conjunto de registros de datos. Vea la sección Comentarios para obtener los posibles valores.
PrimaryKey()	Obligatorio	[SAFE-ARRAY]	Matriz de variables de tipo String.

Valor devuelto

Nothing

Comentarios

Use el método SetPrimaryKey para especificar la configuración de clave principal y el nombre de la columna o columnas de clave principal para el conjunto de registros de datos. Para especificar la configuración de clave principal del conjunto de registros de datos, se pasa un valor de la enumeración VisPrimaryKeySettings correspondiente al parámetro PrimaryKeySettings. El valor predeterminado (cuando no se especifica ninguna clave principal) es visKeyRowOrder, que significa que Visio identifica las filas del conjunto de registros de datos según el orden de fila.

Puede especificar que el conjunto de registros de datos tenga una sola columna o una clave principal compuesta. Una clave principal de una sola columna basa la identificación de las filas en los valores de una sola columna. Una clave principal compuesta usa dos o más columnas para identificar una fila de forma única. Los posibles valores de PrimaryKeySettings se muestran en la siguiente tabla.

Constante	Valor	Descripción
visKeyRowOrder	1	Se usa el orden de fila como clave principal.
visKeySingle	2	Se usa una sola columna como clave principal.
visKeyComposite	3	Se usan varias columnas como columnas de clave principal.

Para el parámetro PrimaryKey(), pase una matriz de una o varias cadenas que representen el nombre de la columna o columnas que desea establecer como las columnas de clave principal. El valor pasado para el parámetro PrimaryKeySettings debe ser coherente con el número de elementos de la matriz. Cuando establezca los valores de las claves principales, asegúrese de que la columna o las columnas elegidas para ser las columnas de clave principal contienen valores (o conjuntos de valores) únicos para todas las filas.

Use el método GetPrimaryKey para determinar la configuración de clave principal actual para el conjunto de registros de datos, así como el nombre de la columna o columnas, si las hay, que se establecen actualmente como columna o columnas de clave principal.

Ejemplo:

En esta macro de Microsoft Visual Basic para Aplicaciones (VBA) se muestra cómo se puede usar el método SetPrimaryKey para especificar la configuración de la clave principal de un conjunto de registros de datos, así como el nombre de la columna de clave principal. En la macro se busca el último conjunto de registros de datos que se ha creado asociado al documento, se especifica la configuración de clave principal (visKeySingle, para indicar que se trata de una clave principal de una sola columna) y se establece el nombre de la columna de clave principal.

Antes de ejecutar esta macro, debe crear al menos un conjunto de registros de datos en el documento activo y sustituir la variable columnName del código por el nombre de la columna del conjunto de registros de datos que desee especificar como columna de clave principal.

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

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.