DBSETPROP( ) (Función)

Artículo
04/11/2008

Establece una propiedad para la base de datos actual o para campos, conexiones con nombre, tablas o vistas de la base de datos actual.

DBSETPROP(cName, cType, cProperty, ePropertyValue)

Valores devueltos

Logical

Parámetros

cName
Especifica el nombre de la base de datos actualmente abierta o el campo, conexión con nombre o vista de la base de datos actualmente abierta para los cuales DBGETPROP( ) devuelve información.

Para establecer una propiedad para un campo de una tabla o una vista, escriba el nombre del campo con el nombre de la tabla o la vista que contiene el campo. Por ejemplo, para establecer una propiedad para el campo custid en la tabla customer, especifique la línea siguiente para cName:
```
customer.custid
```

cType
Especifica si cName es la base de datos actual o un campo, una conexión con nombre, una tabla o una vista de la base de datos actual.

La tabla siguiente indica los valores que se pueden especificar para cType:

cType	Descripción
CONNECTION	cName es una conexión con nombre de la base de datos actual.
DATABASE	cName es la base de datos actual.
FIELD	cName es un campo de la base de datos actual.
TABLE	cName es una tabla de la base de datos actual.
VIEW	cName es una vista de la base de datos actual.

cProperty
Especifica el nombre de la propiedad que se va a establecer. Si una propiedad es de sólo lectura, su valor no podrá cambiarse con DBSETPROP( ). Si intenta establecer una propiedad que es de sólo lectura, Visual FoxPro genera un mensaje de error.

Para obtener información adicional acerca de las propiedades que puede especificar con cProperty, incluidos sus tipos de datos, vea DBGETPROP( ).
ePropertyValue
Especifica el valor en el que se establece cProperty. ePropertyValue debe utilizar el mismo tipo de datos que la propiedad.

Precaución Visual FoxPro no comprueba que el valor que especifica es válido para la propiedad. De esta forma, es posible establecer una propiedad como un valor no válido con DBSETPROP( ). Por ejemplo, DBSETPROP( ) puede emplearse para establecer una expresión de regla de campo en una expresión que no es válida para el campo y Visual FoxPro no genera un error. Para evitar errores al establecer la propiedad Tables de una vista, inserte antes de ePropertyValue la designación de la base de datos, con la siguiente sintaxis:

         <databaseName>!ePropertyValue

Observaciones

DBSETPROP( ) se utiliza para establecer propiedades para la base de datos actual o campos, conexiones con nombre, tablas o vistas de la base de datos actual. Utilice DBGETPROP( ) para determinar los valores actuales de la propiedad.

DBSETPROP( ) devuelve verdadero (.T.) si Visual FoxPro establece correctamente la propiedad que usted especifica. Visual FoxPro genera un error si no puede establecerse la propiedad especificada.

Para obtener más detalles acerca de las propiedades que puede obtener para conexiones, bases de datos, campos, tablas y vistas, consulte los temas que figuran en la siguiente tabla.

Para obtener detalles acerca de	Consulte este tema	En esta sección
Propiedades de la base de datos	Ver y configurar propiedades de bases de datos	Crear bases de datos
Conexiones	Acceso a datos remotos	Crear vistas
Vistas		Crear vistas
Desencadenadores	Desencadenar el uso	Trabajar con tablas
Títulos	Controlar la presentación de un campo	Trabajar con tablas
Valores predeterminados	Crear valores predeterminados de campo	Trabajar con tablas
	Crear valores predeterminados para campos de vista	Crear vistas
Comentarios	"Agregar comentarios a los campos" en Elegir los tipos de datos	Trabajar con tablas
	Ver y configurar propiedades de bases de datos	Crear bases de datos
Clave principal	Controlar los valores duplicados	Trabajar con tablas
Reglas	Exigir reglas de empresa	Trabajar con tablas
	Establecer o modificar reglas de campo o de tabla	Trabajar con tablas
	Crear reglas en campos y filas de vistas	Crear vistas

Ejemplo

El ejemplo siguiente utiliza DBSETPROP( ) para especificar un comentario para el campo cust_id de la tabla customer. DBGETPROP( ) se emplea para mostrar el comentario.

CLOSE DATABASES
CLEAR

OPEN DATABASE (HOME(2) + 'data\testdata')
USE customer     && Open customer table

= DBSETPROP("customer.cust_id", "Field", "Comment", ;
  "Property has been set by DBSETPROP.")  && New field comments

cRESULTS = DBGETPROP("customer.cust_id", "Field", "Comment")
WAIT WINDOW "Cust_id field comments: "+ cRESULTS  && Display comments

Vea también