DataColumn Kelas

Referensi

Definisi

Ruang nama:: System.Data

Rakitan:: System.Data.Common.dll

Rakitan:: System.Data.dll

Rakitan:: netstandard.dll

Sumber:: DataColumn.cs

Sumber:: DataColumn.cs

Sumber:: DataColumn.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili skema kolom dalam DataTable.

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

public class DataColumn : System.ComponentModel.MarshalByValueComponent

type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Warisan: Object

MarshalByValueComponent
DataColumn

Contoh

Contoh berikut membuat DataTable dengan beberapa DataColumn objek.

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

Keterangan

DataColumn adalah blok penyusun dasar untuk membuat skema DataTable. Anda membangun skema dengan menambahkan satu atau beberapa DataColumn objek ke DataColumnCollection. Untuk informasi selengkapnya, lihat Menambahkan Kolom ke DataTable.

Masing-masing DataColumn memiliki DataType properti yang menentukan jenis data yang dikandungnya DataColumn . Misalnya, Anda dapat membatasi jenis data ke bilangan bulat, atau string, atau desimal. Karena data yang dimuat oleh DataTable biasanya digabungkan kembali ke sumber data aslinya, Anda harus mencocokkan jenis data dengan yang ada di sumber data. Untuk informasi selengkapnya, lihat Pemetaan Tipe Data di ADO.NET.

Properti seperti AllowDBNull, Unique, dan ReadOnly memberlakukan pembatasan pada entri dan pembaruan data, sehingga membantu menjamin integritas data. Anda juga dapat menggunakan AutoIncrementproperti , AutoIncrementSeed, dan AutoIncrementStep untuk mengontrol pembuatan data otomatis. Untuk informasi selengkapnya tentang AutoIncrement kolom, lihat Membuat Kolom AutoIncrement. Untuk informasi selengkapnya, lihat Menentukan Kunci Utama.

Anda juga dapat memastikan bahwa nilai dalam unik DataColumn dengan membuat UniqueConstraint dan menambahkannya ke ConstraintCollection nilai DataTable DataColumn miliknya. Untuk informasi selengkapnya, lihat Batasan DataTable.

Untuk membuat hubungan antara DataColumn objek, buat DataRelation objek dan tambahkan ke DataRelationCollection dari DataSet.

Anda bisa menggunakan Expression properti DataColumn objek untuk menghitung nilai dalam kolom, atau membuat kolom agregat. Untuk informasi selengkapnya, lihat Membuat Kolom Ekspresi.

Konstruktor

DataColumn()	Menginisialisasi instans DataColumn baru kelas sebagai string jenis.
DataColumn(String)	Menginisialisasi instans DataColumn baru kelas, sebagai string jenis, menggunakan nama kolom yang ditentukan.
DataColumn(String, Type)	Menginisialisasi instans DataColumn baru kelas menggunakan nama kolom dan jenis data yang ditentukan.
DataColumn(String, Type, String)	Menginisialisasi instans DataColumn baru kelas menggunakan nama, jenis data, dan ekspresi yang ditentukan.
DataColumn(String, Type, String, MappingType)	Menginisialisasi instans DataColumn baru kelas menggunakan nama, jenis data, ekspresi, dan nilai yang ditentukan yang menentukan apakah kolom tersebut adalah atribut.

Properti

AllowDBNull	Mendapatkan atau mengatur nilai yang menunjukkan apakah nilai null diizinkan dalam kolom ini untuk baris yang termasuk dalam tabel.
AutoIncrement	Mendapatkan atau mengatur nilai yang menunjukkan apakah kolom secara otomatis menambah nilai kolom untuk baris baru yang ditambahkan ke tabel.
AutoIncrementSeed	Mendapatkan atau mengatur nilai awal untuk kolom yang propertinya AutoIncrement diatur ke `true`. Defaultnya adalah 0.
AutoIncrementStep	Mendapatkan atau mengatur kenaikan yang digunakan oleh kolom dengan propertinya AutoIncrement diatur ke `true`.
Caption	Mendapatkan atau mengatur caption untuk kolom.
ColumnMapping	Mendapatkan atau mengatur MappingType kolom.
ColumnName	Mendapatkan atau mengatur nama kolom di DataColumnCollection.
Container	Mendapatkan kontainer untuk komponen. (Diperoleh dari MarshalByValueComponent)
DataType	Mendapatkan atau mengatur jenis data yang disimpan dalam kolom.
DateTimeMode	Mendapatkan atau mengatur `DateTimeMode` untuk kolom.
DefaultValue	Mendapatkan atau mengatur nilai default untuk kolom saat Anda membuat baris baru.
DesignMode	Mendapatkan nilai yang menunjukkan apakah komponen saat ini dalam mode desain. (Diperoleh dari MarshalByValueComponent)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke komponen ini. (Diperoleh dari MarshalByValueComponent)
Expression	Mendapatkan atau mengatur ekspresi yang digunakan untuk memfilter baris, menghitung nilai dalam kolom, atau membuat kolom agregat.
ExtendedProperties	Mendapatkan kumpulan informasi pengguna kustom yang DataColumnterkait dengan .
MaxLength	Mendapatkan atau mengatur panjang maksimum kolom teks.
Namespace	Mendapatkan atau mengatur namespace DataColumnlayanan .
Ordinal	Mendapatkan posisi (berbasis nol) kolom dalam DataColumnCollection koleksi.
Prefix	Mendapatkan atau mengatur awalan XML yang alias namespace DataTablelayanan .
ReadOnly	Mendapatkan atau mengatur nilai yang menunjukkan apakah kolom memungkinkan perubahan segera setelah baris ditambahkan ke tabel.
Site	Mendapatkan atau mengatur situs komponen. (Diperoleh dari MarshalByValueComponent)
Table	Mendapatkan tempat DataTable kolom berada.
Unique	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai di setiap baris kolom harus unik.

Metode

CheckNotAllowNull()	Anggota ini mendukung infrastruktur .NET dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
CheckUnique()	Anggota ini mendukung infrastruktur .NET dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
Dispose()	Merilis semua sumber daya yang MarshalByValueComponentdigunakan oleh . (Diperoleh dari MarshalByValueComponent)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh MarshalByValueComponent dan secara opsional merilis sumber daya terkelola. (Diperoleh dari MarshalByValueComponent)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetService(Type)	Mendapatkan pelaksana IServiceProvider. (Diperoleh dari MarshalByValueComponent)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
OnPropertyChanging(PropertyChangedEventArgs)	Anggota ini mendukung infrastruktur .NET dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
RaisePropertyChanging(String)	Anggota ini mendukung infrastruktur .NET dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
SetOrdinal(Int32)	Mengubah ordinal atau posisi ke DataColumn ordinal atau posisi yang ditentukan.
ToString()	Expression Mendapatkan kolom, jika ada.

Acara

Disposed

Menambahkan penanganan aktivitas untuk mendengarkan Disposed peristiwa pada komponen.

(Diperoleh dari MarshalByValueComponent)

Metode Ekstensi

GetKeyedService<T>(IServiceProvider, Object)	Mendapatkan layanan jenis `T` dari IServiceProvider.
GetKeyedServices(IServiceProvider, Type, Object)	Mendapatkan enumerasi layanan jenis `serviceType` dari IServiceProvider.
GetKeyedServices<T>(IServiceProvider, Object)	Mendapatkan enumerasi layanan jenis `T` dari IServiceProvider.
GetRequiredKeyedService(IServiceProvider, Type, Object)	Mendapatkan layanan jenis `serviceType` dari IServiceProvider.
GetRequiredKeyedService<T>(IServiceProvider, Object)	Mendapatkan layanan jenis `T` dari IServiceProvider.
CreateAsyncScope(IServiceProvider)	Membuat baru AsyncServiceScope yang dapat digunakan untuk mengatasi layanan terlingkup.
CreateScope(IServiceProvider)	Membuat baru IServiceScope yang dapat digunakan untuk mengatasi layanan terlingkup.
GetRequiredService(IServiceProvider, Type)	Dapatkan layanan jenis `serviceType` dari IServiceProvider.
GetRequiredService<T>(IServiceProvider)	Dapatkan layanan jenis `T` dari IServiceProvider.
GetService<T>(IServiceProvider)	Dapatkan layanan jenis `T` dari IServiceProvider.
GetServices(IServiceProvider, Type)	Dapatkan enumerasi layanan jenis `serviceType` dari IServiceProvider.
GetServices<T>(IServiceProvider)	Dapatkan enumerasi layanan jenis `T` dari IServiceProvider.
GetFakeLogCollector(IServiceProvider)	Mendapatkan objek yang mengumpulkan rekaman log yang dikirim ke pencatat palsu.
GetFakeRedactionCollector(IServiceProvider)	Mendapatkan instans kolektor redactor palsu dari kontainer injeksi dependensi.

Berlaku untuk

Keamanan Thread

Jenis ini aman untuk operasi baca multithreaded. Anda harus menyinkronkan operasi tulis apa pun.