CDaoTableDef (clase)CDaoTableDef Class

Representa la definición almacenada de una tabla base o una tabla asociada.Represents the stored definition of a base table or an attached table.

SintaxisSyntax

class CDaoTableDef : public CObject

MiembrosMembers

Constructores públicosPublic Constructors

NOMBREName DescripciónDescription
CDaoTableDef:: CDaoTableDefCDaoTableDef::CDaoTableDef Construye un objeto CDaoTableDef.Constructs a CDaoTableDef object.

Métodos públicosPublic Methods

NOMBREName DescripciónDescription
CDaoTableDef:: AppendCDaoTableDef::Append Agrega una nueva tabla a la base de datos.Adds a new table to the database.
CDaoTableDef:: CanUpdateCDaoTableDef::CanUpdate Devuelve un valor distinto de cero si la tabla se puede actualizar (puede modificar la definición de los campos o las propiedades de la tabla).Returns nonzero if the table can be updated (you can modify the definition of fields or the table properties).
CDaoTableDef:: CloseCDaoTableDef::Close Cierra un TableDef abierto.Closes an open tabledef.
CDaoTableDef:: CreateCDaoTableDef::Create Crea una tabla que se puede Agregar a la base de datos mediante Append.Creates a table which can be added to the database using Append.
CDaoTableDef:: CreateFieldCDaoTableDef::CreateField Se llama para crear un campo para una tabla.Called to create a field for a table.
CDaoTableDef:: CreateIndexCDaoTableDef::CreateIndex Se llama para crear un índice para una tabla.Called to create an index for a table.
CDaoTableDef::D eleteFieldCDaoTableDef::DeleteField Se llama para eliminar un campo de una tabla.Called to delete a field from a table.
CDaoTableDef::D eleteIndexCDaoTableDef::DeleteIndex Se llama para eliminar un índice de una tabla.Called to delete an index from a table.
CDaoTableDef:: GetAttributesCDaoTableDef::GetAttributes Devuelve un valor que indica una o más características de un CDaoTableDef objeto.Returns a value that indicates one or more characteristics of a CDaoTableDef object.
CDaoTableDef:: GetConnectCDaoTableDef::GetConnect Devuelve un valor que proporciona información sobre el origen de una tabla.Returns a value that provides information about the source of a table.
CDaoTableDef:: GetDateCreatedCDaoTableDef::GetDateCreated Devuelve la fecha y hora en que se creó la tabla base subyacente a un CDaoTableDef objeto.Returns the date and time the base table underlying a CDaoTableDef object was created.
CDaoTableDef:: GetDateLastUpdatedCDaoTableDef::GetDateLastUpdated Devuelve la fecha y hora del cambio más reciente realizado en el diseño de la tabla base.Returns the date and time of the most recent change made to the design of the base table.
CDaoTableDef:: GetFieldCountCDaoTableDef::GetFieldCount Devuelve un valor que representa el número de campos de la tabla.Returns a value that represents the number of fields in the table.
CDaoTableDef:: GetFieldInfoCDaoTableDef::GetFieldInfo Devuelve tipos específicos de información sobre los campos de la tabla.Returns specific kinds of information about the fields in the table.
CDaoTableDef:: GetIndexCountCDaoTableDef::GetIndexCount Devuelve el número de índices de la tabla.Returns the number of indexes for the table.
CDaoTableDef:: GetIndexInfoCDaoTableDef::GetIndexInfo Devuelve tipos específicos de información sobre los índices de la tabla.Returns specific kinds of information about the indexes for the table.
CDaoTableDef:: GetNameCDaoTableDef::GetName Devuelve el nombre definido por el usuario de la tabla.Returns the user-defined name of the table.
CDaoTableDef:: GetRecordCountCDaoTableDef::GetRecordCount Devuelve el número de registros de la tabla.Returns the number of records in the table.
CDaoTableDef:: GetSourceTableNameCDaoTableDef::GetSourceTableName Devuelve un valor que especifica el nombre de la tabla adjunta en la base de datos de origen.Returns a value that specifies the name of the attached table in the source database.
CDaoTableDef:: GetValidationRuleCDaoTableDef::GetValidationRule Devuelve un valor que valida los datos de un campo a medida que se cambian o se agregan a una tabla.Returns a value that validates the data in a field as it is changed or added to a table.
CDaoTableDef:: GetValidationTextCDaoTableDef::GetValidationText Devuelve un valor que especifica el texto del mensaje que la aplicación muestra si el valor de un objeto de campo no satisface la regla de validación especificada.Returns a value that specifies the text of the message that your application displays if the value of a Field object does not satisfy the specified validation rule.
CDaoTableDef:: IsOpenCDaoTableDef::IsOpen Devuelve un valor distinto de cero si la tabla está abierta.Returns nonzero if the table is open.
CDaoTableDef:: OpenCDaoTableDef::Open Abre un TableDef existente almacenado en la colección TableDef's de la base de datos.Opens an existing tabledef stored in the database's TableDef's collection.
CDaoTableDef:: RefreshLinkCDaoTableDef::RefreshLink Actualiza la información de conexión para una tabla adjunta.Updates the connection information for an attached table.
CDaoTableDef:: SetAttributesCDaoTableDef::SetAttributes Establece un valor que indica una o más características de un CDaoTableDef objeto.Sets a value that indicates one or more characteristics of a CDaoTableDef object.
CDaoTableDef:: SetConnectCDaoTableDef::SetConnect Establece un valor que proporciona información sobre el origen de una tabla.Sets a value that provides information about the source of a table.
CDaoTableDef:: SetNameCDaoTableDef::SetName Establece el nombre de la tabla.Sets the name of the table.
CDaoTableDef:: SetSourceTableNameCDaoTableDef::SetSourceTableName Establece un valor que especifica el nombre de una tabla adjunta en la base de datos de origen.Sets a value that specifies the name of an attached table in the source database.
CDaoTableDef:: SetValidationRuleCDaoTableDef::SetValidationRule Establece un valor que valida los datos de un campo a medida que se cambian o se agregan a una tabla.Sets a value that validates the data in a field as it is changed or added to a table.
CDaoTableDef:: SetValidationTextCDaoTableDef::SetValidationText Establece un valor que especifica el texto del mensaje que la aplicación muestra si el valor de un objeto de campo no satisface la regla de validación especificada.Sets a value that specifies the text of the message that your application displays if the value of a Field object does not satisfy the specified validation rule.

Miembros de datos públicosPublic Data Members

NombreName DescripciónDescription
CDaoTableDef:: m_pDAOTableDefCDaoTableDef::m_pDAOTableDef Puntero a la interfaz de DAO subyacente del objeto TableDef.A pointer to the DAO interface underlying the tabledef object.
CDaoTableDef:: m_pDatabaseCDaoTableDef::m_pDatabase Base de datos de origen de esta tabla.Source database for this table.

ObservacionesRemarks

Cada objeto de base de datos DAO mantiene una colección, denominada TableDefs, que contiene todos los objetos DAO TableDef guardados.Each DAO database object maintains a collection, called TableDefs, that contains all saved DAO tabledef objects.

Puede manipular una definición de tabla mediante un CDaoTableDef objeto.You manipulate a table definition using a CDaoTableDef object. Por ejemplo, puede:For example, you can:

  • Examinar la estructura de campo y de índice de cualquier tabla local, adjunta o externa de una base de datos.Examine the field and index structure of any local, attached, or external table in a database.

  • Llame a SetConnect las SetSourceTableName funciones miembro y para las tablas adjuntas y utilice la RefreshLink función miembro para actualizar las conexiones a las tablas asociadas.Call the SetConnect and SetSourceTableName member functions for attached tables, and use the RefreshLink member function to update connections to attached tables.

  • Llame CanUpdate a la función miembro para determinar si puede editar las definiciones de campo en la tabla.Call the CanUpdate member function to determine if you can edit field definitions in the table.

  • Obtiene o establece las condiciones de validación mediante GetValidationRule y SetValidationRule , y GetValidationText las SetValidationText funciones miembro y.Get or set validation conditions using the GetValidationRule and SetValidationRule, and the GetValidationText and SetValidationText member functions.

  • Utilice la Open función miembro para crear un objeto de tipo de tabla, Dynaset o de instantánea CDaoRecordset .Use the Open member function to create a table-, dynaset-, or snapshot-type CDaoRecordset object.

    Nota

    Las clases de base de datos DAO son distintas de las clases de base de datos MFC basadas en Conectividad abierta de bases de datos (ODBC).The DAO database classes are distinct from the MFC database classes based on Open Database Connectivity (ODBC). Todos los nombres de clase de base de datos DAO tienen el prefijo "CDao".All DAO database class names have the "CDao" prefix. Todavía puede obtener acceso a los orígenes de datos ODBC con las clases DAO; las clases DAO suelen ofrecer funcionalidades superiores porque son específicas del motor de base de datos de Microsoft Jet.You can still access ODBC data sources with the DAO classes; the DAO classes generally offer superior capabilities because they are specific to the Microsoft Jet database engine.

Para utilizar objetos tabledef para trabajar con una tabla existente o crear una nueva tablaTo use tabledef objects either to work with an existing table or to create a new table

  1. En todos los casos, primero construya un CDaoTableDef objeto, proporcionando un puntero a un objeto CDaoDatabase al que pertenece la tabla.In all cases, first construct a CDaoTableDef object, supplying a pointer to a CDaoDatabase object to which the table belongs.

  2. A continuación, haga lo siguiente, en función de lo que desee:Then do the following, depending on what you want:

    • Para usar una tabla guardada existente, llame a la función miembro Open del objeto TableDef y proporcione el nombre de la tabla guardada.To use an existing saved table, call the tabledef object's Open member function, supplying the name of the saved table.

    • Para crear una nueva tabla, llame a la función miembro Create del objeto TableDef y proporcione el nombre de la tabla.To create a new table, call the tabledef object's Create member function, supplying the name of the table. Llame a CreateField y CreateIndex para agregar campos e índices a la tabla.Call CreateField and CreateIndex to add fields and indexes to the table.

    • Llame a Append para guardar la tabla; para ello, agréguelo a la colección TableDefs de la base de datos.Call Append to save the table by appending it to the database's TableDefs collection. Create pone el objeto TableDef en un estado abierto, por lo que después de llamar a, Create no llama a Open .Create puts the tabledef into an open state, so after calling Create you do not call Open.

      Sugerencia

      La manera más sencilla de crear tablas guardadas es crearlas y almacenarlas en la base de datos mediante Microsoft Access.The easiest way to create saved tables is to create them and store them in your database using Microsoft Access. Después, puede abrirlos y usarlos en el código MFC.Then you can open and use them in your MFC code.

Para usar el objeto TableDef que ha abierto o creado, cree y abra un CDaoRecordset objeto, especificando el nombre de la definición de usuario con un dbOpenTable valor en el parámetro nOpenType .To use the tabledef object you have opened or created, create and open a CDaoRecordset object, specifying the name of the tabledef with a dbOpenTable value in the nOpenType parameter.

Para usar un objeto TableDef para crear un CDaoRecordset objeto, normalmente se crea o se abre un objeto TableDef como se describió anteriormente y, a continuación, se crea un objeto de conjunto de registros, pasando un puntero al objeto TableDef cuando se llama a CDaoRecordset:: Open.To use a tabledef object to create a CDaoRecordset object, you typically create or open a tabledef as described above, then construct a recordset object, passing a pointer to your tabledef object when you call CDaoRecordset::Open. El TableDef que pase debe estar en un estado abierto.The tabledef you pass must be in an open state. Para obtener más información, vea la clase CDaoRecordset.For more information, see class CDaoRecordset.

Cuando termine de usar un objeto TableDef, llame a la función miembro Close ; a continuación, destruya el objeto TableDef.When you finish using a tabledef object, call its Close member function; then destroy the tabledef object.

Jerarquía de herenciaInheritance Hierarchy

CObjectCObject

CDaoTableDef

RequisitosRequirements

Encabezado: afxdao. hHeader: afxdao.h

CDaoTableDef:: AppendCDaoTableDef::Append

Llame a esta función miembro después de llamar a Create para crear un nuevo objeto TableDef para guardar TableDef en la base de datos.Call this member function after you call Create to create a new tabledef object to save the tabledef in the database.

virtual void Append();

ObservacionesRemarks

La función anexa el objeto a la colección TableDefs de la base de datos.The function appends the object to the database's TableDefs collection. Puede usar TableDef como un objeto temporal mientras lo define sin anexarlo, pero si desea guardarlo y usarlo, debe llamar a Append .You can use the tabledef as a temporary object while defining it by not appending it, but if you want to save and use it, you must call Append.

Nota

Si intenta anexar una definición de tipo sin nombre (que contiene una cadena nula o vacía), MFC produce una excepción.If you attempt to append an unnamed tabledef (containing a null or empty string), MFC throws an exception.

Para obtener información relacionada, vea el tema sobre el método Append en la ayuda de DAO.For related information, see the topic "Append Method" in DAO Help.

CDaoTableDef:: CanUpdateCDaoTableDef::CanUpdate

Llame a esta función miembro para determinar si se puede cambiar la definición de la tabla subyacente a un CDaoTableDef objeto.Call this member function to determine whether the definition of the table underlying a CDaoTableDef object can be changed.

BOOL CanUpdate();

Valor devueltoReturn Value

Distinto de cero si se puede modificar la estructura de la tabla (esquema) (agregar o eliminar campos e índices), de lo contrario 0.Nonzero if the table structure (schema) can be modified (add or delete fields and indexes), otherwise 0.

ObservacionesRemarks

De forma predeterminada, una tabla recién creada subyacente de un CDaoTableDef objeto se puede actualizar y no se puede actualizar una tabla adjunta subyacente a un CDaoTableDef objeto.By default, a newly created table underlying a CDaoTableDef object can be updated, and an attached table underlying a CDaoTableDef object cannot be updated. Un CDaoTableDef objeto puede ser actualizable, incluso si el conjunto de registros resultante no es actualizable.A CDaoTableDef object may be updatable, even if the resulting recordset is not updatable.

Para obtener información relacionada, vea el tema "propiedad actualizable" en la ayuda de DAO.For related information, see the topic "Updatable Property" in DAO Help.

CDaoTableDef:: CDaoTableDefCDaoTableDef::CDaoTableDef

Construye un objeto CDaoTableDef.Constructs a CDaoTableDef object.

CDaoTableDef(CDaoDatabase* pDatabase);

ParámetrosParameters

pDatabasepDatabase
Un puntero a un objeto CDaoDatabase .A pointer to a CDaoDatabase object.

ObservacionesRemarks

Después de construir el objeto, debe llamar a la función miembro Create o Open .After constructing the object, you must call the Create or Open member function. Cuando termine con el objeto, debe llamar a la función miembro Close y destruir el CDaoTableDef objeto.When you finish with the object, you must call its Close member function and destroy the CDaoTableDef object.

CDaoTableDef:: CloseCDaoTableDef::Close

Llame a esta función miembro para cerrar y liberar el objeto TableDef.Call this member function to close and release the tabledef object.

virtual void Close();

ObservacionesRemarks

Normalmente, después de llamar a Close , se elimina el objeto TableDef si se ha asignado con new .Usually after calling Close, you delete the tabledef object if it was allocated with new.

Puede llamar a Open de nuevo después de llamar a Close .You can call Open again after calling Close. Esto le permite volver a usar el objeto TableDef.This lets you reuse the tabledef object.

Para obtener información relacionada, vea el tema sobre el método Close en la ayuda de DAO.For related information, see the topic "Close Method" in DAO Help.

CDaoTableDef:: CreateCDaoTableDef::Create

Llame a esta función miembro para crear una nueva tabla guardada.Call this member function to create a new saved table.

virtual void Create(
    LPCTSTR lpszName,
    long lAttributes = 0,
    LPCTSTR lpszSrcTable = NULL,
    LPCTSTR lpszConnect = NULL);

ParámetrosParameters

lpszNamelpszName
Puntero a una cadena que contiene el nombre de la tabla.A pointer to a string containing the name of the table.

lAttributeslAttributes
Un valor que corresponde a las características de la tabla representada por el objeto TableDef.A value corresponding to characteristics of the table represented by the tabledef object. Puede usar la operación OR bit a bit para combinar cualquiera de las constantes siguientes:You can use the bitwise-OR to combine any of the following constants:

ConstanteConstant DescripciónDescription
dbAttachExclusive En el caso de las bases de datos que usan el motor de base de datos de Microsoft Jet, indica que la tabla es una tabla adjunta abierta para uso exclusivo.For databases that use the Microsoft Jet database engine, indicates the table is an attached table opened for exclusive use.
dbAttachSavePWD En el caso de las bases de datos que usan el motor de base de datos de Microsoft Jet, indica que el ID. de usuario y la contraseña de la tabla adjunta se guardan con la información de conexión.For databases that use the Microsoft Jet database engine, indicates that the user ID and password for the attached table are saved with the connection information.
dbSystemObject Indica que la tabla es una tabla del sistema proporcionada por el motor de base de datos de Microsoft Jet.Indicates the table is a system table provided by the Microsoft Jet database engine.
dbHiddenObject Indica que la tabla es una tabla oculta proporcionada por el motor de base de datos de Microsoft Jet.Indicates the table is a hidden table provided by the Microsoft Jet database engine.

lpszSrcTablelpszSrcTable
Puntero a una cadena que contiene el nombre de la tabla de origen.A pointer to a string containing the source table name. De forma predeterminada, este valor se inicializa como NULL.By default this value is initialized as NULL.

lpszConnectlpszConnect
Puntero a una cadena que contiene la cadena de conexión predeterminada.A pointer to a string containing the default connection string. De forma predeterminada, este valor se inicializa como NULL.By default this value is initialized as NULL.

ObservacionesRemarks

Una vez que haya llamado a TableDef, puede llamar a Append para guardar el TableDef en la colección TableDefs de la base de datos.Once you have named the tabledef, you can then call Append to save the tabledef in the database's TableDefs collection. Después de llamar a Append , el objeto TableDef está en un estado abierto y puede usarlo para crear un objeto CDaoRecordset .After calling Append, the tabledef is in an open state, and you can use it to create a CDaoRecordset object.

Para obtener información relacionada, vea el tema sobre el método CreateTableDef en la ayuda de DAO.For related information, see the topic "CreateTableDef Method" in DAO Help.

CDaoTableDef:: CreateFieldCDaoTableDef::CreateField

Llame a esta función miembro para agregar un campo a la tabla.Call this member function to add a field to the table.

void CreateField(
    LPCTSTR lpszName,
    short nType,
    long lSize,
    long lAttributes = 0);

void CreateField(CDaoFieldInfo& fieldinfo);

ParámetrosParameters

lpszNamelpszName
Un puntero a una expresión de cadena que especifica el nombre de este campo.A pointer to a string expression specifying the name of this field.

nTypenType
Valor que indica el tipo de datos del campo.A value indicating the data type of the field. El valor puede ser uno de estos valores:The setting can be one of these values:

TipoType Tamaño (bytes)Size (bytes) DescripciónDescription
dbBoolean 1 byte1 byte BOOLBOOL
dbByte BYTEBYTE
dbInteger 22 intint
dbLong 44 longlong
dbCurrency 88 Moneda ( COleCurrency)Currency ( COleCurrency)
dbSingle 44 FLOATfloat
dbDouble 88 doubledouble
dbDate 88 Fecha y hora ( COleDateTime)Date/Time ( COleDateTime)
dbText 1 - 2551 - 255 Texto ( CString)Text ( CString)
dbLongBinary 00 Long Binary (objeto OLE), CLongBinary o CByteArrayLong Binary (OLE Object), CLongBinary or CByteArray
dbMemo 00 Memorando ( CString)Memo ( CString)

lSizelSize
Valor que indica el tamaño máximo, en bytes, de un campo que contiene texto o el tamaño fijo de un campo que contiene valores de texto o numéricos.A value that indicates the maximum size, in bytes, of a field that contains text, or the fixed size of a field that contains text or numeric values. El parámetro Lsize se omite para todos los campos de texto excepto.The lSize parameter is ignored for all but text fields.

lAttributeslAttributes
Un valor que corresponde a las características del campo y que se puede combinar mediante una operación OR bit a bit.A value corresponding to characteristics of the field and that can be combined using a bitwise-OR.

ConstanteConstant DescripciónDescription
dbFixedField El tamaño del campo es fijo (valor predeterminado para los campos numéricos).The field size is fixed (default for Numeric fields).
dbVariableField El tamaño del campo es variable (solo campos de texto).The field size is variable (Text fields only).
dbAutoIncrField El valor del campo para los nuevos registros se incrementa automáticamente a un entero largo único que no se puede cambiar.The field value for new records is automatically incremented to a unique long integer that cannot be changed. Solo se admite para las tablas de base de datos de Microsoft Jet.Only supported for Microsoft Jet database tables.
dbUpdatableField Se puede cambiar el valor del campo.The field value can be changed.
dbDescending El campo se ordena en orden descendente (Z-A o 100-0) (se aplica solo a un objeto de campo de una colección de campos de un objeto de índice).The field is sorted in descending (Z - A or 100 - 0) order (applies only to a Field object in a Fields collection of an Index object). Si omite esta constante, el campo se ordena en orden ascendente (A-Z o 0-100) (valor predeterminado).If you omit this constant, the field is sorted in ascending (A - Z or 0 - 100) order (default).

FieldInfofieldinfo
Referencia a una estructura cdaofieldinfo ( .A reference to a CDaoFieldInfo structure.

ObservacionesRemarks

DAOFieldSe crea un objeto (OLE) y se anexa a la colección Fields del DAOTableDef objeto (OLE).A DAOField (OLE) object is created and appended to the Fields collection of the DAOTableDef (OLE) object. Además de su uso para examinar las propiedades de objeto, también puede usar CDaoFieldInfo para construir un parámetro de entrada para crear nuevos campos en una definición de objetos.Besides its use for examining object properties, you can also use CDaoFieldInfo to construct an input parameter for creating new fields in a tabledef. La primera versión de CreateField es más fácil de usar, pero si desea un control más preciso, puede usar la segunda versión de CreateField , que toma un CDaoFieldInfo parámetro.The first version of CreateField is simpler to use, but if you want finer control, you can use the second version of CreateField, which takes a CDaoFieldInfo parameter.

Si usa la versión de CreateField que toma un CDaoFieldInfo parámetro, debe establecer cuidadosamente cada uno de los siguientes miembros de la CDaoFieldInfo estructura:If you use the version of CreateField that takes a CDaoFieldInfo parameter, you must carefully set each of the following members of the CDaoFieldInfo structure:

  • m_strName

  • m_nType

  • m_lSize

  • m_lAttributes

  • m_bAllowZeroLength

El resto de miembros de CDaoFieldInfo debe establecerse en 0, false o en una cadena vacía, según sea necesario para el miembro, o CDaoException puede producirse una excepción.The remaining members of CDaoFieldInfo should be set to 0, FALSE, or an empty string, as appropriate for the member, or a CDaoException may occur.

Para obtener información relacionada, vea el tema "método CreateField" en la ayuda de DAO.For related information, see the topic "CreateField Method" in DAO Help.

CDaoTableDef:: CreateIndexCDaoTableDef::CreateIndex

Llame a esta función para agregar un índice a una tabla.Call this function to add an index to a table.

void CreateIndex(CDaoIndexInfo& indexinfo);

ParámetrosParameters

indexinfoindexinfo
Referencia a una estructura cdaoindexinfo ( .A reference to a CDaoIndexInfo structure.

ObservacionesRemarks

Los índices especifican el orden de los registros a los que se obtiene acceso desde las tablas de base de datos y si se aceptan o no registros duplicados.Indexes specify the order of records accessed from database tables and whether or not duplicate records are accepted. Los índices también proporcionan un acceso eficaz a los datos.Indexes also provide efficient access to data.

No es necesario crear índices para las tablas, pero en las tablas grandes y sin indexar, el acceso a un registro específico o la creación de un conjunto de registros pueden tardar mucho tiempo.You do not have to create indexes for tables, but in large, unindexed tables, accessing a specific record or creating a recordset can take a long time. Por otro lado, la creación de demasiados índices reduce la velocidad de las operaciones de actualización, anexión y eliminación, ya que todos los índices se actualizan automáticamente.On the other hand, creating too many indexes slows down update, append, and delete operations as all indexes are automatically updated. Tenga en cuenta estos factores a medida que decida qué índices crear.Consider these factors as you decide which indexes to create.

Se deben establecer los siguientes miembros de la CDaoIndexInfo estructura:The following members of the CDaoIndexInfo structure must be set:

  • m_strName Se debe proporcionar un nombre.m_strName A name must be supplied.

  • m_pFieldInfos Debe apuntar a una matriz de CDaoIndexFieldInfo estructuras.m_pFieldInfos Must point to an array of CDaoIndexFieldInfo structures.

  • m_nFields Debe especificar el número de campos de la matriz de CDaoFieldInfo estructuras.m_nFields Must specify the number of fields in the array of CDaoFieldInfo structures.

Los miembros restantes se omitirán si se establece en FALSE.The remaining members will be ignored if set to FALSE. Además, el m_lDistinctCount miembro se omite durante la creación del índice.In addition, the m_lDistinctCount member is ignored during creation of the index.

CDaoTableDef::D eleteFieldCDaoTableDef::DeleteField

Llame a esta función miembro para quitar un campo y hacer que sea inaccesible.Call this member function to remove a field and make it inaccessible.

void DeleteField(LPCTSTR lpszName);
void DeleteField(int nIndex);

ParámetrosParameters

lpszNamelpszName
Un puntero a una expresión de cadena que es el nombre de un campo existente.A pointer to a string expression that is the name of an existing field.

nIndexnIndex
Índice del campo de la colección de campos de base cero de la tabla, para la búsqueda por índice.The index of the field in the table's zero-based Fields collection, for lookup by index.

ObservacionesRemarks

Puede utilizar esta función miembro en un nuevo objeto que no se haya anexado a la base de datos o cuando CanUpdate devuelva un valor distinto de cero.You can use this member function on a new object that has not been appended to the database or when CanUpdate returns nonzero.

Para obtener información relacionada, vea el tema "eliminar método" en la ayuda de DAO.For related information, see the topic "Delete Method" in DAO Help.

CDaoTableDef::D eleteIndexCDaoTableDef::DeleteIndex

Llame a esta función miembro para eliminar un índice de una tabla subyacente.Call this member function to delete an index in an underlying table.

void DeleteIndex(LPCTSTR lpszName);
void DeleteIndex(int nIndex);

ParámetrosParameters

lpszNamelpszName
Un puntero a una expresión de cadena que es el nombre de un índice existente.A pointer to a string expression that is the name of an existing index.

nIndexnIndex
Índice de matriz del objeto index de la colección TableDefs de base cero de la base de datos, para la búsqueda por índice.The array index of the index object in the database's zero-based TableDefs collection, for lookup by index.

ObservacionesRemarks

Puede utilizar esta función miembro en un nuevo objeto que no se haya anexado a la base de datos o cuando CanUpdate devuelva un valor distinto de cero.You can use this member function on a new object that hasn't been appended to the database or when CanUpdate returns nonzero.

Para obtener información relacionada, vea el tema "eliminar método" en la ayuda de DAO.For related information, see the topic "Delete Method" in DAO Help.

CDaoTableDef:: GetAttributesCDaoTableDef::GetAttributes

Para un CDaoTableDef objeto, el valor devuelto especifica las características de la tabla representada por el CDaoTableDef objeto y puede ser una suma de estas constantes:For a CDaoTableDef object, the return value specifies characteristics of the table represented by the CDaoTableDef object and can be a sum of these constants:

long GetAttributes();

Valor devueltoReturn Value

Devuelve un valor que indica una o más características de un CDaoTableDef objeto.Returns a value that indicates one or more characteristics of a CDaoTableDef object.

ObservacionesRemarks

ConstanteConstant DescripciónDescription
dbAttachExclusive En el caso de las bases de datos que usan el motor de base de datos de Microsoft Jet, indica que la tabla es una tabla adjunta abierta para uso exclusivo.For databases that use the Microsoft Jet database engine, indicates the table is an attached table opened for exclusive use.
dbAttachSavePWD En el caso de las bases de datos que usan el motor de base de datos de Microsoft Jet, indica que el ID. de usuario y la contraseña de la tabla adjunta se guardan con la información de conexión.For databases that use the Microsoft Jet database engine, indicates that the user ID and password for the attached table are saved with the connection information.
dbSystemObject Indica que la tabla es una tabla del sistema proporcionada por el motor de base de datos de Microsoft Jet.Indicates the table is a system table provided by the Microsoft Jet database engine.
dbHiddenObject Indica que la tabla es una tabla oculta proporcionada por el motor de base de datos de Microsoft Jet.Indicates the table is a hidden table provided by the Microsoft Jet database engine.
dbAttachedTable Indica que la tabla es una tabla adjunta de una base de datos que no es de ODBC, como una base de datos de Paradox.Indicates the table is an attached table from a non-ODBC database, such as a Paradox database.
dbAttachedODBC Indica que la tabla es una tabla adjunta de una base de datos ODBC, como Microsoft SQL Server.Indicates the table is an attached table from an ODBC database, such as Microsoft SQL Server.

Una tabla del sistema es una tabla creada por el motor de base de datos de Microsoft Jet para que contenga diversa información interna.A system table is a table created by the Microsoft Jet database engine to contain various internal information.

Una tabla oculta es una tabla creada para su uso temporal por el motor de base de datos de Microsoft Jet.A hidden table is a table created for temporary use by the Microsoft Jet database engine.

Para obtener información relacionada, vea el tema "propiedad Attributes" en la ayuda de DAO.For related information, see the topic "Attributes Property" in DAO Help.

CDaoTableDef:: GetConnectCDaoTableDef::GetConnect

Llame a esta función miembro para obtener la cadena de conexión de un origen de datos.Call this member function to obtain the connection string for a data source.

CString GetConnect();

Valor devueltoReturn Value

CStringObjeto que contiene la ruta de acceso y el tipo de base de datos de la tabla.A CString object containing the path and database type for the table.

ObservacionesRemarks

Para un CDaoTableDef objeto que representa una tabla adjunta, el CString objeto se compone de una o dos partes (un especificador de tipo de base de datos y una ruta de acceso a la base de datos).For a CDaoTableDef object that represents an attached table, the CString object consists of one or two parts (a database type specifier and a path to the database).

La ruta de acceso tal como se muestra en la tabla siguiente es la ruta de acceso completa del directorio que contiene los archivos de base de datos y debe ir precedida del identificador "DATABASE =".The path as shown in the table below is the full path for the directory containing the database files and must be preceded by the identifier "DATABASE=". En algunos casos (al igual que con las bases de datos de Microsoft Jet y Microsoft Excel), se incluye un nombre de archivo específico en el argumento de ruta de acceso de la base de datos.In some cases (as with Microsoft Jet and Microsoft Excel databases), a specific filename is included in the database path argument.

La tabla de CDaoTableDef:: SetConnect muestra los tipos de base de datos posibles y sus correspondientes especificadores de base de datos y rutas de acceso:The table in CDaoTableDef::SetConnect shows possible database types and their corresponding database specifiers and paths:

En el caso de las tablas base de base de datos de Microsoft Jet, el especificador es una cadena vacía ("").For Microsoft Jet database base tables, the specifier is a empty string ("").

Si se requiere una contraseña, pero no se proporciona, el controlador ODBC muestra un cuadro de diálogo de inicio de sesión la primera vez que se tiene acceso a una tabla y de nuevo si la conexión se cierra y se vuelve a abrir.If a password is required but not provided, the ODBC driver displays a login dialog box the first time a table is accessed and again if the connection is closed and reopened. Si una tabla adjunta tiene el dbAttachSavePWD atributo, la solicitud de inicio de sesión no aparecerá cuando se vuelva a abrir la tabla.If an attached table has the dbAttachSavePWD attribute, the login prompt will not appear when the table is reopened.

Para obtener información relacionada, vea el tema "propiedad de conexión" en la ayuda de DAO.For related information, see the topic "Connect Property" in DAO Help.

CDaoTableDef:: GetDateCreatedCDaoTableDef::GetDateCreated

Llame a esta función para determinar la fecha y hora en que se creó la tabla subyacente del CDaoTableDef objeto.Call this function to determine the date and time the table underlying the CDaoTableDef object was created.

COleDateTime GetDateCreated();

Valor devueltoReturn Value

Valor que contiene la fecha y hora de creación de la tabla subyacente al CDaoTableDef objeto.A value containing the date and time of the creation of the table underlying the CDaoTableDef object.

ObservacionesRemarks

La configuración de fecha y hora se deriva del equipo en el que se creó o actualizó por última vez la tabla base.The date and time settings are derived from the computer on which the base table was created or last updated. En un entorno multiusuario, los usuarios deben obtener esta configuración directamente desde el servidor de archivos para evitar discrepancias. es decir, todos los clientes deben usar un origen de hora "estándar", quizás de un servidor.In a multiuser environment, users should get these settings directly from the file server to avoid discrepancies; that is, all clients should use a "standard" time source — perhaps from one server.

Para obtener información relacionada, vea el tema "DateCreated, propiedades de LastUpdated" en la ayuda de DAO.For related information, see the topic "DateCreated, LastUpdated Properties" in DAO Help.

CDaoTableDef:: GetDateLastUpdatedCDaoTableDef::GetDateLastUpdated

Llame a esta función para determinar la fecha y hora en que CDaoTableDef se actualizó por última vez la tabla subyacente del objeto.Call this function to determine the date and time the table underlying the CDaoTableDef object was last updated.

COleDateTime GetDateLastUpdated();

Valor devueltoReturn Value

Valor que contiene la fecha y hora en que CDaoTableDef se actualizó por última vez la tabla subyacente del objeto.A value that contains the date and time the table underlying the CDaoTableDef object was last updated.

ObservacionesRemarks

La configuración de fecha y hora se deriva del equipo en el que se creó o actualizó por última vez la tabla base.The date and time settings are derived from the computer on which the base table was created or last updated. En un entorno multiusuario, los usuarios deben obtener esta configuración directamente desde el servidor de archivos para evitar discrepancias. es decir, todos los clientes deben usar un origen de hora "estándar", quizás de un servidor.In a multiuser environment, users should get these settings directly from the file server to avoid discrepancies; that is, all clients should use a "standard" time source — perhaps from one server.

Para obtener información relacionada, vea el tema "DateCreated, propiedades de LastUpdated" en la ayuda de DAO.For related information, see the topic "DateCreated, LastUpdated Properties" in DAO Help.

CDaoTableDef:: GetFieldCountCDaoTableDef::GetFieldCount

Llame a esta función miembro para recuperar el número de campos definidos en la tabla.Call this member function to retrieve the number of fields defined in the table.

short GetFieldCount();

Valor devueltoReturn Value

Número de campos de la tabla.The number of fields in the table.

ObservacionesRemarks

Si su valor es 0, no hay ningún objeto en la colección.If its value is 0, there are no objects in the collection.

Para obtener información relacionada, vea el tema "propiedad Count" en la ayuda de DAO.For related information, see the topic "Count Property" in DAO Help.

CDaoTableDef:: GetFieldInfoCDaoTableDef::GetFieldInfo

Llame a esta función miembro para obtener varios tipos de información sobre un campo definido en la definición de tipo.Call this member function to obtain various kinds of information about a field defined in the tabledef.

void GetFieldInfo(
    int nIndex,
    CDaoFieldInfo& fieldinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

void GetFieldInfo(
    LPCTSTR lpszName,
    CDaoFieldInfo& fieldinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

ParámetrosParameters

nIndexnIndex
Índice del objeto de campo en la colección de campos de base cero de la tabla, para la búsqueda por índice.The index of the field object in the table's zero-based Fields collection, for lookup by index.

FieldInfofieldinfo
Referencia a una estructura cdaofieldinfo ( .A reference to a CDaoFieldInfo structure.

dwInfoOptionsdwInfoOptions
Opciones que especifican la información sobre el campo que se va a recuperar.Options that specify which information about the field to retrieve. Aquí se enumeran las opciones disponibles junto con lo que hacen que la función devuelva:The available options are listed here along with what they cause the function to return:

  • AFX_DAO_PRIMARY_INFO Predeterminada Nombre, tipo, tamaño, atributos.AFX_DAO_PRIMARY_INFO (Default) Name, Type, Size, Attributes. Use esta opción para obtener un rendimiento más rápido.Use this option for fastest performance.

  • AFX_DAO_SECONDARY_INFO Información principal, más: posición ordinal, requerida, Permitir longitud cero, orden de intercalación, nombre externo, campo de origen, tabla de origenAFX_DAO_SECONDARY_INFO Primary information, plus: Ordinal Position, Required, Allow Zero Length, Collating Order, Foreign Name, Source Field, Source Table

  • AFX_DAO_ALL_INFO Información principal y secundaria, más: regla de validación, texto de validación, valor predeterminadoAFX_DAO_ALL_INFO Primary and secondary information, plus: Validation Rule, Validation Text, Default Value

lpszNamelpszName
Puntero al nombre del objeto de campo, para buscar por nombre.A pointer to the name of the field object, for lookup by name. El nombre es una cadena con un máximo de 64 caracteres que nombra el campo de forma única.The name is a string with up to 64 characters that uniquely names the field.

ObservacionesRemarks

Una versión de la función permite buscar un campo por índice.One version of the function lets you look up a field by index. La otra versión permite buscar un campo por nombre.The other version lets you look up a field by name.

Para obtener una descripción de la información devuelta, consulte la estructura cdaofieldinfo ( .For a description of the information returned, see the CDaoFieldInfo structure. Esta estructura tiene miembros que corresponden a los elementos de la información enumerados anteriormente en la descripción de dwInfoOptions.This structure has members that correspond to the items of information listed above in the description of dwInfoOptions. Cuando se solicita información en un nivel, también se obtiene información sobre cualquier nivel anterior.When you request information at one level, you get information for any prior levels as well.

Para obtener información relacionada, vea el tema "propiedad Attributes" en la ayuda de DAO.For related information, see the topic "Attributes Property" in DAO Help.

CDaoTableDef:: GetIndexCountCDaoTableDef::GetIndexCount

Llame a esta función miembro para obtener el número de índices de una tabla.Call this member function to obtain the number of indexes for a table.

short GetIndexCount();

Valor devueltoReturn Value

Número de índices de la tabla.The number of indexes for the table.

ObservacionesRemarks

Si su valor es 0, no hay ningún índice en la colección.If its value is 0, there are no indexes in the collection.

Para obtener información relacionada, vea el tema "propiedad Count" en la ayuda de DAO.For related information, see the topic "Count Property" in DAO Help.

CDaoTableDef:: GetIndexInfoCDaoTableDef::GetIndexInfo

Llame a esta función miembro para obtener varios tipos de información sobre un índice definido en la definición de tipo.Call this member function to obtain various kinds of information about an index defined in the tabledef.

void GetIndexInfo(
    int nIndex,
    CDaoIndexInfo& indexinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

void GetIndexInfo(
    LPCTSTR lpszName,
    CDaoIndexInfo& indexinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

ParámetrosParameters

nIndexnIndex
Índice numérico del objeto index de la colección de índices de base cero de la tabla, para la búsqueda por su posición en la colección.The numeric index of the Index object in the table's zero-based Indexes collection, for lookup by its position in the collection.

indexinfoindexinfo
Referencia a una estructura cdaoindexinfo ( .A reference to a CDaoIndexInfo structure.

dwInfoOptionsdwInfoOptions
Opciones que especifican qué información sobre el índice se va a recuperar.Options that specify which information about the index to retrieve. Aquí se enumeran las opciones disponibles junto con lo que hacen que la función devuelva:The available options are listed here along with what they cause the function to return:

  • AFX_DAO_PRIMARY_INFO Nombre, información de campo, campos.AFX_DAO_PRIMARY_INFO Name, Field Info, Fields. Use esta opción para obtener un rendimiento más rápido.Use this option for fastest performance.

  • AFX_DAO_SECONDARY_INFO Información principal, más: principal, único, agrupado, omitir valores NULL, requerido, externoAFX_DAO_SECONDARY_INFO Primary information, plus: Primary, Unique, Clustered, Ignore Nulls, Required, Foreign

  • AFX_DAO_ALL_INFO Información principal y secundaria, más: recuento distintivoAFX_DAO_ALL_INFO Primary and secondary information, plus: Distinct Count

lpszNamelpszName
Puntero al nombre del objeto de índice, para la búsqueda por nombre.A pointer to the name of the index object, for lookup by name.

ObservacionesRemarks

Una versión de la función permite buscar un índice por su posición en la colección.One version of the function lets you look up an index by its position in the collection. La otra versión permite buscar un índice por nombre.The other version lets you look up an index by name.

Para obtener una descripción de la información devuelta, consulte la estructura cdaoindexinfo ( .For a description of the information returned, see the CDaoIndexInfo structure. Esta estructura tiene miembros que corresponden a los elementos de la información enumerados anteriormente en la descripción de dwInfoOptions.This structure has members that correspond to the items of information listed above in the description of dwInfoOptions. Cuando se solicita información en un nivel, también se obtiene información sobre cualquier nivel anterior.When you request information at one level, you get information for any prior levels as well.

Para obtener información relacionada, vea el tema "propiedad Attributes" en la ayuda de DAO.For related information, see the topic "Attributes Property" in DAO Help.

CDaoTableDef:: GetNameCDaoTableDef::GetName

Llame a esta función miembro para obtener el nombre definido por el usuario de la tabla subyacente.Call this member function to obtain the user-defined name of the underlying table.

CString GetName();

Valor devueltoReturn Value

Nombre definido por el usuario para una tabla.A user-defined name for a table.

ObservacionesRemarks

Este nombre empieza por una letra y puede contener un máximo de 64 caracteres.This name starts with a letter and can contain a maximum of 64 characters. Puede incluir números y caracteres de subrayado, pero no puede incluir signos de puntuación ni espacios.It can include numbers and underscore characters but cannot include punctuation or spaces.

Para obtener información relacionada, vea el tema "propiedad de nombre" en la ayuda de DAO.For related information, see the topic "Name Property" in DAO Help.

CDaoTableDef:: GetRecordCountCDaoTableDef::GetRecordCount

Llame a esta función miembro para averiguar el número de registros que hay en un CDaoTableDef objeto.Call this member function to find out how many records are in a CDaoTableDef object.

long GetRecordCount();

Valor devueltoReturn Value

Número de registros a los que se tiene acceso en un objeto TableDef.The number of records accessed in a tabledef object.

ObservacionesRemarks

La llamada a GetRecordCount para un objeto de tipo de tabla CDaoTableDef refleja el número aproximado de registros de la tabla y se ve afectado inmediatamente a medida que se agregan y eliminan registros de tabla.Calling GetRecordCount for a table-type CDaoTableDef object reflects the approximate number of records in the table and is affected immediately as table records are added and deleted. Las transacciones revertidas aparecerán como parte del número de registros hasta que se llame a CDaoWorkSpace:: CompactDatabase.Rolled back transactions will appear as part of the record count until you call CDaoWorkSpace::CompactDatabase. Un CDaoTableDef objeto sin registros tiene un valor de la propiedad recuento de registros de 0.A CDaoTableDef object with no records has a record count property setting of 0. Cuando se trabaja con tablas o bases de datos ODBC asociadas, GetRecordCount siempre devuelve-1.When working with attached tables or ODBC databases, GetRecordCount always returns -1.

Para obtener información relacionada, vea el tema "propiedad RecordCount" en la ayuda de DAO.For related information, see the topic "RecordCount Property" in DAO Help.

CDaoTableDef:: GetSourceTableNameCDaoTableDef::GetSourceTableName

Llame a esta función miembro para recuperar el nombre de una tabla adjunta en una base de datos de origen.Call this member function to retrieve the name of an attached table in a source database.

CString GetSourceTableName();

Valor devueltoReturn Value

CStringObjeto que especifica el nombre de origen de una tabla adjunta, o una cadena vacía si se trata de una tabla de datos nativa.A CString object that specifies the source name of an attached table, or an empty string if a native data table.

ObservacionesRemarks

Una tabla adjunta es una tabla de otra base de datos vinculada a una base de datos de Microsoft Jet.An attached table is a table in another database linked to a Microsoft Jet database. Los datos de las tablas asociadas permanecen en la base de datos externa, donde pueden ser manipulados por otras aplicaciones.Data for attached tables remains in the external database, where it can be manipulated by other applications.

Para obtener información relacionada, vea el tema "propiedad SourceTableName" en la ayuda de DAO.For related information, see the topic "SourceTableName Property" in DAO Help.

CDaoTableDef:: GetValidationRuleCDaoTableDef::GetValidationRule

Llame a esta función miembro para recuperar la regla de validación para una definición de usuario.Call this member function to retrieve the validation rule for a tabledef.

CString GetValidationRule();

Valor devueltoReturn Value

CStringObjeto que valida los datos de un campo a medida que se cambian o se agregan a una tabla.A CString object that validates the data in a field as it is changed or added to a table.

ObservacionesRemarks

Las reglas de validación se usan en relación con las operaciones de actualización.Validation rules are used in connection with update operations. Si un TableDef contiene una regla de validación, las actualizaciones de ese TableDef deben coincidir con los criterios predeterminados antes de que se cambien los datos.If a tabledef contains a validation rule, updates to that tabledef must match predetermined criteria before the data is changed. Si el cambio no coincide con los criterios, se produce una excepción que contiene el valor de GetValidationText .If the change does not match the criteria, an exception containing the value of GetValidationText is thrown. Para un CDaoTableDef objeto, CString es de solo lectura para una tabla adjunta y de lectura/escritura para una tabla base.For a CDaoTableDef object, this CString is read-only for an attached table and read/write for a base table.

Para obtener información relacionada, vea el tema "propiedad ValidationRule" en la ayuda de DAO.For related information, see the topic "ValidationRule Property" in DAO Help.

CDaoTableDef:: GetValidationTextCDaoTableDef::GetValidationText

Llame a esta función para recuperar la cadena que se va a mostrar cuando un usuario escriba datos que no coincidan con la regla de validación.Call this function to retrieve the string to display when a user enters data that does not match the validation rule.

CString GetValidationText();

Valor devueltoReturn Value

CStringObjeto que especifica el texto que se muestra si el usuario escribe datos que no coinciden con la regla de validación.A CString object that specifies the text displayed if the user enters data that does not match the validation rule.

ObservacionesRemarks

Para un CDaoTableDef objeto, CString es de solo lectura para una tabla adjunta y de lectura/escritura para una tabla base.For a CDaoTableDef object, this CString is read-only for an attached table and read/write for a base table.

Para obtener información relacionada, vea el tema "propiedad ValidationText" en la ayuda de DAO.For related information, see the topic "ValidationText Property" in DAO Help.

CDaoTableDef:: IsOpenCDaoTableDef::IsOpen

Llame a esta función miembro para determinar si el CDaoTableDef objeto está abierto actualmente.Call this member function to determine whether the CDaoTableDef object is currently open.

BOOL IsOpen() const;

Valor devueltoReturn Value

Es distinto de cero si el CDaoTableDef objeto está abierto; de lo contrario, es 0.Nonzero if the CDaoTableDef object is open; otherwise 0.

ObservacionesRemarks

CDaoTableDef:: m_pDatabaseCDaoTableDef::m_pDatabase

Contiene un puntero al objeto CDaoDatabase de esta tabla.Contains a pointer to the CDaoDatabase object for this table.

ObservacionesRemarks

CDaoTableDef:: m_pDAOTableDefCDaoTableDef::m_pDAOTableDef

Contiene un puntero a la interfaz OLE para el objeto DAO TableDef subyacente al CDaoTableDef objeto.Contains a pointer to the OLE interface for the DAO tabledef object underlying the CDaoTableDef object.

ObservacionesRemarks

Utilice este puntero si necesita tener acceso a la interfaz de DAO directamente.Use this pointer if you need to access the DAO interface directly.

CDaoTableDef:: OpenCDaoTableDef::Open

Llame a esta función miembro para abrir un TableDef guardado previamente en la colección TableDef's de la base de datos.Call this member function to open a tabledef previously saved in the database's TableDef's collection.

virtual void Open(LPCTSTR lpszName);

ParámetrosParameters

lpszNamelpszName
Puntero a una cadena que especifica un nombre de tabla.A pointer to a string that specifies a table name.

ObservacionesRemarks

Llame a esta función miembro para actualizar la información de conexión de una tabla adjunta.Call this member function to update the connection information for an attached table.

void RefreshLink();

ObservacionesRemarks

Para cambiar la información de conexión de una tabla adjunta, llame a SetConnect en el CDaoTableDef objeto correspondiente y, a continuación, utilice la RefreshLink función miembro para actualizar la información.You change the connection information for an attached table by calling SetConnect on the corresponding CDaoTableDef object and then using the RefreshLink member function to update the information. Cuando se llama a RefreshLink , no se cambian las propiedades de la tabla adjunta.When you call RefreshLink, the attached table's properties are not changed.

Para forzar que la información de conexión modificada surta efecto, deben cerrarse todos los objetos CDaoRecordset abiertos basados en este objeto TableDef.To force the modified connect information to take effect, all open CDaoRecordset objects based on this tabledef must be closed.

Para obtener información relacionada, vea el tema sobre el método RefreshLink en la ayuda de DAO.For related information, see the topic "RefreshLink Method" in DAO Help.

CDaoTableDef:: SetAttributesCDaoTableDef::SetAttributes

Establece un valor que indica una o más características de un CDaoTableDef objeto.Sets a value that indicates one or more characteristics of a CDaoTableDef object.

void SetAttributes(long lAttributes);

ParámetrosParameters

lAttributeslAttributes
Características de la tabla representada por el CDaoTableDef objeto y pueden ser una suma de estas constantes:Characteristics of the table represented by the CDaoTableDef object and can be a sum of these constants:

ConstanteConstant DescripciónDescription
dbAttachExclusive En el caso de las bases de datos que usan el motor de base de datos de Microsoft Jet, indica que la tabla es una tabla adjunta abierta para uso exclusivo.For databases that use the Microsoft Jet database engine, indicates the table is an attached table opened for exclusive use.
dbAttachSavePWD En el caso de las bases de datos que usan el motor de base de datos de Microsoft Jet, indica que el ID. de usuario y la contraseña de la tabla adjunta se guardan con la información de conexión.For databases that use the Microsoft Jet database engine, indicates that the user ID and password for the attached table are saved with the connection information.
dbSystemObject Indica que la tabla es una tabla del sistema proporcionada por el motor de base de datos de Microsoft Jet.Indicates the table is a system table provided by the Microsoft Jet database engine.
dbHiddenObject Indica que la tabla es una tabla oculta proporcionada por el motor de base de datos de Microsoft Jet.Indicates the table is a hidden table provided by the Microsoft Jet database engine.

ObservacionesRemarks

Al establecer varios atributos, puede combinarlos mediante la suma de las constantes adecuadas mediante el operador OR bit a bit.When setting multiple attributes, you can combine them by summing the appropriate constants using the bitwise-OR operator. dbAttachExclusiveLa configuración de en una tabla no adjunta produce una excepción.Setting dbAttachExclusive on a nonattached table produces an exception. La combinación de los siguientes valores también produce una excepción:Combining the following values also produce an exception:

  • dbAttachExclusive | dbAttachedODBCdbAttachExclusive | dbAttachedODBC

  • dbAttachSavePWD | dbAttachedTabledbAttachSavePWD | dbAttachedTable

Para obtener información relacionada, vea el tema "propiedad Attributes" en la ayuda de DAO.For related information, see the topic "Attributes Property" in DAO Help.

CDaoTableDef:: SetConnectCDaoTableDef::SetConnect

Para un CDaoTableDef objeto que representa una tabla adjunta, el objeto de cadena se compone de una o dos partes (un especificador de tipo de base de datos y una ruta de acceso a la base de datos).For a CDaoTableDef object that represents an attached table, the string object consists of one or two parts (a database type specifier and a path to the database).

void SetConnect(LPCTSTR lpszConnect);

ParámetrosParameters

lpszConnectlpszConnect
Puntero a una expresión de cadena que especifica los parámetros adicionales que se van a pasar a los controladores de ODBC o ISAM instalables.A pointer to a string expression that specifies additional parameters to pass to ODBC or installable ISAM drivers.

ObservacionesRemarks

La ruta de acceso tal como se muestra en la tabla siguiente es la ruta de acceso completa del directorio que contiene los archivos de base de datos y debe ir precedida del identificador "DATABASE =".The path as shown in the table below is the full path for the directory containing the database files and must be preceded by the identifier "DATABASE=". En algunos casos (al igual que con las bases de datos de Microsoft Jet y Microsoft Excel), se incluye un nombre de archivo específico en el argumento de ruta de acceso de la base de datos.In some cases (as with Microsoft Jet and Microsoft Excel databases), a specific filename is included in the database path argument.

Nota

No incluya espacios en blanco en las instrucciones de la ruta de acceso de signo igual de la forma "base de datos = unidad: \ \ruta".Do not include whitespace around the equal sign in path statements of the form "DATABASE=drive:\\path". Esto producirá una excepción y se producirá un error en la conexión.This will result in an exception being thrown and the connection failing.

En la tabla siguiente se muestran los posibles tipos de base de datos y sus especificadores y rutas de acceso de base de datos correspondientes:The following table shows possible database types and their corresponding database specifiers and paths:

Tipo de base de datosDatabase type EspecificadorSpecifier Ruta de accesoPath
Base de datos que usa el motor de base de datos JetDatabase using the Jet database engine "[ database];""[ database];" " drive : \ \ ruta de acceso del \ \ nombre de archivo. MDB" drive:\\ path\\ filename.MDB"
dBASE IIIdBASE III "dBASE III;""dBASE III;" " drive : \ \ ruta de acceso"" drive:\\ path"
dBASE IVdBASE IV "dBASE IV;""dBASE IV;" " drive : \ \ ruta de acceso"" drive:\\ path"
dBASE 5dBASE 5 "dBASE 5,0;""dBASE 5.0;" " drive : \ \ ruta de acceso"" drive:\\ path"
Paradox 3. xParadox 3.x "Paradox 3. x;""Paradox 3.x;" " drive : \ \ ruta de acceso"" drive:\\ path"
Paradox 4. xParadox 4.x "Paradox 4. x;""Paradox 4.x;" " drive : \ \ ruta de acceso"" drive:\\ path"
Paradox 5. xParadox 5.x "Paradox 5. x;""Paradox 5.x;" " drive : \ \ ruta de acceso"" drive:\\ path"
Excel 3,0Excel 3.0 "Excel 3,0;""Excel 3.0;" " drive : \ \ ruta de acceso del \ \ nombre de archivo. VACÍO" drive:\\ path\\ filename.XLS"
Excel 4,0Excel 4.0 "Excel 4,0;""Excel 4.0;" " drive : \ \ ruta de acceso del \ \ nombre de archivo. VACÍO" drive:\\ path\\ filename.XLS"
Excel 5,0 o Excel 95Excel 5.0 or Excel 95 "Excel 5,0;""Excel 5.0;" " drive : \ \ ruta de acceso del \ \ nombre de archivo. VACÍO" drive:\\ path\\ filename.XLS"
Excel 97Excel 97 "Excel 8,0;""Excel 8.0;" " drive : \ \ ruta de acceso del \ nombre de archivo. VACÍO" drive:\\ path\ filename.XLS"
Importación de HTMLHTML Import "Importación de HTML""HTML Import;" " drive : \ \ path \ nombreDeArchivo"" drive:\\ path\ filename"
Exportación de HTMLHTML Export "Exportación de HTML""HTML Export;" " drive : \ \ ruta de acceso"" drive:\\ path"
TextoText "Text;""Text;" "unidad: \ \ruta""drive:\\path"
ODBCODBC OBDC BASE de datos = database ; UID = usuario; PWD = contraseña; DSN = datasourcename; LOGINTIMEOUT = segundos;" (Puede que no sea una cadena de conexión completa para todos los servidores; es solo un ejemplo."ODBC; DATABASE= database; UID= user;PWD= password; DSN= datasourcename; LOGINTIMEOUT= seconds;" (This may not be a complete connection string for all servers; it is just an example. Es muy importante no tener espacios entre los parámetros).It is very important not to have spaces between the parameters.) NingunoNone
ExchangeExchange Cambio"Exchange;

MAPILEVEL = folderPath;MAPILEVEL= folderpath;

[TABLETYPE = {0 | 1};][TABLETYPE={ 0 | 1 };]

[PROFILE = perfil;][PROFILE= profile;]

[PWD = contraseña;][PWD= password;]

[DATABASE = database ;] "[DATABASE= database;]"
"unidad: \ \ ruta de acceso del \ \ nombre de archivo. MDB"drive:\\ path\\ filename.MDB"

Nota

Ya no se admite Btrieve desde DAO 3,5.Btrieve is no longer supported as of DAO 3.5.

Debe utilizar una doble barra diagonal inversa ( \ \ ) en las cadenas de conexión.You must use a double backslash (\\) in the connection strings. Si ha modificado las propiedades de una conexión existente mediante SetConnect , debe llamar a RefreshLink.If you have modified the properties of an existing connection using SetConnect, you must subsequently call RefreshLink. Si va a inicializar las propiedades de conexión mediante SetConnect , no es necesario llamar a RefreshLink , pero si decide hacerlo, anexe primero el objeto TableDef.If you are initializing the connection properties using SetConnect, you need not call RefreshLink, but should you choose to do so, first append the tabledef.

Si se requiere una contraseña, pero no se proporciona, el controlador ODBC muestra un cuadro de diálogo de inicio de sesión la primera vez que se tiene acceso a una tabla y de nuevo si la conexión se cierra y se vuelve a abrir.If a password is required but not provided, the ODBC driver displays a login dialog box the first time a table is accessed and again if the connection is closed and reopened.

Puede establecer la cadena de conexión para un CDaoTableDef objeto proporcionando un argumento de origen a la Create función miembro.You can set the connection string for a CDaoTableDef object by providing a source argument to the Create member function. Puede comprobar la configuración para determinar el tipo, la ruta de acceso, el ID. de usuario, la contraseña o el origen de datos ODBC de la base de datos.You can check the setting to determine the type, path, user ID, password, or ODBC data source of the database. Para obtener más información, consulte la documentación del controlador específico.For more information, see the documentation for the specific driver.

Para obtener información relacionada, vea el tema "propiedad de conexión" en la ayuda de DAO.For related information, see the topic "Connect Property" in DAO Help.

CDaoTableDef:: SetNameCDaoTableDef::SetName

Llame a esta función miembro para establecer un nombre definido por el usuario para una tabla.Call this member function to set a user-defined name for a table.

void SetName(LPCTSTR lpszName);

ParámetrosParameters

lpszNamelpszName
Puntero a una expresión de cadena que especifica el nombre de una tabla.A pointer to a string expression that specifies a name for a table.

ObservacionesRemarks

El nombre debe empezar por una letra y puede contener un máximo de 64 caracteres.The name must start with a letter and can contain a maximum of 64 characters. Puede incluir números y caracteres de subrayado, pero no puede incluir signos de puntuación ni espacios.It can include numbers and underscore characters but cannot include punctuation or spaces.

Para obtener información relacionada, vea el tema "propiedad de nombre" en la ayuda de DAO.For related information, see the topic "Name Property" in DAO Help.

CDaoTableDef:: SetSourceTableNameCDaoTableDef::SetSourceTableName

Llame a esta función miembro para especificar el nombre de una tabla adjunta o el nombre de la tabla base en la que CDaoTableDef se basa el objeto, tal como existe en el origen inicial de los datos.Call this member function to specify the name of an attached table or the name of the base table on which the CDaoTableDef object is based, as it exists in the original source of the data.

void SetSourceTableName(LPCTSTR lpszSrcTableName);

ParámetrosParameters

lpszSrcTableNamelpszSrcTableName
Un puntero a una expresión de cadena que especifica un nombre de tabla en la base de datos externa.A pointer to a string expression that specifies a table name in the external database. En el caso de una tabla base, el valor es una cadena vacía ("").For a base table, the setting is an empty string ("").

ObservacionesRemarks

A continuación, debe llamar a RefreshLink.You must then call RefreshLink. Esta configuración de propiedad está vacía para una tabla base y de lectura y escritura para una tabla adjunta o un objeto no anexado a una colección.This property setting is empty for a base table and read/write for an attached table or an object not appended to a collection.

Para obtener información relacionada, vea el tema "propiedad SourceTableName" en la ayuda de DAO.For related information, see the topic "SourceTableName Property" in DAO Help.

CDaoTableDef:: SetValidationRuleCDaoTableDef::SetValidationRule

Llame a esta función miembro para establecer una regla de validación para una definición de grupo.Call this member function to set a validation rule for a tabledef.

void SetValidationRule(LPCTSTR lpszValidationRule);

ParámetrosParameters

lpszValidationRulelpszValidationRule
Un puntero a una expresión de cadena que valida una operación.A pointer to a string expression that validates an operation.

ObservacionesRemarks

Las reglas de validación se usan en relación con las operaciones de actualización.Validation rules are used in connection with update operations. Si un TableDef contiene una regla de validación, las actualizaciones de ese TableDef deben coincidir con los criterios predeterminados antes de que se cambien los datos.If a tabledef contains a validation rule, updates to that tabledef must match predetermined criteria before the data is changed. Si el cambio no coincide con los criterios, se muestra una excepción que contiene el texto de GetValidationText .If the change does not match the criteria, an exception containing the text of GetValidationText is displayed.

La validación solo se admite para las bases de datos que usan el motor de base de datos de Microsoft Jet.Validation is supported only for databases that use the Microsoft Jet database engine. La expresión no puede hacer referencia a funciones definidas por el usuario, funciones de agregado de dominio, funciones de agregado de SQL o consultas.The expression cannot refer to user-defined functions, domain aggregate functions, SQL aggregate functions, or queries. Una regla de validación para un CDaoTableDef objeto puede hacer referencia a varios campos de ese objeto.A validation rule for a CDaoTableDef object can refer to multiple fields in that object.

Por ejemplo, para los campos denominados hire_date y termination_date, una regla de validación podría ser:For example, for fields named hire_date and termination_date, a validation rule might be:

myTableDef.SetValidationRule(_T("termination_date > hire_date"));

Para obtener información relacionada, vea el tema "propiedad ValidationRule" en la ayuda de DAO.For related information, see the topic "ValidationRule Property" in DAO Help.

CDaoTableDef:: SetValidationTextCDaoTableDef::SetValidationText

Llame a esta función miembro para establecer el texto de la excepción de una regla de validación para un CDaoTableDef objeto con una tabla base subyacente compatible con el motor de base de datos de Microsoft Jet.Call this member function to set the exception text of a validation rule for a CDaoTableDef object with an underlying base table supported by the Microsoft Jet database engine.

void SetValidationText(LPCTSTR lpszValidationText);

ParámetrosParameters

lpszValidationTextlpszValidationText
Un puntero a una expresión de cadena que especifica el texto que se muestra si los datos especificados no son válidos.A pointer to a string expression that specifies the text displayed if entered data is invalid.

ObservacionesRemarks

No se puede establecer el texto de validación de una tabla adjunta.You cannot set the validation text of an attached table.

Para obtener información relacionada, vea el tema "propiedad ValidationText" en la ayuda de DAO.For related information, see the topic "ValidationText Property" in DAO Help.

Consulta tambiénSee also

CObject (clase)CObject Class
Gráfico de jerarquíaHierarchy Chart
CDaoDatabase (clase)CDaoDatabase Class
CDaoRecordset (clase)CDaoRecordset Class