Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DataTable.PrimaryKey propriété

 

Date de publication : novembre 2016

Obtient ou définit un tableau de colonnes qui fonctionnent comme des clés primaires pour la table de données.

Espace de noms:   System.Data
Assembly:  System.Data (dans System.Data.dll)

public DataColumn[] PrimaryKey { get; set; }

Valeur de propriété

Type: System.Data.DataColumn[]

Tableau d'objets DataColumn.

Exception Condition
DataException

La clé est une clé étrangère.

La clé primaire d’une table doit être unique pour identifier l’enregistrement dans la table. Il est également possible d’avoir une table avec une clé primaire composée de deux ou plusieurs colonnes. Cela se produit lorsqu’une seule colonne ne peut pas contenir suffisamment de valeurs uniques. Par exemple, une colonne « FirstName » et « LastName » peut comporter une clé primaire de deux colonnes. Étant donné que les clés primaires peuvent être composées de plusieurs colonnes, la PrimaryKey propriété se compose d’un tableau de DataColumn objets.

Le premier exemple montre comment retourner les colonnes de clé primaire pour une DataTable affichées dans une DataGrid. Le deuxième exemple montre comment définir les colonnes de clé primaire pour une 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;
}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: