DataTable.PrimaryKey DataTable.PrimaryKey DataTable.PrimaryKey DataTable.PrimaryKey Property

정의

데이터 테이블에 대한 기본 키로 사용되는 열의 배열을 가져오거나 설정합니다.Gets or sets an array of columns that function as primary keys for the data table.

public:
 property cli::array <System::Data::DataColumn ^> ^ PrimaryKey { cli::array <System::Data::DataColumn ^> ^ get(); void set(cli::array <System::Data::DataColumn ^> ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Data.PrimaryKeyTypeConverter))]
[System.Data.DataSysDescription("DataTablePrimaryKeyDescr")]
public System.Data.DataColumn[] PrimaryKey { get; set; }
member this.PrimaryKey : System.Data.DataColumn[] with get, set
Public Property PrimaryKey As DataColumn()

속성 값

DataColumn 개체의 배열입니다.An array of DataColumn objects.

예외

해당 키가 외래 키인 경우The key is a foreign key.

예제

첫 번째 예제에 대 한 기본 키 열을 반환 하는 방법을 보여 줍니다는 DataTable 에 표시 되는 DataGrid합니다.The first example shows how to return the primary key columns for a DataTable displayed in a DataGrid. 두 번째 예제에 대 한 기본 키 열을 설정 하는 방법에 설명 된 DataTable합니다.The second example demonstrates how to set the primary key columns for a DataTable.

private void GetPrimaryKeys(DataTable table)
{
    // Create the array for the columns.
    DataColumn[] columns;
    columns = table.PrimaryKey;

    // Get the number of elements in the array.
    Console.WriteLine("Column Count: " + columns.Length);
    for(int i = 0; i < columns.Length; i++)
    {
        Console.WriteLine(columns[i].ColumnName + columns[i].DataType);
    }
}

private void SetPrimaryKeys()
{
    // Create a new DataTable and set two DataColumn objects as primary keys.
    DataTable table = new DataTable();
    DataColumn[] keys = new DataColumn[2];
    DataColumn column;

    // Create column 1.
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.String");
    column.ColumnName= "FirstName";

    // Add the column to the DataTable.Columns collection.
    table.Columns.Add(column);

    // Add the column to the array.
    keys[0] = column;

    // Create column 2 and add it to the array.
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.String");
    column.ColumnName = "LastName";
    table.Columns.Add(column);

    // Add the column to the array.
    keys[1] = column;

    // Set the PrimaryKeys property to the array.
    table.PrimaryKey = keys;
}
Private Sub GetPrimaryKeys(table As DataTable)
   ' Create the array for the columns.
   Dim columns() As DataColumn 
   columns = table.PrimaryKey

   ' Get the number of elements in the array.
   Console.WriteLine("Column Count: " & columns.Length.ToString())
   Dim i As Integer
   For i = 0 To columns.GetUpperBound(0)
      Console.WriteLine(columns(i).ColumnName & columns(i).DataType.ToString())
   Next i
End Sub

Private Sub SetPrimaryKeys()
   ' Create a new DataTable and set two DataColumn objects as primary keys.
   Dim table As DataTable = new DataTable()
   Dim keys(2) As DataColumn
   Dim column  As DataColumn

   ' Create column 1.
   column = New DataColumn()
   column.DataType = System.Type.GetType("System.String")
   column.ColumnName= "FirstName"

   ' Add the column to the DataTable.Columns collection.
   table.Columns.Add(column)
   ' Add the column to the array.
   keys(0) = column

   ' Create column 2 and add it to the array.
   column = New DataColumn()
   column.DataType = System.Type.GetType("System.String")
   column.ColumnName = "LastName"
   table.Columns.Add(column)

   ' Add the column to the array.
   keys(1) = column

   ' Set the PrimaryKeys property to the array.
   table.PrimaryKey = keys
End Sub

설명

테이블의 기본 키 테이블의 레코드를 식별 하는 고유 해야 합니다.The primary key of a table must be unique to identify the record in the table. 두 개 이상의 열으로 구성 하는 기본 키를 사용 하 여 테이블을 가질 수 이기도 합니다.It's also possible to have a table with a primary key made up of two or more columns. 이 단일 열 충분 한 고유 값을 포함할 수 없는 경우 발생 합니다.This occurs when a single column can't contain enough unique values. 예를 들어 두 개의 열 기본 키를 "FirstName" 및 "LastName" 열의 구성 될 수 있습니다.For example, a two column primary key might consist of a "FirstName" and "LastName" column. 기본 키 둘 이상의 열을 구성할 수 있으므로 합니다 PrimaryKey 속성의 배열로 구성 됩니다 DataColumn 개체입니다.Because primary keys can be made up of more than one column, the PrimaryKey property consists of an array of DataColumn objects.

적용 대상

추가 정보