Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

DataTable (Clase)

Representa una tabla de datos en memoria.

Espacio de nombres:  System.Data
Ensamblado:  System.Data (en System.Data.dll)
[SerializableAttribute]
public class DataTable : MarshalByValueComponent, IListSource, 
	ISupportInitializeNotification, ISupportInitialize, ISerializable, IXmlSerializable

El tipo DataTable expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con XNA FrameworkDataTable()Inicializa una nueva instancia de la clase DataTable sin argumentos.
Método públicoCompatible con XNA FrameworkDataTable(String)Inicializa una nueva instancia de la clase DataTable con el nombre de tabla especificado.
Método protegidoDataTable(SerializationInfo, StreamingContext)Inicializa una nueva instancia de la clase DataTable con el objeto SerializationInfo y la estructura StreamingContext.
Método públicoCompatible con XNA FrameworkDataTable(String, String)Inicializa una nueva instancia de la clase DataTable utilizando el nombre de tabla y el espacio de nombres especificados.
Arriba
  NombreDescripción
Propiedad públicaCompatible con XNA FrameworkCaseSensitiveIndica si las comparaciones de cadenas en la tabla distinguen entre mayúsculas y minúsculas.
Propiedad públicaCompatible con XNA FrameworkChildRelationsObtiene la colección de relaciones secundarias para este DataTable.
Propiedad públicaCompatible con XNA FrameworkColumnsObtiene la colección de columnas que pertenecen a esta tabla.
Propiedad públicaCompatible con XNA FrameworkConstraintsObtiene la colección de restricciones mantenidas por esta tabla.
Propiedad públicaCompatible con XNA FrameworkContainerObtiene el contenedor del componente. (Se hereda de MarshalByValueComponent).
Propiedad públicaCompatible con XNA FrameworkDataSetObtiene el objeto DataSet al que pertenece esta tabla.
Propiedad públicaCompatible con XNA FrameworkDefaultViewObtiene una vista personalizada de la tabla que puede incluir una vista filtrada o una posición del cursor.
Propiedad públicaCompatible con XNA FrameworkDesignModeObtiene un valor que indica si el componente está actualmente en modo de diseño. (Se hereda de MarshalByValueComponent).
Propiedad públicaCompatible con XNA FrameworkDisplayExpressionObtiene o establece la expresión que devuelve un valor utilizado para representar esta tabla en la interfaz de usuario. La propiedad DisplayExpression permite mostrar el nombre de esta tabla en una interfaz de usuario.
Propiedad protegidaCompatible con XNA FrameworkEventsObtiene la lista de controladores de eventos asociados a este componente. (Se hereda de MarshalByValueComponent).
Propiedad públicaCompatible con XNA FrameworkExtendedPropertiesObtiene la colección de información personalizada del usuario.
Propiedad públicaCompatible con XNA FrameworkHasErrorsObtiene un valor que indica si hay errores en cualquier fila de cualquier tabla del DataSet al que pertenece la tabla.
Propiedad públicaCompatible con XNA FrameworkIsInitializedObtiene un valor que indica si el objeto DataTable está inicializado.
Propiedad públicaCompatible con XNA FrameworkLocaleObtiene o establece la información de configuración regional que se utiliza para comparar cadenas de la tabla.
Propiedad públicaCompatible con XNA FrameworkMinimumCapacityObtiene o establece el tamaño inicial para esta tabla.
Propiedad públicaCompatible con XNA FrameworkNamespaceObtiene o establece el espacio de nombres para la representación XML de los datos almacenados en el objeto DataTable.
Propiedad públicaCompatible con XNA FrameworkParentRelationsObtiene la colección de relaciones primarias para este DataTable.
Propiedad públicaCompatible con XNA FrameworkPrefixObtiene o establece el espacio de nombres para la representación XML de los datos almacenados en el objeto DataTable.
Propiedad públicaCompatible con XNA FrameworkPrimaryKeyObtiene o establece una matriz de columnas que funcionan como claves principales para la tabla de datos.
Propiedad públicaRemotingFormatObtiene o establece el formato de serialización.
Propiedad públicaCompatible con XNA FrameworkRowsObtiene la colección de filas que pertenecen a esta tabla.
Propiedad públicaCompatible con XNA FrameworkSiteObtiene o establece una interfaz System.ComponentModel.ISite para el objeto DataTable. (Invalida a MarshalByValueComponent.Site).
Propiedad públicaCompatible con XNA FrameworkTableNameObtiene o establece el nombre de DataTable.
Arriba
  NombreDescripción
Método públicoCompatible con XNA FrameworkAcceptChangesConfirma todos los cambios realizados en esta tabla desde la última vez que se llamó a AcceptChanges.
Método públicoCompatible con XNA FrameworkBeginInitActiva la inicialización de un objeto DataTable que se emplea en un formulario o que utiliza otro componente. La inicialización se produce en tiempo de ejecución.
Método públicoCompatible con XNA FrameworkBeginLoadDataDesactiva notificaciones, mantenimiento de índices y restricciones mientras se cargan datos.
Método públicoCompatible con XNA FrameworkClearBorra el DataTable de todos los datos.
Método públicoCompatible con XNA FrameworkCloneClona la estructura de DataTable, incluidos todos los esquemas y restricciones de DataTable.
Método públicoCompatible con XNA FrameworkComputeCalcula la expresión dada de las filas actuales que cumplen los criterios de filtro.
Método públicoCompatible con XNA FrameworkCopyCopia la estructura y los datos para este objeto DataTable.
Método públicoCompatible con XNA FrameworkCreateDataReaderDevuelve un objeto DataTableReader que corresponde a los datos incluidos en este objeto DataTable.
Método protegidoCompatible con XNA FrameworkCreateInstanceInfraestructura. Crea una nueva instancia de DataTable.
Método públicoCompatible con XNA FrameworkDispose()Libera todos los recursos utilizados por MarshalByValueComponent. (Se hereda de MarshalByValueComponent).
Método protegidoCompatible con XNA FrameworkDispose(Boolean)Libera los recursos no administrados que utiliza MarshalByValueComponent y libera los recursos administrados de forma opcional. (Se hereda de MarshalByValueComponent).
Método públicoCompatible con XNA FrameworkEndInitFinaliza la inicialización de un objeto DataTable que se emplea en un formulario o que usa otro componente. La inicialización se produce en tiempo de ejecución.
Método públicoCompatible con XNA FrameworkEndLoadDataActiva notificaciones, mantenimiento de índices y restricciones después de cargar datos.
Método públicoCompatible con XNA FrameworkEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoCompatible con XNA FrameworkFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de MarshalByValueComponent).
Método públicoCompatible con XNA FrameworkGetChanges()Obtiene una copia del objeto DataTable que contiene todos los cambios que se le han realizado desde que se cargó o se llamó a AcceptChanges por última vez.
Método públicoCompatible con XNA FrameworkGetChanges(DataRowState)Obtiene una copia del objeto DataTable que contiene todos los cambios que se le han realizado desde la última vez que se cargó, o desde que se llamó a AcceptChanges, filtrado por DataRowState.
Método públicoMiembro estáticoCompatible con XNA FrameworkGetDataTableSchemaEste método devuelve una instancia de XmlSchemaSet que contiene el Lenguaje de descripción de servicios Web (WSDL) que describe DataTable para servicios Web.
Método públicoCompatible con XNA FrameworkGetErrorsObtiene una matriz de objetos DataRow que contienen errores.
Método públicoCompatible con XNA FrameworkGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetObjectDataRellena un objeto de información de serialización con los datos necesarios para serializar la clase DataTable.
Método protegidoCompatible con XNA FrameworkGetRowTypeInfraestructura. Obtiene el tipo de fila.
Método protegidoCompatible con XNA FrameworkGetSchemaInfraestructura. Para obtener una descripción de este miembro, vea IXmlSerializable.GetSchema.
Método públicoCompatible con XNA FrameworkGetServiceObtiene el implementador de IServiceProvider. (Se hereda de MarshalByValueComponent).
Método públicoCompatible con XNA FrameworkGetTypeObtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkImportRowCopia un DataRow en un DataTable conservando los valores de propiedad, así como los valores originales y actuales.
Método públicoCompatible con XNA FrameworkLoad(IDataReader)Rellena un objeto DataTable con valores de un origen de datos utilizando la interfaz IDataReader proporcionada. Si el objeto DataTable ya contiene filas, los datos de entrada del origen de datos se combinan con las filas existentes.
Método públicoCompatible con XNA FrameworkLoad(IDataReader, LoadOption)Rellena un objeto DataTable con valores de un origen de datos utilizando la interfaz IDataReader proporcionada. Si el objeto DataTable ya contiene las filas, los datos de entrada del origen de datos se combinan con las filas existentes conforme al valor del parámetro loadOption.
Método públicoCompatible con XNA FrameworkLoad(IDataReader, LoadOption, FillErrorEventHandler)Rellena un objeto DataTable con valores de un origen de datos utilizando la interfaz IDataReader proporcionada y un delegado de control de errores.
Método públicoCompatible con XNA FrameworkLoadDataRow(Object[], Boolean)Busca y actualiza una fila específica. Si no encuentra ninguna fila coincidente, se crea una nueva con los valores dados.
Método públicoCompatible con XNA FrameworkLoadDataRow(Object[], LoadOption)Busca y actualiza una fila específica. Si no encuentra ninguna fila coincidente, se crea una nueva con los valores dados.
Método protegidoCompatible con XNA FrameworkMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkMerge(DataTable)Combina el objeto DataTable especificado con el objeto DataTable actual.
Método públicoCompatible con XNA FrameworkMerge(DataTable, Boolean)Combina el objeto DataTable especificado con el objeto DataTable actual, indicando si se deben conservar los cambios en el objeto DataTable actual.
Método públicoCompatible con XNA FrameworkMerge(DataTable, Boolean, MissingSchemaAction)Combina el objeto DataTable especificado con el objeto DataTable actual, indicando si se van a conservar los cambios y cómo se va a controlar el esquema que falta en el objeto DataTable actual.
Método públicoCompatible con XNA FrameworkNewRowCrea un nuevo DataRow con el mismo esquema que la tabla.
Método protegidoCompatible con XNA FrameworkNewRowArrayInfraestructura. Devuelve una matriz de objetos DataRow.
Método protegidoCompatible con XNA FrameworkNewRowFromBuilderCrea una nueva fila a partir de una existente.
Método protegidoCompatible con XNA FrameworkOnColumnChangedGenera el evento ColumnChanged.
Método protegidoCompatible con XNA FrameworkOnColumnChangingGenera el evento ColumnChanging.
Método protegidoCompatible con XNA FrameworkOnPropertyChangingGenera el evento PropertyChanged.
Método protegidoOnRemoveColumnNotifica a DataTable que se ha quitado un DataColumn.
Método protegidoCompatible con XNA FrameworkOnRowChangedGenera el evento RowChanged.
Método protegidoCompatible con XNA FrameworkOnRowChangingGenera el evento RowChanging.
Método protegidoCompatible con XNA FrameworkOnRowDeletedGenera el evento RowDeleted.
Método protegidoCompatible con XNA FrameworkOnRowDeletingGenera el evento RowDeleting.
Método protegidoCompatible con XNA FrameworkOnTableClearedGenera el evento TableCleared.
Método protegidoCompatible con XNA FrameworkOnTableClearingGenera el evento TableClearing.
Método protegidoCompatible con XNA FrameworkOnTableNewRowGenera el evento TableNewRow.
Método públicoCompatible con XNA FrameworkReadXml(Stream)Lee los datos y el esquema XML en el objeto DataTable mediante el objeto Stream especificado.
Método públicoCompatible con XNA FrameworkReadXml(String)Lee los datos y el esquema XML en el objeto DataTable desde el archivo especificado.
Método públicoCompatible con XNA FrameworkReadXml(TextReader)Lee los datos y el esquema XML en el objeto DataTable mediante el objeto TextReader especificado.
Método públicoCompatible con XNA FrameworkReadXml(XmlReader)Lee datos y el esquema XML en el objeto DataTable mediante el objeto XmlReader especificado.
Método públicoCompatible con XNA FrameworkReadXmlSchema(Stream)Lee un esquema XML en el objeto DataTable utilizando la secuencia especificada.
Método públicoCompatible con XNA FrameworkReadXmlSchema(String)Lee un esquema XML en el objeto DataTable desde el archivo especificado.
Método públicoCompatible con XNA FrameworkReadXmlSchema(TextReader)Lee un esquema XML en el objeto DataTable utilizando el objeto TextReader especificado.
Método públicoCompatible con XNA FrameworkReadXmlSchema(XmlReader)Lee un esquema XML en el objeto DataTable utilizando el objeto XmlReader especificado.
Método protegidoCompatible con XNA FrameworkReadXmlSerializableInfraestructura. Lee de una secuencia XML.
Método públicoCompatible con XNA FrameworkRejectChangesDeshace todos los cambios que se hayan realizado en la tabla desde que se cargó o se llamó a AcceptChanges por última vez.
Método públicoCompatible con XNA FrameworkResetRestablece el estado original del objeto DataTable.
Método públicoCompatible con XNA FrameworkSelect()Obtiene una matriz de todos los objetos DataRow.
Método públicoCompatible con XNA FrameworkSelect(String)Obtiene una matriz de todos los objetos DataRow que coinciden con los criterios de filtro.
Método públicoCompatible con XNA FrameworkSelect(String, String)Obtiene una matriz de todos los objetos DataRow que coinciden con los criterios de filtro, en el criterio de ordenación especificado.
Método públicoCompatible con XNA FrameworkSelect(String, String, DataViewRowState)Obtiene una matriz de todos los objetos DataRow que coinciden con el filtro en el orden de clasificación y que coinciden con el estado especificado.
Método públicoCompatible con XNA FrameworkToStringObtiene TableName y DisplayExpression, si hay alguna, como cadena concatenada. (Invalida a MarshalByValueComponent.ToString()).
Método públicoCompatible con XNA FrameworkWriteXml(Stream)Escribe el contenido actual del objeto DataTable como elemento XML utilizando el objeto Stream especificado.
Método públicoCompatible con XNA FrameworkWriteXml(String)Escribe el contenido actual del objeto DataTable como elemento XML utilizando el archivo especificado.
Método públicoCompatible con XNA FrameworkWriteXml(TextWriter)Escribe el contenido actual del objeto DataTable como XML utilizando el objeto TextWriter especificado.
Método públicoCompatible con XNA FrameworkWriteXml(XmlWriter)Escribe el contenido actual del objeto DataTable como XML utilizando el objeto XmlWriter especificado.
Método públicoCompatible con XNA FrameworkWriteXml(Stream, Boolean)Escribe el contenido actual del objeto DataTable como elemento XML utilizando el objeto Stream especificado. Para guardar los datos de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Método públicoCompatible con XNA FrameworkWriteXml(Stream, XmlWriteMode)Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataTable en el archivo indicado mediante la enumeración XmlWriteMode especificada. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.
Método públicoCompatible con XNA FrameworkWriteXml(String, Boolean)Escribe el contenido actual del objeto DataTable como elemento XML utilizando el archivo especificado. Para guardar los datos de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Método públicoCompatible con XNA FrameworkWriteXml(String, XmlWriteMode)Escribe los datos actuales y, de forma opcional, el esquema para el DataTable mediante el archivo y la enumeración XmlWriteMode especificados. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.
Método públicoCompatible con XNA FrameworkWriteXml(TextWriter, Boolean)Escribe el contenido actual del objeto DataTable como XML utilizando el objeto TextWriter especificado. Para guardar los datos de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Método públicoCompatible con XNA FrameworkWriteXml(TextWriter, XmlWriteMode)Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataTable mediante el objeto TextWriter y la enumeración XmlWriteMode especificados. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.
Método públicoCompatible con XNA FrameworkWriteXml(XmlWriter, Boolean)Escribe el contenido actual del objeto DataTable como XML utilizando el objeto XmlWriter especificado.
Método públicoCompatible con XNA FrameworkWriteXml(XmlWriter, XmlWriteMode)Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataTable mediante el objeto XmlWriter y la enumeración XmlWriteMode especificados. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema.
Método públicoCompatible con XNA FrameworkWriteXml(Stream, XmlWriteMode, Boolean)Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataTable en el archivo indicado mediante la enumeración XmlWriteMode especificada. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema. Para guardar los datos de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Método públicoCompatible con XNA FrameworkWriteXml(String, XmlWriteMode, Boolean)Escribe los datos actuales y, de forma opcional, el esquema para el DataTable mediante el archivo y la enumeración XmlWriteMode especificados. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema. Para guardar los datos de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Método públicoCompatible con XNA FrameworkWriteXml(TextWriter, XmlWriteMode, Boolean)Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataTable mediante el objeto TextWriter y la enumeración XmlWriteMode especificados. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema. Para guardar los datos de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Método públicoCompatible con XNA FrameworkWriteXml(XmlWriter, XmlWriteMode, Boolean)Escribe los datos actuales y, de forma opcional, el esquema para el objeto DataTable mediante el objeto XmlWriter y la enumeración XmlWriteMode especificados. Para escribir el esquema, establezca el valor del parámetro mode en WriteSchema. Para guardar los datos de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Método públicoCompatible con XNA FrameworkWriteXmlSchema(Stream)Escribe en la secuencia especificada la estructura de datos actual del objeto DataTable como esquema XML.
Método públicoCompatible con XNA FrameworkWriteXmlSchema(String)Escribe en el archivo especificado la estructura de datos actual del objeto DataTable como esquema XML.
Método públicoCompatible con XNA FrameworkWriteXmlSchema(TextWriter)Escribe la estructura de datos actual del objeto DataTable como esquema XML, utilizando el objeto TextWriter especificado.
Método públicoCompatible con XNA FrameworkWriteXmlSchema(XmlWriter)Escribe la estructura de datos actual del objeto DataTable como esquema XML, utilizando el objeto XmlWriter especificado.
Método públicoCompatible con XNA FrameworkWriteXmlSchema(Stream, Boolean)Escribe en la secuencia especificada la estructura de datos actual del objeto DataTable como esquema XML. Para guardar el esquema de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Método públicoCompatible con XNA FrameworkWriteXmlSchema(String, Boolean)Escribe en el archivo especificado la estructura de datos actual del objeto DataTable como esquema XML. Para guardar el esquema de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Método públicoCompatible con XNA FrameworkWriteXmlSchema(TextWriter, Boolean)Escribe la estructura de datos actual del objeto DataTable como esquema XML, utilizando el objeto TextWriter especificado. Para guardar el esquema de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Método públicoCompatible con XNA FrameworkWriteXmlSchema(XmlWriter, Boolean)Escribe la estructura de datos actual del objeto DataTable como esquema XML, utilizando el objeto XmlWriter especificado. Para guardar el esquema de la tabla y de todos sus descendientes, establezca el parámetro writeHierarchy en true.
Arriba
  NombreDescripción
Evento públicoCompatible con XNA FrameworkColumnChangedSe produce cuando se ha cambiado un valor para el DataColumn especificado de un DataRow.
Evento públicoCompatible con XNA FrameworkColumnChangingSe produce cuando se ha cambiado un valor para el DataColumn especificado de un DataRow.
Evento públicoCompatible con XNA FrameworkDisposedAgrega un controlador de eventos para escuchar el evento Disposed en el componente. (Se hereda de MarshalByValueComponent).
Evento públicoCompatible con XNA FrameworkInitializedSe produce después de inicializar DataTable.
Evento públicoCompatible con XNA FrameworkRowChangedSe produce después de cambiar correctamente un objeto DataRow.
Evento públicoCompatible con XNA FrameworkRowChangingSe produce cuando se cambia un DataRow.
Evento públicoCompatible con XNA FrameworkRowDeletedSe produce después de eliminar una fila de la tabla.
Evento públicoCompatible con XNA FrameworkRowDeletingSe produce cuando se va a eliminar una fila de la tabla.
Evento públicoCompatible con XNA FrameworkTableClearedSe produce después de borrar un objeto DataTable.
Evento públicoCompatible con XNA FrameworkTableClearingSe produce cuando se borra un objeto DataTable.
Evento públicoCompatible con XNA FrameworkTableNewRowSe produce cuando se inserta un nuevo objeto DataRow.
Arriba
  NombreDescripción
Método de extensión públicoAsDataViewCrea y devuelve un objeto DataView habilitado para LINQ. (Definido por DataTableExtensions).
Método de extensión públicoAsEnumerableDevuelve un objeto IEnumerable<T>, donde el parámetro T genérico es DataRow. Este objeto puede usarse en una expresión LINQ o en una consulta de método. (Definido por DataTableExtensions).
Arriba
  NombreDescripción
Campo protegidoCompatible con XNA FrameworkfInitInProgressInfraestructura. Comprueba si la inicialización está en curso. La inicialización se produce en tiempo de ejecución.
Arriba
  NombreDescripción
Implementación explícita de interfacesPropiedad privadaCompatible con XNA FrameworkIListSource.ContainsListCollectionPara obtener una descripción de este miembro, vea IListSource.ContainsListCollection.
Implementación explícita de interfacesMétodo privadoCompatible con XNA FrameworkIListSource.GetListPara obtener una descripción de este miembro, vea IListSource.GetList.
Implementación explícita de interfacesMétodo privadoCompatible con XNA FrameworkIXmlSerializable.GetSchemaPara obtener una descripción de este miembro, vea IXmlSerializable.GetSchema.
Implementación explícita de interfacesMétodo privadoCompatible con XNA FrameworkIXmlSerializable.ReadXmlPara obtener una descripción de este miembro, vea IXmlSerializable.ReadXml.
Implementación explícita de interfacesMétodo privadoCompatible con XNA FrameworkIXmlSerializable.WriteXmlPara obtener una descripción de este miembro, vea IXmlSerializable.WriteXml.
Arriba

DataTable es un objeto central de la biblioteca ADO.NET. Entre los objetos que utilizan DataTable se incluyen DataSet y DataView.

Al obtener acceso a los objetos DataTable, hay que tener en cuenta que éstos distinguen entre mayúsculas y minúsculas condicionalmente. Por ejemplo, si un objeto DataTable se denomina "mydatatable" y otro "Mydatatable", la cadena que se utilice para buscar una de las tablas se considerará que distingue entre mayúsculas y minúsculas. Sin embargo, si existe "mydatatable" pero no existe "Mydatatable", se considerará que la cadena de búsqueda no distingue entre mayúsculas y minúsculas. Un objeto DataSet puede contener dos objetos DataTable que tengan el mismo valor para la propiedad TableName y distintos valores para la propiedad Namespace. Para obtener más información sobre el trabajo con los objetos DataTable, vea Creating a DataTable.

Si se va a crear un DataTable mediante programación, en primer lugar se debe definir su esquema agregando objetos DataColumn al DataColumnCollection (al que se obtiene acceso mediante la propiedad Columns). Para obtener más información sobre la adición de objetos DataColumn, vea Adding Columns to a Table.

Para agregar filas a DataTable, en primer lugar se debe utilizar el método NewRow para devolver un nuevo objeto DataRow. El método NewRow devuelve una fila con el esquema de DataTable, tal como lo define el DataColumnCollection de la tabla. El número máximo de filas que un DataTable puede almacenar es 16.777.216. Para obtener más información, vea Adding Data to a Table.

DataTable también contiene una colección de objetos Constraint que se pueden utilizar para asegurar la integridad de los datos. Para obtener más información, vea Adding Constraints to a Table.

Hay muchos eventos DataTable que se pueden utilizar para determinar cuándo se realizan cambios en una tabla. Entre éstos se incluyen RowChanged, RowChanging, RowDeleting y RowDeleted. Para obtener más información sobre los eventos que se pueden utilizar con un objeto DataTable, vea Working with DataTable Events.

Cuando se crea una instancia de DataTable, se establecen algunas propiedades de lectura y escritura en valores iniciales. Para obtener una lista de esos valores, vea el tema sobre el constructor DataTable.DataTable.

NotaNota

Los objetos DataSet y DataTable heredan de MarshalByValueComponent y admiten la interfaz ISerializable para la comunicación remota de .NET Framework. Éstos son los únicos objetos de ADO.NET que se pueden utilizar para la comunicación remota de .NET Framework.

TopicLocation
Cómo: Crear DataTablesAcceso a datos en Visual Studio
Cómo: Crear DataTablesAcceso a datos en Visual Studio

En el ejemplo siguiente se crean dos objetos DataTable y un objeto DataRelation, y se agregan los nuevos objetos a DataSet. A continuación, las tablas se muestran en un control DataGridView.


// Put the next line into the Declarations section.
private System.Data.DataSet dataSet;

private void MakeDataTables()
{
    // Run all of the functions. 
    MakeParentTable();
    MakeChildTable();
    MakeDataRelation();
    BindToDataGrid();
}

private void MakeParentTable()
{
    // Create a new DataTable.
    System.Data.DataTable table = new DataTable("ParentTable");
    // Declare variables for DataColumn and DataRow objects.
    DataColumn column;
    DataRow row;

    // Create new DataColumn, set DataType, 
    // ColumnName and add to DataTable.    
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.Int32");
    column.ColumnName = "id";
    column.ReadOnly = true;
    column.Unique = true;
    // Add the Column to the DataColumnCollection.
    table.Columns.Add(column);

    // Create second column.
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.String");
    column.ColumnName = "ParentItem";
    column.AutoIncrement = false;
    column.Caption = "ParentItem";
    column.ReadOnly = false;
    column.Unique = false;
    // Add the column to the table.
    table.Columns.Add(column);

    // Make the ID column the primary key column.
    DataColumn[] PrimaryKeyColumns = new DataColumn[1];
    PrimaryKeyColumns[0] = table.Columns["id"];
    table.PrimaryKey = PrimaryKeyColumns;

    // Instantiate the DataSet variable.
    dataSet = new DataSet();
    // Add the new DataTable to the DataSet.
    dataSet.Tables.Add(table);

    // Create three new DataRow objects and add 
    // them to the DataTable
    for (int i = 0; i<= 2; i++)
    {
        row = table.NewRow();
        row["id"] = i;
        row["ParentItem"] = "ParentItem " + i;
        table.Rows.Add(row);
    }
}

private void MakeChildTable()
{
    // Create a new DataTable.
    DataTable table = new DataTable("childTable");
    DataColumn column;
    DataRow row;

    // Create first column and add to the DataTable.
    column = new DataColumn();
    column.DataType= System.Type.GetType("System.Int32");
    column.ColumnName = "ChildID";
    column.AutoIncrement = true;
    column.Caption = "ID";
    column.ReadOnly = true;
    column.Unique = true;

    // Add the column to the DataColumnCollection.
    table.Columns.Add(column);

    // Create second column.
    column = new DataColumn();
    column.DataType= System.Type.GetType("System.String");
    column.ColumnName = "ChildItem";
    column.AutoIncrement = false;
    column.Caption = "ChildItem";
    column.ReadOnly = false;
    column.Unique = false;
    table.Columns.Add(column);

    // Create third column.
    column = new DataColumn();
    column.DataType= System.Type.GetType("System.Int32");
    column.ColumnName = "ParentID";
    column.AutoIncrement = false;
    column.Caption = "ParentID";
    column.ReadOnly = false;
    column.Unique = false;
    table.Columns.Add(column);

    dataSet.Tables.Add(table);

    // Create three sets of DataRow objects, 
    // five rows each, and add to DataTable.
    for(int i = 0; i <= 4; i ++)
    {
        row = table.NewRow();
        row["childID"] = i;
        row["ChildItem"] = "Item " + i;
        row["ParentID"] = 0 ;
        table.Rows.Add(row);
    }
    for(int i = 0; i <= 4; i ++)
    {
        row = table.NewRow();
        row["childID"] = i + 5;
        row["ChildItem"] = "Item " + i;
        row["ParentID"] = 1 ;
        table.Rows.Add(row);
    }
    for(int i = 0; i <= 4; i ++)
    {
        row = table.NewRow();
        row["childID"] = i + 10;
        row["ChildItem"] = "Item " + i;
        row["ParentID"] = 2 ;
        table.Rows.Add(row);
    }
}

private void MakeDataRelation()
{
    // DataRelation requires two DataColumn 
    // (parent and child) and a name.
    DataColumn parentColumn = 
        dataSet.Tables["ParentTable"].Columns["id"];
    DataColumn childColumn = 
        dataSet.Tables["ChildTable"].Columns["ParentID"];
    DataRelation relation = new 
        DataRelation("parent2Child", parentColumn, childColumn);
    dataSet.Tables["ChildTable"].ParentRelations.Add(relation);
}

private void BindToDataGrid()
{
    // Instruct the DataGrid to bind to the DataSet, with the 
    // ParentTable as the topmost DataTable.
    dataGrid1.SetDataBinding(dataSet,"ParentTable");
}


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Este tipo es seguro para operaciones de lectura multiproceso. Debe sincronizar cualquier operación de escritura.

¿Te ha resultado útil?
(Caracteres restantes: 1500)

Adiciones de comunidad

AGREGAR
© 2013 Microsoft. Reservados todos los derechos.