DataRow.ItemArray Proprietà

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Origine:

DataRow.cs

Ottiene o imposta tutti i valori per la riga mediante una matrice.

public object?[] ItemArray { get; set; }

Valore della proprietà

Object[]

Matrice di tipo Object.

Eccezioni

ArgumentException

La matrice è maggiore del numero di colonne nella tabella.

InvalidCastException

Mancata corrispondenza tra un valore nella matrice e la relativa proprietà DataType nella classe DataColumn corrispondente.

ConstraintException

Un vincolo è stato interrotto da un'operazione di modifica.

ReadOnlyException

Si è tentato di modificare il valore di una colonna in sola lettura.

NoNullAllowedException

Si è tentato di immettere un valore null in una colonna in cui la proprietà AllowDBNull dell'oggetto DataColumn è false.

DeletedRowInaccessibleException

La riga è stata eliminata.

Esempio

Negli esempi seguenti viene illustrato come ottenere e impostare i valori usando la ItemArray proprietà .

private void CreateRowsWithItemArray()
{
    // Make a DataTable using the function below.
    DataTable dt = MakeTableWithAutoIncrement();
    DataRow relation;
    // Declare the array variable.
    object [] rowArray = new object[2];
    // Create 10 new rows and add to DataRowCollection.
    for(int i = 0; i <10; i++)
    {
        rowArray[0]=null;
        rowArray[1]= "item " + i;
        relation = dt.NewRow();
        relation.ItemArray = rowArray;
        dt.Rows.Add(relation);
    }
    PrintTable(dt);
}

private DataTable MakeTableWithAutoIncrement()
{
    // Make a table with one AutoIncrement column.
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement = true;
    idColumn.AutoIncrementSeed = 10;
    table.Columns.Add(idColumn);

    DataColumn firstNameColumn = new DataColumn("Item",
        Type.GetType("System.String"));
    table.Columns.Add(firstNameColumn);
    return table;
}

private void PrintTable(DataTable table)
{
    foreach(DataRow row in table.Rows)
    {
        foreach(DataColumn column in table.Columns)
        {
            Console.WriteLine(row[column]);
        }
    }
}

Commenti

È possibile usare questa proprietà per impostare o ottenere valori per questa riga tramite una matrice. Se si usa questa proprietà per impostare i valori, la matrice deve avere le stesse dimensioni e l'ordinamento della raccolta di colonne. null ItemArray Il passaggio indica che non è stato specificato alcun valore.

Gli utenti possono generare eccezioni nell'evento o nell'evento ColumnChangingRowChanging .

Si applica a

Vedi anche

• AcceptChanges()
• AutoIncrement
• DataColumn