DataColumn DataColumn DataColumn DataColumn Class

Definición

Representa el esquema de una columna en una DataTable.Represents the schema of a column in a DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent
public class DataColumn : System.ComponentModel.MarshalByValueComponent
type DataColumn = class
    inherit MarshalByValueComponent
Public Class DataColumn
Inherits MarshalByValueComponent
Herencia

Ejemplos

En el ejemplo siguiente se DataTable crea un DataColumn objeto con varios objetos.The following example creates a DataTable with several DataColumn objects.

private void MakeTable()
{ 
    // Create a DataTable. 
    DataTable table = new DataTable("Product");

    // Create a DataColumn and set various properties. 
    DataColumn column = new DataColumn(); 
    column.DataType = System.Type.GetType("System.Decimal"); 
    column.AllowDBNull = false; 
    column.Caption = "Price"; 
    column.ColumnName = "Price"; 
    column.DefaultValue = 25; 

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

    // Add 10 rows and set values. 
    DataRow row; 
    for(int i = 0; i < 10; i++)
    { 
        row = table.NewRow(); 
        row["Price"] = i + 1; 

        // Be sure to add the new row to the 
        // DataRowCollection. 
        table.Rows.Add(row); 
    } 
}
Private Sub MakeTable()
    ' Create a DataTable. 
    Dim table As New DataTable("Product")

    ' Create a DataColumn and set various properties. 
    Dim column As New DataColumn()
    column.DataType = System.Type.GetType("System.Decimal") 
    column.AllowDBNull = False 
    column.Caption = "Price"  
    column.ColumnName = "Price" 
    column.DefaultValue = 25 

    ' Add the column to the table. 
    table.Columns.Add(column) 

    ' Add 10 rows and set values. 
    Dim row As DataRow 
    Dim i As Integer  
    For i = 0 to 9 
        row = table.NewRow() 
        row("Price") = i + 1 

        ' Be sure to add the new row to 
        ' the DataRowCollection. 
        table.Rows.Add(row) 
    Next i 
End Sub

Comentarios

Es el bloque de creación fundamental para crear el esquema de un DataTable. DataColumnThe DataColumn is the fundamental building block for creating the schema of a DataTable. Para generar el esquema, agregue uno o más DataColumn objetos a. DataColumnCollectionYou build the schema by adding one or more DataColumn objects to the DataColumnCollection. Para obtener más información, vea Agregar columnas a un objeto DataTable.For more information, see Adding Columns to a DataTable.

Cada DataColumn tiene una DataType propiedad que determina DataColumn el tipo de datos que contiene.Each DataColumn has a DataType property that determines the kind of data the DataColumn contains. Por ejemplo, puede restringir el tipo de datos a enteros, cadenas o decimales.For example, you can restrict the data type to integers, or strings, or decimals. Dado que los DataTable datos que contiene se combinan normalmente en su origen de datos original, debe hacer coincidir los tipos de datos con los del origen de datos.Because data that is contained by the DataTable is typically merged back into its original data source, you must match the data types to those in the data source. Para obtener más información, vea asignaciones de tipos de datos en ADO.net.For more information, see Data Type Mappings in ADO.NET.

Las propiedades como AllowDBNull, Uniquey ReadOnly colocan restricciones en la entrada y la actualización de datos, lo que ayuda a garantizar la integridad de los datos.Properties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. También puede utilizar las propiedades AutoIncrement, AutoIncrementSeedy AutoIncrementStep para controlar la generación automática de datos.You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. Para obtener más información AutoIncrement acerca de las columnas, vea crear columnas de incremento automático.For more information about AutoIncrement columns, see Creating AutoIncrement Columns. Para obtener más información, vea definir claves principales.For more information, see Defining Primary Keys.

También puede asegurarse de que los valores de un DataColumn son únicos creando un UniqueConstraint ConstraintCollection y agregándolo al del DataTable al que DataColumn pertenece.You can also make sure that values in a DataColumn are unique by creating a UniqueConstraint and adding it to the ConstraintCollection of the DataTable to which the DataColumn belongs. Para obtener más información, vea restricciones de DataTable.For more information, see DataTable Constraints.

Para crear una relación entre DataColumn los DataRelationCollection objetos, cree DataRelation un objeto y agréguelo al de DataSet.To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

Puede utilizar la Expression propiedad DataColumn del objeto para calcular los valores de una columna o crear una columna agregada.You can use the Expression property of the DataColumn object to calculate the values in a column, or create an aggregate column. Para obtener más información, vea crear columnas de expresión.For more information, see Creating Expression Columns.

Constructores

DataColumn() DataColumn() DataColumn() DataColumn()

Inicializa una nueva instancia de la clase DataColumn como cadena de tipo.Initializes a new instance of a DataColumn class as type string.

DataColumn(String) DataColumn(String) DataColumn(String) DataColumn(String)

Inicializa una nueva instancia de la clase DataColumn, como cadena de tipo, utilizando el nombre de columna especificado.Initializes a new instance of the DataColumn class, as type string, using the specified column name.

DataColumn(String, Type) DataColumn(String, Type) DataColumn(String, Type) DataColumn(String, Type)

Inicializa una nueva instancia de la clase DataColumn con el nombre de columna y el tipo de datos especificados.Initializes a new instance of the DataColumn class using the specified column name and data type.

DataColumn(String, Type, String) DataColumn(String, Type, String) DataColumn(String, Type, String) DataColumn(String, Type, String)

Inicializa una nueva instancia de la clase DataColumn con el nombre, el tipo de datos y la expresión especificados.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType)

Inicializa una nueva instancia de la clase DataColumn con el nombre, el tipo de datos, la expresión y un valor que determina si la columna es un atributo; todos ellos especificados.Initializes a new instance of the DataColumn class using the specified name, data type, expression, and value that determines whether the column is an attribute.

Propiedades

AllowDBNull AllowDBNull AllowDBNull AllowDBNull

Obtiene o establece un valor que indica si en esta columna se permiten valores null para las filas que pertenecen a la tabla.Gets or sets a value that indicates whether null values are allowed in this column for rows that belong to the table.

AutoIncrement AutoIncrement AutoIncrement AutoIncrement

Obtiene o establece un valor que indica si la columna incrementa automáticamente el valor de la columna para las nuevas filas que se agregan a la tabla.Gets or sets a value that indicates whether the column automatically increments the value of the column for new rows added to the table.

AutoIncrementSeed AutoIncrementSeed AutoIncrementSeed AutoIncrementSeed

Obtiene o establece el valor inicial de una columna cuya propiedad AutoIncrement está establecida en true.Gets or sets the starting value for a column that has its AutoIncrement property set to true. El valor predeterminado es 0.The default is 0.

AutoIncrementStep AutoIncrementStep AutoIncrementStep AutoIncrementStep

Obtiene o establece el incremento utilizado por una columna cuya propiedad AutoIncrement está establecida en true.Gets or sets the increment used by a column with its AutoIncrement property set to true.

Caption Caption Caption Caption

Obtiene o establece el título de la columna.Gets or sets the caption for the column.

ColumnMapping ColumnMapping ColumnMapping ColumnMapping

Obtiene o establece el MappingType de la columna.Gets or sets the MappingType of the column.

ColumnName ColumnName ColumnName ColumnName

Obtiene o establece el nombre de la columna en el DataColumnCollection.Gets or sets the name of the column in the DataColumnCollection.

Container Container Container Container

Obtiene el contenedor del componente.Gets the container for the component.

(Inherited from MarshalByValueComponent)
DataType DataType DataType DataType

Obtiene o establece el tipo de datos almacenados en la columna.Gets or sets the type of data stored in the column.

DateTimeMode DateTimeMode DateTimeMode DateTimeMode

Obtiene o establece la propiedad DateTimeMode para la columna.Gets or sets the DateTimeMode for the column.

DefaultValue DefaultValue DefaultValue DefaultValue

Obtiene o establece el valor predeterminado para la columna al crear nuevas filas.Gets or sets the default value for the column when you are creating new rows.

DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si el componente está actualmente en modo de diseño.Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
Events Events Events Events

Obtiene la lista de controladores de eventos asociados a este componente.Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
Expression Expression Expression Expression

Obtiene o establece la expresión utilizada para filtrar filas, calcular los valores de una columna o crear una columna agregada.Gets or sets the expression used to filter rows, calculate the values in a column, or create an aggregate column.

ExtendedProperties ExtendedProperties ExtendedProperties ExtendedProperties

Obtiene la colección de la información personalizada del usuario asociada a DataColumn.Gets the collection of custom user information associated with a DataColumn.

MaxLength MaxLength MaxLength MaxLength

Obtiene o establece la longitud máxima de una columna de texto.Gets or sets the maximum length of a text column.

Namespace Namespace Namespace Namespace

Obtiene o establece el espacio de nombres del objeto DataColumn.Gets or sets the namespace of the DataColumn.

Ordinal Ordinal Ordinal Ordinal

Obtiene la posición de base cero de la columna en la colección DataColumnCollection.Gets the (zero-based) position of the column in the DataColumnCollection collection.

Prefix Prefix Prefix Prefix

Obtiene o establece un prefijo XML que crea alias para el espacio de nombres del objeto DataTable.Gets or sets an XML prefix that aliases the namespace of the DataTable.

ReadOnly ReadOnly ReadOnly ReadOnly

Obtiene o establece un valor que indica si la columna permite cambios justo después de que se haya agregado una fila a la tabla.Gets or sets a value that indicates whether the column allows for changes as soon as a row has been added to the table.

Site Site Site Site

Obtiene o establece el sitio del componente.Gets or sets the site of the component.

(Inherited from MarshalByValueComponent)
Table Table Table Table

Obtiene el DataTable al que pertenece la columna.Gets the DataTable to which the column belongs to.

Unique Unique Unique Unique

Obtiene o establece un valor que indica si los valores de cada fila de la columna deben ser únicos.Gets or sets a value that indicates whether the values in each row of the column must be unique.

Métodos

CheckNotAllowNull() CheckNotAllowNull() CheckNotAllowNull() CheckNotAllowNull()

Este miembro admite la infraestructura de .NET Framework y no está prevista su utilización directa desde el código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

CheckUnique() CheckUnique() CheckUnique() CheckUnique()

Este miembro admite la infraestructura de .NET Framework y no está prevista su utilización directa desde el código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos que usa MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Inherited from MarshalByValueComponent)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos no administrados que usa MarshalByValueComponent y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Inherited from MarshalByValueComponent)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Obtiene el implementador de IServiceProvider.Gets the implementer of the IServiceProvider.

(Inherited from MarshalByValueComponent)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs)

Este miembro admite la infraestructura de .NET Framework y no está prevista su utilización directa desde el código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String)

Este miembro admite la infraestructura de .NET Framework y no está prevista su utilización directa desde el código.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

SetOrdinal(Int32) SetOrdinal(Int32) SetOrdinal(Int32) SetOrdinal(Int32)

Cambia el ordinal o la posición del objeto DataColumn al ordinal o posición especificados.Changes the ordinal or position of the DataColumn to the specified ordinal or position.

ToString() ToString() ToString() ToString()

Obtiene el Expression de la columna, si existe alguno.Gets the Expression of the column, if one exists.

Eventos

Disposed Disposed Disposed Disposed

Agrega un controlador de eventos para escuchar el evento Disposed en el componente.Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para las operaciones de lectura multiproceso.This type is safe for multithreaded read operations. Debe sincronizar cualquier operación de escritura.You must synchronize any write operations.

Consulte también: