Bagikan melalui


DataColumn Kelas

Definisi

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

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

Lihat juga