DataColumn Sınıf

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

Kaynak:

DataColumn.cs

içindeki bir sütunun DataTableşemasını temsil eder.

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

Devralma

Object

MarshalByValueComponent

DataColumn

Öznitelikler

DynamicallyAccessedMembersAttribute

Örnekler

Aşağıdaki örnek, birkaç DataColumn nesne içeren bir DataTable oluşturur.

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

Açıklamalar

DataColumn, şemasını DataTableoluşturmaya yönelik temel yapı taşıdır. şemasını oluşturmak için DataColumnCollectionöğesine bir veya daha fazla DataColumn nesne eklersiniz. Daha fazla bilgi için bkz. DataTable'a Sütun Ekleme.

Her DataColumn birinin içerdiği veri DataColumn türünü belirleyen bir DataType özelliği vardır. Örneğin, veri türünü tamsayılarla, dizelerle veya ondalıklarla kısıtlayabilirsiniz. tarafından DataTable içerilen veriler genellikle özgün veri kaynağıyla birleştirildiğinden, veri türlerini veri kaynağındaki veri türleriyle eşleştirmeniz gerekir. Daha fazla bilgi için bkz. ADO.NET'de Veri Türü Eşlemeleri.

, UniqueReadOnly ve gibi AllowDBNullözellikler, verilerin girişi ve güncelleştirilmesiyle ilgili kısıtlamalar getirerek veri bütünlüğünün garanti edilmesine yardımcı olur. Otomatik veri oluşturmayı denetlemek için , AutoIncrementSeedve AutoIncrementStep özelliklerini de kullanabilirsinizAutoIncrement. Sütunlar hakkında AutoIncrement daha fazla bilgi için bkz. AutoIncrement Sütunları Oluşturma. Daha fazla bilgi için bkz . Birincil Anahtarları Tanımlama.

Ayrıca, içindeki DataColumn değerlerin benzersiz olduğundan emin olmak için DataTableConstraintCollection, öğesini oluşturup UniqueConstraint ait olduğu DataColumn değere ekleyebilirsiniz. Daha fazla bilgi için bkz. DataTable Kısıtlamaları.

Nesneler arasında DataColumn ilişki oluşturmak için bir DataRelation nesne oluşturun ve nesnesine DataRelationCollectionDataSetekleyin.

Bir sütundaki Expression değerleri hesaplamak veya bir toplama sütunu oluşturmak için nesnesinin özelliğini DataColumn kullanabilirsiniz. Daha fazla bilgi için bkz. İfade Sütunları Oluşturma.

Oluşturucular

Name	Description
DataColumn()	Sınıfının yeni bir örneğini DataColumn tür dizesi olarak başlatır.
DataColumn(String, Type, String, MappingType)	Belirtilen adı, veri türünü, ifadeyi DataColumn ve sütunun bir öznitelik olup olmadığını belirleyen değeri kullanarak sınıfın yeni bir örneğini başlatır.
DataColumn(String, Type, String)	Belirtilen adı, veri türünü ve ifadeyi DataColumn kullanarak sınıfın yeni bir örneğini başlatır.
DataColumn(String, Type)	Belirtilen sütun adını ve veri türünü kullanarak sınıfın yeni bir örneğini DataColumn başlatır.
DataColumn(String)	Belirtilen sütun adını kullanarak tür dizesi olarak sınıfının yeni bir örneğini DataColumn başlatır.

Özellikler

Name	Description
AllowDBNull	Tabloya ait satırlar için bu sütunda null değerlere izin verilip verilmeyeceğini belirten bir değer alır veya ayarlar.
AutoIncrement	Sütunun tabloya eklenen yeni satırlar için sütunun değerini otomatik olarak artırıp artırmadığını gösteren bir değer alır veya ayarlar.
AutoIncrementSeed	özelliği olarak ayarlanmış truebir sütun AutoIncrement için başlangıç değerini alır veya ayarlar. Varsayılan değer 0’dır.
AutoIncrementStep	Özelliği olarak ayarlanmış truebir sütun AutoIncrement tarafından kullanılan artışı alır veya ayarlar.
Caption	Sütun için resim yazısını alır veya ayarlar.
ColumnMapping	Sütunu alır MappingType veya ayarlar.
ColumnName	içindeki DataColumnCollectionsütunun adını alır veya ayarlar.
Container	Bileşenin kapsayıcısını alır. (Devralındığı yer: MarshalByValueComponent)
DataType	Sütunda depolanan veri türünü alır veya ayarlar.
DateTimeMode	Sütun için öğesini DateTimeMode alır veya ayarlar.
DefaultValue	Yeni satır oluştururken sütun için varsayılan değeri alır veya ayarlar.
DesignMode	Bileşenin şu anda tasarım modunda olup olmadığını gösteren bir değer alır. (Devralındığı yer: MarshalByValueComponent)
Events	Bu bileşene bağlı olay işleyicilerinin listesini alır. (Devralındığı yer: MarshalByValueComponent)
Expression	Satırları filtrelemek, bir sütundaki değerleri hesaplamak veya bir toplama sütunu oluşturmak için kullanılan ifadeyi alır veya ayarlar.
ExtendedProperties	ile DataColumnilişkilendirilmiş özel kullanıcı bilgilerinin koleksiyonunu alır.
MaxLength	Metin sütununun uzunluk üst sınırını alır veya ayarlar.
Namespace	öğesinin ad alanını DataColumnalır veya ayarlar.
Ordinal	Koleksiyondaki sütunun DataColumnCollection (sıfır tabanlı) konumunu alır.
Prefix	öğesinin ad alanına DataTablediğer ad veren bir XML ön eki alır veya ayarlar.
ReadOnly	Tabloya bir satır eklendiğinde sütunun değişikliklere izin verip vermediğini gösteren bir değer alır veya ayarlar.
Site	Bileşenin sitesini alır veya ayarlar. (Devralındığı yer: MarshalByValueComponent)
Table	Sütunun DataTable ait olduğu sütunu alır.
Unique	Sütunun her satırındaki değerlerin benzersiz olması gerekip gerekmediğini belirten bir değer alır veya ayarlar.

Yöntemler

Name	Description
CheckNotAllowNull()	Bu üye .NET altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
CheckUnique()	Bu üye .NET altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
Dispose()	tarafından MarshalByValueComponentkullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: MarshalByValueComponent)
Dispose(Boolean)	tarafından MarshalByValueComponent kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: MarshalByValueComponent)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetService(Type)	uygulayıcısını IServiceProvideralır. (Devralındığı yer: MarshalByValueComponent)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnPropertyChanging(PropertyChangedEventArgs)	Bu üye .NET altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
RaisePropertyChanging(String)	Bu üye .NET altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
SetOrdinal(Int32)	öğesinin sıralı veya konumunu DataColumn belirtilen sıra veya konuma değiştirir.
ToString()	Expression Varsa sütunun öğesini alır.

Ekinlikler

Name	Description
Disposed	Bileşendeki olayı dinlemek için Disposed bir olay işleyicisi ekler. (Devralındığı yer: MarshalByValueComponent)

İş Parçacığı Güvenliği

Bu tür, çok iş parçacıklı okuma işlemleri için güvenlidir. Tüm yazma işlemlerini eşitlemeniz gerekir.

Ayrıca bkz.

• Add(DataColumn)
• DataColumnCollection
• Constraints
• ConstraintCollection
• DataGrid
• DataRow
• DataTable
• DataSet
• NewRow()
• DataRowCollection
• UniqueConstraint
• ADO.NET'da DataSet'leri kullanma