DataColumn Sınıf

Başvuru

Tanım

Ad Alanı:: System.Data

Bütünleştirilmiş Kod:: System.Data.Common.dll

Bütünleştirilmiş Kod:: System.Data.dll

Bütünleştirilmiş Kod:: netstandard.dll

Kaynak:: DataColumn.cs

Kaynak:: DataColumn.cs

Kaynak:: DataColumn.cs

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

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

public class DataColumn : System.ComponentModel.MarshalByValueComponent

type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Devralma: Object

MarshalByValueComponent
DataColumn

Ö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, bir DataTableşemasını oluş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ılar, dizeler veya ondalıklarla kısıtlayabilirsiniz. tarafından DataTable kapsanan 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.

, Uniqueve ReadOnly 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 ConstraintCollection DataTable, öğesini UniqueConstraint oluşturup 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 nesnesi oluşturun ve nesnesine DataRelationCollection DataSetekleyin.

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

Oluşturucular

DataColumn()	Tür dizesi olarak sınıfını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.
DataColumn(String, Type)	Belirtilen sütun adını ve veri türünü kullanarak sınıfının yeni bir örneğini DataColumn başlatır.
DataColumn(String, Type, String)	Belirtilen adı, veri türünü ve ifadeyi kullanarak sınıfın DataColumn yeni bir örneğini 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.

Özellikler

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ütun değerini otomatik olarak artırıp artırmadığını belirten bir değer alır veya ayarlar.
AutoIncrementSeed	Özelliği olarak ayarlanmış `true`bir sütunun AutoIncrement başlangıç değerini alır veya ayarlar. Varsayılan değer, 0'dur.
AutoIncrementStep	Özelliği olarak ayarlanmış `true`bir sütun AutoIncrement tarafından kullanılan artışı alır veya ayarlar.
Caption	Sütun için başlık alır veya ayarlar.
ColumnMapping	Sütunun öğesini MappingType alır 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 eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: MarshalByValueComponent)
Expression	Satırları filtrelemek, sütundaki değerleri hesaplamak veya bir toplama sütunu oluşturmak için kullanılan ifadeyi alır veya ayarlar.
ExtendedProperties	ile DataColumnilişkili ö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 sağlayan bir XML ön eki alır veya ayarlar.
ReadOnly	Tabloya satır eklendiğinde sütunun değişikliklere izin verip vermediğini belirten 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

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()	MarshalByValueComponent tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: MarshalByValueComponent)
Dispose(Boolean)	MarshalByValueComponent tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak 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()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ 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ıra veya konumunu DataColumn belirtilen sıra veya konuma değiştirir.
ToString()	Expression Varsa sütunun öğesini alır.

Ekinlikler

Disposed

Bileşendeki olayı dinlemek için Disposed bir olay işleyicisi ekler.

(Devralındığı yer: MarshalByValueComponent)

Şunlara uygulanır

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

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