DataColumn Třída

Definice

Představuje schéma sloupce v 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
Dědičnost

Příklady

Následující příklad vytvoří DataTable s několika DataColumn objekty.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

Poznámky

Je základním stavebním blokem pro vytvoření schématu DataTable. DataColumnThe DataColumn is the fundamental building block for creating the schema of a DataTable. Schéma sestavíte přidáním jednoho nebo více DataColumn objektů DataColumnCollectiondo.You build the schema by adding one or more DataColumn objects to the DataColumnCollection. Další informace najdete v tématu Přidání sloupců do objektu DataTable.For more information, see Adding Columns to a DataTable.

Každá DataColumn DataColumn má vlastnost, která určuje druh dat, která obsahuje. DataTypeEach DataColumn has a DataType property that determines the kind of data the DataColumn contains. Můžete například omezit datový typ na celá čísla, řetězce nebo desetinná místa.For example, you can restrict the data type to integers, or strings, or decimals. Vzhledem k tomu, že data, DataTable která jsou obsažena v, se obvykle sloučí zpět do původního zdroje dat, je nutné, abyste se shodovali s datovými typy, které jsou ve zdroji dat.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. Další informace najdete v tématu mapování datových typů v ADO.NET.For more information, see Data Type Mappings in ADO.NET.

Vlastnosti, jako AllowDBNulljsou Unique, a ReadOnly omezení pro zadání a aktualizaci dat, což pomáhá zaručit integritu dat.Properties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. K řízení automatického generování dat AutoIncrementmůžete AutoIncrementSeedpoužít také AutoIncrementStep vlastnosti, a.You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. Další informace o AutoIncrement sloupcích najdete v tématu vytváření sloupců AutoIncrement.For more information about AutoIncrement columns, see Creating AutoIncrement Columns. Další informace najdete v tématu Definování primárních klíčů.For more information, see Defining Primary Keys.

Můžete také zajistit, aby hodnoty DataColumn v a byly jedinečné, UniqueConstraint vytvořením ConstraintCollection a přidáním do DataTable do, ke kterému DataColumn patří.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. Další informace naleznete v tématu omezení DataTable.For more information, see DataTable Constraints.

Chcete-li vytvořit relaci DataColumn mezi objekty, DataRelation vytvořte objekt DataRelationCollection a přidejte DataSetjej do objektu.To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

Pomocí Expression vlastnostiDataColumn objektu můžete vypočítat hodnoty ve sloupci nebo vytvořit agregovaný sloupec.You can use the Expression property of the DataColumn object to calculate the values in a column, or create an aggregate column. Další informace najdete v tématu vytváření sloupců výrazu.For more information, see Creating Expression Columns.

Konstruktory

DataColumn()

Inicializuje novou instanci DataColumn třídy jako řetězec typu.Initializes a new instance of a DataColumn class as type string.

DataColumn(String)

Inicializuje novou instanci DataColumn třídy jako řetězec typu pomocí zadaného názvu sloupce.Initializes a new instance of the DataColumn class, as type string, using the specified column name.

DataColumn(String, Type)

Inicializuje novou instanci DataColumn třídy pomocí zadaného názvu sloupce a datového typu.Initializes a new instance of the DataColumn class using the specified column name and data type.

DataColumn(String, Type, String)

Inicializuje novou instanci DataColumn třídy pomocí zadaného názvu, datového typu a výrazu.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

DataColumn(String, Type, String, MappingType)

Inicializuje novou instanci DataColumn třídy pomocí zadaného názvu, datového typu, výrazu a hodnoty, která určuje, zda je sloupec atributem.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.

Vlastnosti

AllowDBNull

Získává nebo nastavuje hodnotu, která indikuje, jestli jsou v tomto sloupci povolené hodnoty null pro řádky, které patří do tabulky.Gets or sets a value that indicates whether null values are allowed in this column for rows that belong to the table.

AutoIncrement

Získává nebo nastavuje hodnotu, která indikuje, jestli sloupec automaticky zvýší hodnotu sloupce pro nové řádky přidané do tabulky.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

Získá nebo nastaví počáteční hodnotu pro sloupec s AutoIncrement nastavenou vlastností na. trueGets or sets the starting value for a column that has its AutoIncrement property set to true. Výchozí hodnota je 0.The default is 0.

AutoIncrementStep

Získá nebo nastaví přírůstek, který se používá u sloupce s AutoIncrement vlastností nastavenou truena.Gets or sets the increment used by a column with its AutoIncrement property set to true.

Caption

Získá nebo nastaví titulek sloupce.Gets or sets the caption for the column.

ColumnMapping

Získá nebo nastaví MappingType sloupec.Gets or sets the MappingType of the column.

ColumnName

Získá nebo nastaví název sloupce v DataColumnCollection.Gets or sets the name of the column in the DataColumnCollection.

Container

Načte kontejner pro komponentu.Gets the container for the component.

(Zděděno od MarshalByValueComponent)
DataType

Získá nebo nastaví typ dat uložených ve sloupci.Gets or sets the type of data stored in the column.

DateTimeMode

Získá nebo nastaví DateTimeMode sloupce pro sloupec.Gets or sets the DateTimeMode for the column.

DefaultValue

Získá nebo nastaví výchozí hodnotu pro sloupec při vytváření nových řádků.Gets or sets the default value for the column when you are creating new rows.

DesignMode

Načte hodnotu, která označuje, zda je komponenta aktuálně v režimu návrhu.Gets a value indicating whether the component is currently in design mode.

(Zděděno od MarshalByValueComponent)
Events

Získá seznam obslužných rutin událostí, které jsou připojeny k této součásti.Gets the list of event handlers that are attached to this component.

(Zděděno od MarshalByValueComponent)
Expression

Získá nebo nastaví výraz používaný k filtrování řádků, výpočtu hodnot ve sloupci nebo vytvoření agregačního sloupce.Gets or sets the expression used to filter rows, calculate the values in a column, or create an aggregate column.

ExtendedProperties

Získá kolekci vlastních uživatelských informací přidružených DataColumnk.Gets the collection of custom user information associated with a DataColumn.

MaxLength

Získá nebo nastaví maximální délku textového sloupce.Gets or sets the maximum length of a text column.

Namespace

Získá nebo nastaví obor názvů DataColumnpro.Gets or sets the namespace of the DataColumn.

Ordinal

Získá pozici (na základě nuly) sloupce v DataColumnCollection kolekci.Gets the (zero-based) position of the column in the DataColumnCollection collection.

Prefix

Získá nebo nastaví předponu XML, která aliasuje obor názvů DataTable.Gets or sets an XML prefix that aliases the namespace of the DataTable.

ReadOnly

Získává nebo nastavuje hodnotu, která indikuje, jestli sloupec umožňuje změny, jakmile se do tabulky přidá řádek.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

Získá nebo nastaví web součásti.Gets or sets the site of the component.

(Zděděno od MarshalByValueComponent)
Table

Získá, DataTable do kterého sloupec patří.Gets the DataTable to which the column belongs to.

Unique

Získává nebo nastavuje hodnotu, která indikuje, jestli hodnoty v jednotlivých řádcích sloupce musí být jedinečné.Gets or sets a value that indicates whether the values in each row of the column must be unique.

Metody

CheckNotAllowNull()

Tento člen podporuje infrastrukturu rozhraní .NET Framework a není určen pro použití přímo v kódu.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

CheckUnique()

Tento člen podporuje infrastrukturu rozhraní .NET Framework a není určen pro použití přímo v kódu.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Dispose()

Uvolní všechny prostředky, které MarshalByValueComponentpoužívá.Releases all resources used by the MarshalByValueComponent.

(Zděděno od MarshalByValueComponent)
Dispose(Boolean)

Uvolní nespravované prostředky používané MarshalByValueComponent a volitelně uvolňuje spravované prostředky.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Zděděno od MarshalByValueComponent)
Equals(Object)

Určuje, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetService(Type)

Získá implementátora IServiceProvider.Gets the implementer of the IServiceProvider.

(Zděděno od MarshalByValueComponent)
GetType()

Získá Type aktuální instance.Gets the Type of the current instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří kopii aktuálního Objectbez podstruktury.Creates a shallow copy of the current Object.

(Zděděno od Object)
OnPropertyChanging(PropertyChangedEventArgs)

Tento člen podporuje infrastrukturu rozhraní .NET Framework a není určen pro použití přímo v kódu.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

RaisePropertyChanging(String)

Tento člen podporuje infrastrukturu rozhraní .NET Framework a není určen pro použití přímo v kódu.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

SetOrdinal(Int32)

Změní pořadové číslo nebo pozici DataColumn na zadané pořadové číslo nebo pozici.Changes the ordinal or position of the DataColumn to the specified ordinal or position.

ToString()

Expression Získá sloupec, pokud existuje.Gets the Expression of the column, if one exists.

Události

Disposed

Přidá obslužnou rutinu události, která bude Disposed naslouchat události v součásti.Adds an event handler to listen to the Disposed event on the component.

(Zděděno od MarshalByValueComponent)

Platí pro

Bezpečný přístup z více vláken

Tento typ je bezpečný pro operace čtení ve více vláknech.This type is safe for multithreaded read operations. Je nutné synchronizovat všechny operace zápisu.You must synchronize any write operations.

Viz také