DataRecordset.Name propiedad (Visio)

Obtiene o establece el nombre de presentación del conjunto de registros de datos. Lectura y escritura.

Sintaxis

más sencilla.Nombre

expresión Variable que representa un objeto DataRecordset .

Valor devuelto

Cadena

Comentarios

El nombre para mostrar de un objeto DataRecordset es el nombre que pasó como parámetro Name al método DataRecordsets.Add, DataRecordsets.AddFromConnectionFile o DataRecordsets.AddFromXML al crear por primera vez el conjunto de registros de datos; o el nombre que ha asignado posteriormente al establecer esta propiedad. Si no asigna ningún nombre al crear un conjunto de registros de datos, Microsoft Visio asigna un nombre predeterminado, como Hoja1 , que sería el nombre asignado si importara datos de un libro de Microsoft Excel.

Si especifica (en el parámetro AddOptions de uno de los métodos Add) que se muestre la ventana Datos externos en la interfaz de usuario de Visio, el nombre para mostrar aparecerá en la ficha de la ventana Datos externos correspondiente al conjunto de registros de datos.

El valor de la propiedad Name debe ser único en un documento concreto; no se puede asignar el mismo nombre de presentación a más de un conjunto de registros de datos. Si intenta asignar el valor de la propiedad Name de un conjunto de registros de datos existente al otro conjunto de registros de datos en el mismo documento, se producirá un error en la asignación. Si agrega un nuevo conjunto de registros de datos a un documento utilizando el método Add, y si pasa al método Add el nombre de un conjunto de registros de datos existente como nombre de presentación, Visio agregará un guión y un número (-1, por ejemplo) al nombre para que sea único en el contexto del documento.

Sin embargo, si elimina un conjunto de registros de datos, puede volver a usar el nombre para mostrar del conjunto de registros de datos eliminado para otro conjunto de registros de datos del mismo documento. Esto contrasta con el caso del valor de propiedad DataRecordset.ID . Un identificador concreto es único durante la vida del documento y no se puede volver a usar, incluso si se elimina el conjunto de registros de datos al que se asignó.

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.