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

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.

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

Bagikan melalui