Bagikan melalui

DataColumn.AutoIncrement Properti

  • 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

Mendapatkan atau mengatur nilai yang menunjukkan apakah kolom secara otomatis menambah nilai kolom untuk baris baru yang ditambahkan ke tabel.

public:
 property bool AutoIncrement { bool get(); void set(bool value); };
public bool AutoIncrement { get; set; }
[System.Data.DataSysDescription("DataColumnAutoIncrementDescr")]
public bool AutoIncrement { get; set; }
member this.AutoIncrement : bool with get, set
[<System.Data.DataSysDescription("DataColumnAutoIncrementDescr")>]
member this.AutoIncrement : bool with get, set
Public Property AutoIncrement As Boolean

Nilai Properti

Boolean

true jika nilai kolom berangsur-angsur secara otomatis; jika tidak, false. Default adalah false.

Atribut
DataSysDescriptionAttribute

Pengecualian

ArgumentException

Kolom adalah kolom komputasi.

Contoh

Contoh berikut mengatur AutoIncrementproperti , AutoIncrementSeed, dan AutoIncrementStep .

private void AddAutoIncrementColumn()
{
    DataColumn column = new DataColumn();
    column.DataType = System.Type.GetType("System.Int32");
    column.AutoIncrement = true;
    column.AutoIncrementSeed = 1000;
    column.AutoIncrementStep = 10;

    // Add the column to a new DataTable.
    DataTable table = new DataTable("table");
    table.Columns.Add(column);
}

Private Sub AddAutoIncrementColumn()
    Dim column As New DataColumn()
    column.DataType = System.Type.GetType("System.Int32")
    With column
        .AutoIncrement = True
        .AutoIncrementSeed = 1000
        .AutoIncrementStep = 10
    End With

    ' Add the column to a new DataTable.
    Dim table As DataTable
    table = New DataTable
    table.Columns.Add(column)
End Sub

Keterangan

Jika jenis kolom ini bukan Int16, Int32, atau Int64 saat properti ini diatur, DataType properti dipaksa ke Int32. Pengecualian dihasilkan jika ini adalah kolom komputasi. Properti Expression diatur. Nilai yang ditambahkan hanya digunakan jika nilai baris untuk kolom ini, saat ditambahkan ke koleksi kolom, sama dengan nilai default.

Anda dapat membuat baris baru menggunakan ItemArray properti DataRow kelas dan meneruskan array nilai. Ini adalah masalah potensial untuk kolom dengan AutoIncrement diatur ke true, karena nilainya dihasilkan secara otomatis. Untuk menggunakan ItemArray properti , tempatkan null di posisi kolom dalam array. Untuk informasi selengkapnya, lihat properti ItemArray kelas DataRow.

Jika jenis kolom adalah SqlInt16 atau SqlInt32, AutoIncrement tidak akan berfungsi. Gunakan Int16 atau Int32 sebagai gantinya.

Jika jenis kolom adalah SqlInt64 atau SqlDecimal, AutoIncrement hanya akan berfungsi sebagian. Gunakan Int64 atau Desimal sebagai gantinya.

AutoIncrementStep Ketika nilai ditambahkan ke nilai saat ini, pemeriksaan luapan ditekan.

Berlaku untuk

Lihat juga