DataColumn Clase

Definición

Espacio de nombres:

System.Data

Ensamblados:

netstandard.dll, System.Data.Common.dll

Source:

DataColumn.cs

Representa el esquema de una columna de un DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataColumn : System.ComponentModel.MarshalByValueComponent

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Herencia

Object

MarshalByValueComponent

DataColumn

Atributos

DynamicallyAccessedMembersAttribute

Ejemplos

En el ejemplo siguiente se crea un DataTable objeto con varios DataColumn objetos .

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

DataColumn es el bloque de creación fundamental para crear el esquema de .DataTable Para compilar el esquema, agregue uno o varios DataColumn objetos a .DataColumnCollection Para obtener más información, vea Agregar columnas a una tabla de datos.

Cada DataColumn tiene una DataType propiedad que determina el tipo de datos que DataColumn contiene. Por ejemplo, puede restringir el tipo de datos a enteros, cadenas o decimales. Dado que los datos contenidos por se DataTable combinan normalmente en su origen de datos original, debe coincidir los tipos de datos con los del origen de datos. Para obtener más información, consulte Asignaciones de tipos de datos en ADO.NET.

Propiedades como AllowDBNull, Uniquey ReadOnly ponen restricciones en la entrada y actualización de datos, lo que ayuda a garantizar la integridad de los datos. También puede usar las AutoIncrementpropiedades , AutoIncrementSeedy AutoIncrementStep para controlar la generación automática de datos. Para obtener más información sobre AutoIncrement las columnas, consulte Creación de columnas de autoincremento. Para obtener más información, consulte Definición de claves principales.

También puede asegurarse de que los valores de un objeto DataColumn son únicos creando UniqueConstraint y agregándolo al de al ConstraintCollectionDataTable que pertenece .DataColumn Para obtener más información, vea Restricciones de DataTable.

Para crear una relación entre DataColumn objetos, cree un DataRelation objeto y agréguelo a DataRelationCollection de .DataSet

Puede usar la Expression propiedad del DataColumn objeto para calcular los valores de una columna o crear una columna de agregado. Para obtener más información, vea Crear columnas de expresión.

Constructores

Nombre	Description
DataColumn()	Inicializa una nueva instancia de la DataColumn clase como cadena de tipo.
DataColumn(String, Type, String, MappingType)	Inicializa una nueva instancia de la DataColumn clase utilizando el nombre, el tipo de datos, la expresión y el valor especificados que determina si la columna es un atributo.
DataColumn(String, Type, String)	Inicializa una nueva instancia de la DataColumn clase utilizando el nombre, el tipo de datos y la expresión especificados.
DataColumn(String, Type)	Inicializa una nueva instancia de la DataColumn clase utilizando el nombre de columna y el tipo de datos especificados.
DataColumn(String)	Inicializa una nueva instancia de la DataColumn clase , como cadena de tipo, con el nombre de columna especificado.

Propiedades

Nombre	Description
AllowDBNull	Obtiene o establece un valor que indica si se permiten valores NULL en esta columna para las filas que pertenecen a la tabla.
AutoIncrement	Obtiene o establece un valor que indica si la columna incrementa automáticamente el valor de la columna para las nuevas filas agregadas a la tabla.
AutoIncrementSeed	Obtiene o establece el valor inicial de una columna que tiene su AutoIncrement propiedad establecida trueen . El valor predeterminado es 0.
AutoIncrementStep	Obtiene o establece el incremento utilizado por una columna con su AutoIncrement propiedad establecida trueen .
Caption	Obtiene o establece el título de la columna.
ColumnMapping	Obtiene o establece el MappingType de la columna.
ColumnName	Obtiene o establece el nombre de la columna en .DataColumnCollection
Container	Obtiene el contenedor del componente. (Heredado de MarshalByValueComponent)
DataType	Obtiene o establece el tipo de datos almacenados en la columna.
DateTimeMode	Obtiene o establece el para DateTimeMode la columna.
DefaultValue	Obtiene o establece el valor predeterminado de la columna al crear nuevas filas.
DesignMode	Obtiene un valor que indica si el componente está actualmente en modo de diseño. (Heredado de MarshalByValueComponent)
Events	Obtiene la lista de controladores de eventos que están asociados a este componente. (Heredado de MarshalByValueComponent)
Expression	Obtiene o establece la expresión usada para filtrar filas, calcular los valores de una columna o crear una columna de agregado.
ExtendedProperties	Obtiene la colección de información de usuario personalizada asociada a .DataColumn
MaxLength	Obtiene o establece la longitud máxima de una columna de texto.
Namespace	Obtiene o establece el espacio de nombres de DataColumn.
Ordinal	Obtiene la posición (basada en cero) de la columna de la DataColumnCollection colección.
Prefix	Obtiene o establece un prefijo XML que alias el espacio de nombres de DataTable.
ReadOnly	Obtiene o establece un valor que indica si la columna permite cambios en cuanto se ha agregado una fila a la tabla.
Site	Obtiene o establece el sitio del componente. (Heredado de MarshalByValueComponent)
Table	Obtiene al DataTable que pertenece la columna.
Unique	Obtiene o establece un valor que indica si los valores de cada fila de la columna deben ser únicos.

Métodos

Nombre	Description
CheckNotAllowNull()	Este miembro admite la infraestructura de .NET y no está pensado para usarse directamente desde el código.
CheckUnique()	Este miembro admite la infraestructura de .NET y no está pensado para usarse directamente desde el código.
Dispose()	Libera todos los recursos usados por .MarshalByValueComponent (Heredado de MarshalByValueComponent)
Dispose(Boolean)	Libera los recursos no administrados utilizados por MarshalByValueComponent y, opcionalmente, libera los recursos administrados. (Heredado de MarshalByValueComponent)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetService(Type)	Obtiene el implementador de .IServiceProvider (Heredado de MarshalByValueComponent)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnPropertyChanging(PropertyChangedEventArgs)	Este miembro admite la infraestructura de .NET y no está pensado para usarse directamente desde el código.
RaisePropertyChanging(String)	Este miembro admite la infraestructura de .NET y no está pensado para usarse directamente desde el código.
SetOrdinal(Int32)	Cambia el ordinal o la posición de a DataColumn la ordinal o posición especificadas.
ToString()	Obtiene el Expression valor de de la columna, si existe uno.

Eventos

Nombre	Description
Disposed	Agrega un controlador de eventos para escuchar el Disposed evento en el componente. (Heredado de MarshalByValueComponent)

Seguridad para subprocesos

Este tipo es seguro para las operaciones de lectura multiproceso. Debe sincronizar las operaciones de escritura.

Consulte también

• Add(DataColumn)
• DataColumnCollection
• Constraints
• ConstraintCollection
• DataGrid
• DataRow
• DataTable
• DataSet
• NewRow()
• DataRowCollection
• UniqueConstraint
• Uso de conjuntos de datos en ADO.NET