DataColumn Sınıf
Tanım
Ö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
Ö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ış |
AutoIncrementStep |
Özelliği olarak ayarlanmış |
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 |
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ı
Ş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.