DataColumn Sınıf

Tanım

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

Ö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ına bir veya daha fazla DataColumn nesne ekleyerek şemayı DataColumnCollectionoluşturursunuz. 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.

, ve gibi AllowDBNullUniqueReadOnly ö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. OtomatikCrement 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 ConstraintCollectionDataTable, öğ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 nesne oluşturun ve nesnesine DataRelationCollectionDataSetekleyin.

Bir sütundaki ExpressionDataColumn 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()

Sınıfının yeni bir örneğini DataColumn tür dizesi olarak 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 yeni bir örneğini DataColumn 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, String, MappingType)

Belirtilen adı, veri türünü, ifadeyi DataColumn ve sütunun ö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ütunun değerini otomatik olarak artırıp artırmadığını belirten bir değer alır veya ayarlar.

AutoIncrementSeed

özelliği olarak ayarlanmış truebir sütunun AutoIncrement başlangıç değerini alır veya ayarlar. Varsayılan değer, 0'dur.

AutoIncrementStep

Özelliği olarak ayarlanmış truebir 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ı belirten 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ş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 veren bir XML ön eki alır veya ayarlar.

ReadOnly

Sütunun tabloya bir satır eklendiği anda 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 değeri 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ıralı 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)

Uzantı Metotları

GetKeyedService<T>(IServiceProvider, Object)

türünde IServiceProviderbir hizmet T alır.

GetKeyedServices(IServiceProvider, Type, Object)

türünde hizmetlerin serviceType bir numaralandırmasını IServiceProvideralır.

GetKeyedServices<T>(IServiceProvider, Object)

türünde hizmetlerin T bir numaralandırmasını IServiceProvideralır.

GetRequiredKeyedService(IServiceProvider, Type, Object)

türünde IServiceProviderbir hizmet serviceType alır.

GetRequiredKeyedService<T>(IServiceProvider, Object)

türünde IServiceProviderbir hizmet T alır.

CreateAsyncScope(IServiceProvider)

Kapsamı belirlenmiş hizmetleri çözümlemek için kullanılabilecek yeni AsyncServiceScope bir oluşturur.

CreateScope(IServiceProvider)

Kapsamı belirlenmiş hizmetleri çözümlemek için kullanılabilecek yeni IServiceScope bir oluşturur.

GetRequiredService(IServiceProvider, Type)

türünden serviceTypeIServiceProviderhizmet alın.

GetRequiredService<T>(IServiceProvider)

türünden TIServiceProviderhizmet alın.

GetService<T>(IServiceProvider)

türünden TIServiceProviderhizmet alın.

GetServices(IServiceProvider, Type)

türünde bir hizmet serviceTypeIServiceProviderlistesi alın.

GetServices<T>(IServiceProvider)

türünde bir hizmet TIServiceProviderlistesi alın.

GetFakeLogCollector(IServiceProvider)

Sahte günlükçüye gönderilen günlük kayıtlarını toplayan nesneyi alır.

GetFakeRedactionCollector(IServiceProvider)

Bağımlılık ekleme kapsayıcısından sahte redaktör toplayıcı örneğini alır.

Ş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.

Ayrıca bkz.