Proporciona información sobre un origen de datos.

Información general

Los orígenes de datos pueden proporcionar una gran cantidad de información para optimizar la experiencia del usuario.

Puede usar información de nivel de columna para validar entradas de usuario y proporcionar una respuesta inmediata al usuario antes de usar la función Revisión. La función Validate usa esta misma información.

Puede usar información en el nivel de origen de datos para, por ejemplo, deshabilitar u ocultar los botones Editar y Nuevo de los usuarios que no tienen permisos para editar y crear registros.

Los orígenes de datos varían en la cantidad de información que proporcionan; incluso pueden no ofrecer ninguna. Las colecciones no proporcionan ninguna información. Si no se proporciona una parte de la información, se utilizará el valor predeterminado o se devolverá en blanco.

Descripción

Información de columna

Puede usar DataSourceInfo para obtener información sobre una columna concreta de un origen de datos:

Argumento de información Tipo de resultado Descripción
DataSourceInfo.DisplayName Cadena Nombre para mostrar de la columna. Si no se ha definido ningún nombre para mostrar, devolverá el nombre de la columna.
DataSourceInfo.MaxLength Número Número máximo de caracteres que puede contener la columna. Solo se aplica a las columnas que contienen cadenas. Si no se configura un máximo, devuelve en blanco.
DataSourceInfo.MaxValue Número Valor numérico máximo que puede contener una columna. Solo se aplica a las columnas que contienen números. Si no se configura un máximo, devuelve en blanco.
DataSourceInfo.MinValue Número Valor numérico mínimo que puede contener una columna. Solo se aplica a las columnas que contienen números. Si no se configura un mínimo, devuelve en blanco.
DataSourceInfo.Required Booleano ¿Es un valor requerido para esta columna? Si no se establece mediante el origen de datos devuelve false.

El tercer argumento es el nombre de una columna como una cadena. Por ejemplo, la columna Teléfono de la colección Personas se pasaría como "Teléfono" incluidas las comillas dobles.

Información de origen de datos

Puede usar DataSourceInfo para obtener información sobre un origen de datos como un todo:

Argumento de información Tipo de resultado Descripción
DataSourceInfo.AllowedValues Booleano ¿Qué tipos de permisos se les pueden conceder a los usuarios para este origen de datos? Si no se establecen mediante el origen de datos, se devuelve en blanco.
DataSourceInfo.CreatePermission Booleano ¿Tiene permiso el usuario actual para crear registros en este origen de datos? Si no se establece mediante el origen de datos, devuelve true.
DataSourceInfo.DeletePermission Booleano ¿Tiene permiso el usuario actual para eliminar registros en este origen de datos? Si no se establece mediante el origen de datos, devuelve true.
DataSourceInfo.EditPermission Booleano ¿Tiene permiso el usuario actual para editar registros en este origen de datos? Si no se establece mediante el origen de datos, devuelve true.
DataSourceInfo.ReadPermission Booleano ¿Tiene permiso el usuario actual para leer registros en este origen de datos? Si no se establece mediante el origen de datos, devuelve true.

Sintaxis

DataSourceInfo( DataSource, Information, ColumnName )

  • DataSource: requerido. El origen de datos que se va a usar.
  • Information: requerido. El tipo de información que desea recuperar.
  • ColumnName: opcional. Para la información en el nivel de columna, el nombre de columna como una cadena. La columna Teléfono se pasaría como "Teléfono" incluidas las comillas dobles. Para la información en el nivel de origen de datos, el argumento ColumnName no se puede usar.

    Nota: Para orígenes de datos de SharePoint y Excel que contienen nombres de columna con espacios, especifique cada uno de ellos como "_x0020_". Por ejemplo, especifique "Nombre de columna" como "Nombre_x0020_de_columna".

Ejemplos

Los ejemplos de esta sección usan este origen de datos, denominado IceCream:

El origen de datos también ha proporcionado esta información:

  • El nombre para mostrar para Quantity es "Cantidad disponible".
  • La longitud máxima de Flavor es de 30 caracteres.
  • La columna Flavor debe contener un valor. La columna Quantity no se requiere.
  • La cantidad mínima es 0.
  • La cantidad máxima es 100.
  • El usuario actual puede leer y editar los registros del origen de datos IceCream, pero no se pueden crear ni eliminar registros.
Fórmula Descripción Resultado
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, "Quantity" ) Devuelve el nombre para mostrar de la columna Quantity del origen de datos IceCream. "Cantidad disponible"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, "Flavor" ) Devuelve la longitud máxima de la cadena para la columna Flavor del origen de datos IceCream. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, "Flavor" ) ¿Se requiere la columna Flavor del origen de datos IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.Required, "Quantity" ) ¿Se requiere la columna Quantity del origen de datos IceCream? false
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, "Quantity" ) Devuelve el valor numérico máximo de la columna Quantity del origen de datos IceCream. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, "Quantity" ) Devuelve el valor numérico mínimo de la columna Quantity del origen de datos IceCream. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) ¿Puede leer el usuario actual los registros del origen de datos IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) ¿Puede editar el usuario actual los registros del origen de datos IceCream? true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) ¿Puede crear el usuario actual los registros del origen de datos IceCream? false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) ¿Puede eliminar el usuario actual los registros del origen de datos IceCream? false