DataColumn.AutoIncrement Özellik

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Kaynak:

DataColumn.cs

Sütunun tabloya eklenen yeni satırlar için sütun değerini otomatik olarak artırıp artırmadığını belirten bir değer alır veya ayarlar.

public:
 property bool AutoIncrement { bool get(); void set(bool value); };

public bool AutoIncrement { get; set; }

member this.AutoIncrement : bool with get, set

Public Property AutoIncrement As Boolean

Özellik Değeri

Boolean

true sütunun değeri otomatik olarak artarsa; aksi takdirde , false. Varsayılan değer: false.

Özel durumlar

ArgumentException

sütun hesaplanan bir sütundur.

Örnekler

Aşağıdaki örnek , AutoIncrementSeedve AutoIncrementStep özelliklerini ayarlarAutoIncrement.

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

Açıklamalar

Bu özellik ayarlandığında bu sütunun türü Int16, Int32 veya Int64 değilse, DataType özellik Int32 olarak zorunludur. Bu bir hesaplanan sütunsa bir özel durum oluşturulur. Expression özelliği ayarlanır. Artımlı değer yalnızca sütun koleksiyonuna eklendiğinde bu sütun için satırın değeri varsayılan değere eşitse kullanılır.

sınıfının özelliğini DataRow kullanarak ItemArray ve bir değer dizisi geçirerek yeni bir satır oluşturabilirsiniz. Değeri otomatik olarak oluşturulduğundan, bu, değerine ayarlanmış truebir sütun AutoIncrement için olası bir sorundur. özelliğini kullanmak ItemArray için, sütunun dizideki konumuna yerleştirin null . Daha fazla bilgi için sınıfının özelliğine DataRow bakınItemArray.

Sütunun türü veya SqlInt32AutoIncrement ise SqlInt16 çalışmaz. Bunun yerine Int16 veya Int32 kullanın.

Sütunun türü veya SqlDecimalAutoIncrement iseSqlInt64, yalnızca kısmen çalışır. Bunun yerine Int64 veya Decimal kullanın.

AutoIncrementStep Değer geçerli değere eklendiğinde taşma denetimi gösterilmez.

Ayrıca bkz.

• AutoIncrementSeed
• AutoIncrementStep
• Expression
• ItemArray
• NewRow()
• ADO.NET'de DataSet'leri Kullanma