DataRow DataRow DataRow DataRow Class

Definizione

Rappresenta una riga di dati in un oggetto DataTable.Represents a row of data in a DataTable.

public ref class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
Public Class DataRow
Ereditarietà
DataRowDataRowDataRowDataRow
Attributi

Esempi

L'esempio seguente crea una nuova DataRow chiamando il NewRow metodo il DataTable oggetto.The following example creates a new DataRow by calling the NewRow method of the DataTable object.

private void CreateNewDataRow()
{
    // Use the MakeTable function below to create a new table.
    DataTable table;
    table = MakeNamesTable();

    // Once a table has been created, use the 
    // NewRow to create a DataRow.
    DataRow row;
    row = table.NewRow();

    // Then add the new row to the collection.
    row["fName"] = "John";
    row["lName"] = "Smith";
    table.Rows.Add(row);

    foreach(DataColumn column in table.Columns)
        Console.WriteLine(column.ColumnName);
    dataGrid1.DataSource=table;
}

private DataTable MakeNamesTable()
{
    // Create a new DataTable titled 'Names.'
    DataTable namesTable = new DataTable("Names"); 

    // Add three column objects to the table.
    DataColumn idColumn = new  DataColumn();
    idColumn.DataType = System.Type.GetType("System.Int32");
    idColumn.ColumnName = "id";
    idColumn.AutoIncrement = true;
    namesTable.Columns.Add(idColumn);

    DataColumn fNameColumn = new DataColumn();
    fNameColumn.DataType = System.Type.GetType("System.String");
    fNameColumn.ColumnName = "Fname";
    fNameColumn.DefaultValue = "Fname";
    namesTable.Columns.Add(fNameColumn);

    DataColumn lNameColumn = new DataColumn();
    lNameColumn.DataType = System.Type.GetType("System.String");
    lNameColumn.ColumnName = "LName";
    namesTable.Columns.Add(lNameColumn);

    // Create an array for DataColumn objects.
    DataColumn [] keys = new DataColumn [1];
    keys[0] = idColumn;
    namesTable.PrimaryKey = keys;

    // Return the new DataTable.
    return namesTable;
}
Private Sub CreateNewDataRow()
    ' Use the MakeTable function below to create a new table.
    Dim table As DataTable
    table = MakeNamesTable()

    ' Once a table has been created, use the 
    ' NewRow to create a DataRow.
    Dim row As DataRow 
    row = table.NewRow()

    ' Then add the new row to the collection.
    row("fName") = "John"
    row("lName") = "Smith"
    table.Rows.Add(row)
    
    Dim column As DataColumn
    For Each column in table.Columns
       Console.WriteLine(column.ColumnName)
    Next
    DataGrid1.DataSource=table
 End Sub
 
 Private Function MakeNamesTable() As DataTable
    ' Create a new DataTable titled 'Names.'
    Dim namesTable As DataTable = new DataTable("Names") 

    ' Add three column objects to the table.
    Dim idColumn As DataColumn = new  DataColumn()
    idColumn.DataType = System.Type.GetType("System.Int32")
    idColumn.ColumnName = "id"
    idColumn.AutoIncrement = True
    namesTable.Columns.Add(idColumn)

    Dim fNameColumn As DataColumn = New DataColumn()
    fNameColumn.DataType = System.Type.GetType("System.String")
    fNameColumn.ColumnName = "Fname"
    fNameColumn.DefaultValue = "Fname"
    namesTable.Columns.Add(fNameColumn)

    Dim lNameColumn As DataColumn = new DataColumn()
    lNameColumn.DataType = System.Type.GetType("System.String")
    lNameColumn.ColumnName = "LName"
    namesTable.Columns.Add(lNameColumn)

    ' Create an array for DataColumn objects.
    Dim keys(0) As DataColumn 
    keys(0) = idColumn
    namesTable.PrimaryKey = keys

    ' Return the new DataTable.
    MakeNamesTable = namesTable
 End Function

Commenti

Il DataRow e DataColumn gli oggetti sono componenti principali di un DataTable.The DataRow and DataColumn objects are primary components of a DataTable. Usare la DataRow oggetto e relative proprietà e metodi per recuperare e valuta; e inserire, eliminare e aggiornare i valori nel DataTable.Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. Il DataRowCollection rappresenta l'effettivo DataRow gli oggetti nel DataTablee il DataColumnCollection contiene il DataColumn oggetti che descrivono lo schema del DataTable.The DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. Usare l'overload Item[String, DataRowVersion] proprietà da restituire oppure impostare il valore di un DataColumn.Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

Usare la HasVersion e IsNull delle proprietà per determinare lo stato di un valore di riga specifico e il RowState proprietà per determinare lo stato della riga rispetto al padre DataTable.Use the HasVersion and IsNull properties to determine the status of a particular row value, and the RowState property to determine the state of the row relative to its parent DataTable.

Per creare una nuova DataRow, usare il NewRow metodo il DataTable oggetto.To create a new DataRow, use the NewRow method of the DataTable object. Dopo aver creato un nuovo DataRow, usare il Add per aggiungere il nuovo metodo DataRow per il DataRowCollection.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Infine, chiamare il AcceptChanges metodo del DataTable oggetto per confermare l'aggiunta.Finally, call the AcceptChanges method of the DataTable object to confirm the addition. Per altre informazioni sull'aggiunta di dati da un DataTable, vedere aggiunta di dati a un oggetto DataTable.For more information about adding data to a DataTable, see Adding Data to a DataTable.

È possibile eliminare un DataRow dal DataRowCollection chiamando il Remove metodo il DataRowCollection, o chiamando il Delete metodo del DataRow oggetto.You can delete a DataRow from the DataRowCollection by calling the Remove method of the DataRowCollection, or by calling the Delete method of the DataRow object. Il Remove metodo rimuove la riga dalla raccolta.The Remove method removes the row from the collection. Al contrario, Delete segni di DataRow per la rimozione.In contrast, Delete marks the DataRow for removal. La rimozione effettiva si verifica quando si chiama AcceptChanges (metodo).The actual removal occurs when you call AcceptChanges method. Chiamando Delete, è possibile controllare a livello di programmazione le righe contrassegnate per la rimozione prima dell'eliminazione effettiva.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. Per altre informazioni, vedere eliminazione di DataRow.For more information, see DataRow Deletion.

Costruttori

DataRow(DataRowBuilder) DataRow(DataRowBuilder) DataRow(DataRowBuilder) DataRow(DataRowBuilder)

Inizializza un' istanza nuova di DataRow.Initializes a new instance of the DataRow. Costruisce una riga dal generatore.Constructs a row from the builder. Solo per uso interno.Only for internal usage.

Proprietà

HasErrors HasErrors HasErrors HasErrors

Ottiene un valore che indica se sono presenti errori in una riga.Gets a value that indicates whether there are errors in a row.

ItemArray ItemArray ItemArray ItemArray

Ottiene o imposta tutti i valori per la riga mediante una matrice.Gets or sets all the values for this row through an array.

Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion]

Ottiene la versione specificata dei dati archiviati nell'oggetto DataColumn specificato.Gets the specified version of data stored in the specified DataColumn.

Item[DataColumn] Item[DataColumn] Item[DataColumn] Item[DataColumn]

Ottiene o imposta i dati archiviati nell'oggetto DataColumn specificato.Gets or sets the data stored in the specified DataColumn.

Item[Int32, DataRowVersion] Item[Int32, DataRowVersion] Item[Int32, DataRowVersion] Item[Int32, DataRowVersion]

Ottiene i dati archiviati nella colonna specificata in base all'indice e alla versione dei dati da recuperare.Gets the data stored in the column, specified by index and version of the data to retrieve.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ottiene o imposta i dati archiviati nella colonna specificata in base all'indice.Gets or sets the data stored in the column specified by index.

Item[String, DataRowVersion] Item[String, DataRowVersion] Item[String, DataRowVersion] Item[String, DataRowVersion]

Ottiene la versione specificata dei dati archiviati nella colonna specificata.Gets the specified version of data stored in the named column.

Item[String] Item[String] Item[String] Item[String]

Ottiene o imposta i dati archiviati nella colonna specificata in base al nome.Gets or sets the data stored in the column specified by name.

RowError RowError RowError RowError

Ottiene o imposta la descrizione personalizzata dell'errore di una riga.Gets or sets the custom error description for a row.

RowState RowState RowState RowState

Ottiene lo stato corrente della riga rispetto alla relativa relazione con la classe DataRowCollection.Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table Table Table Table

Ottiene l'oggetto DataTable di cui è presente uno schema in questa riga.Gets the DataTable for which this row has a schema.

Metodi

AcceptChanges() AcceptChanges() AcceptChanges() AcceptChanges()

Conferma tutte le modifiche apportate a questa riga dall'ultima chiamata al metodo AcceptChanges().Commits all the changes made to this row since the last time AcceptChanges() was called.

BeginEdit() BeginEdit() BeginEdit() BeginEdit()

Avvia un'operazione di modifica su un oggetto DataRow.Starts an edit operation on a DataRow object.

CancelEdit() CancelEdit() CancelEdit() CancelEdit()

Annulla la modifica corrente sulla riga.Cancels the current edit on the row.

ClearErrors() ClearErrors() ClearErrors() ClearErrors()

Cancella gli errori della riga.Clears the errors for the row. Ciò include la proprietà RowError e gli errori impostati con il metodo SetColumnError(Int32, String).This includes the RowError and errors set with SetColumnError(Int32, String).

Delete() Delete() Delete() Delete()

Elimina l'oggetto DataRow.Deletes the DataRow.

EndEdit() EndEdit() EndEdit() EndEdit()

Chiude il processo di modifica della riga.Ends the edit occurring on the row.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation)

Ottiene le righe figlio di questo oggetto DataRow utilizzando l'oggetto DataRelation specificato.Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion)

Ottiene le righe figlio di un oggetto DataRow utilizzando gli oggetti DataRelation e DataRowVersion specificati.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String) GetChildRows(String) GetChildRows(String) GetChildRows(String)

Ottiene le righe figlio di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion)

Ottiene le righe figlio di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation e DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetColumnError(DataColumn) GetColumnError(DataColumn) GetColumnError(DataColumn) GetColumnError(DataColumn)

Ottiene la descrizione dell'errore dell'oggetto DataColumn specificato.Gets the error description of the specified DataColumn.

GetColumnError(Int32) GetColumnError(Int32) GetColumnError(Int32) GetColumnError(Int32)

Ottiene la descrizione dell'errore per la colonna specificata in base all'indice.Gets the error description for the column specified by index.

GetColumnError(String) GetColumnError(String) GetColumnError(String) GetColumnError(String)

Ottiene la descrizione dell'errore per una colonna specificata in base al nome.Gets the error description for a column, specified by name.

GetColumnsInError() GetColumnsInError() GetColumnsInError() GetColumnsInError()

Ottiene una matrice delle colonne che contengono errori.Gets an array of columns that have errors.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetParentRow(DataRelation) GetParentRow(DataRelation) GetParentRow(DataRelation) GetParentRow(DataRelation)

Ottiene la riga padre di un oggetto DataRow utilizzando l'oggetto DataRelation specificato.Gets the parent row of a DataRow using the specified DataRelation.

GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion)

Ottiene la riga padre di un oggetto DataRow utilizzando gli oggetti DataRelation e DataRowVersion specificati.Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRow(String) GetParentRow(String) GetParentRow(String) GetParentRow(String)

Ottiene la riga padre di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation.Gets the parent row of a DataRow using the specified RelationName of a DataRelation.

GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion)

Ottiene la riga padre di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation e DataRowVersion.Gets the parent row of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetParentRows(DataRelation) GetParentRows(DataRelation) GetParentRows(DataRelation) GetParentRows(DataRelation)

Ottiene le righe padre di un oggetto DataRow utilizzando l'oggetto DataRelation specificato.Gets the parent rows of a DataRow using the specified DataRelation.

GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion)

Ottiene le righe padre di un oggetto DataRow utilizzando gli oggetti DataRelation e DataRowVersion specificati.Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String) GetParentRows(String) GetParentRows(String) GetParentRows(String)

Ottiene le righe padre di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation.

GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion)

Ottiene le righe padre di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation e DataRowVersion.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
HasVersion(DataRowVersion) HasVersion(DataRowVersion) HasVersion(DataRowVersion) HasVersion(DataRowVersion)

Ottiene un valore che indica se esiste una versione specificata.Gets a value that indicates whether a specified version exists.

IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn)

Ottiene un valore che indica se nella classe DataColumn specificata è presente un valore null.Gets a value that indicates whether the specified DataColumn contains a null value.

IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion)

Ottiene un valore che indica se nella classe DataColumn e nell'enumerazione DataRowVersion specificate è presente un valore null.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

IsNull(Int32) IsNull(Int32) IsNull(Int32) IsNull(Int32)

Ottiene un valore che indica se nella colonna è presente un valore null in corrispondenza dell'indice specificato.Gets a value that indicates whether the column at the specified index contains a null value.

IsNull(String) IsNull(String) IsNull(String) IsNull(String)

Ottiene un valore che indica se nella colonna denominata è presente un valore null.Gets a value that indicates whether the named column contains a null value.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
RejectChanges() RejectChanges() RejectChanges() RejectChanges()

Rifiuta tutte le modifiche apportate alla riga sin dall'ultima chiamata al metodo AcceptChanges().Rejects all changes made to the row since AcceptChanges() was last called.

SetAdded() SetAdded() SetAdded() SetAdded()

Modifica la proprietà RowState di una classe DataRow in Added.Changes the RowState of a DataRow to Added.

SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String)

Imposta la descrizione dell'errore per una colonna specificata come oggetto DataColumn.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String)

Imposta la descrizione dell'errore per una colonna specificata in base all'indice.Sets the error description for a column specified by index.

SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String)

Imposta la descrizione dell'errore per una colonna specificata in base al nome.Sets the error description for a column specified by name.

SetModified() SetModified() SetModified() SetModified()

Modifica la proprietà RowState di una classe DataRow in Modified.Changes the RowState of a DataRow to Modified.

SetNull(DataColumn) SetNull(DataColumn) SetNull(DataColumn) SetNull(DataColumn)

Imposta il valore della classe DataColumn specificata su un valore null.Sets the value of the specified DataColumn to a null value.

SetParentRow(DataRow) SetParentRow(DataRow) SetParentRow(DataRow) SetParentRow(DataRow)

Imposta la riga padre di un oggetto DataRow con il nuovo oggetto DataRow padre specificato.Sets the parent row of a DataRow with specified new parent DataRow.

SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation)

Imposta la riga padre di un oggetto DataRow con il nuovo oggetto DataRow e il nuovo oggetto DataRelation padre specificati.Sets the parent row of a DataRow with specified new parent DataRow and DataRelation.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Extension Methods

Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn)

Fornisce accesso fortemente tipizzato a ognuno dei valori di colonna nella riga specificata.Provides strongly-typed access to each of the column values in the specified row. Il Field<T>(DataRow, DataColumn) metodo supporta anche tipi nullable.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion)

Fornisce accesso fortemente tipizzato a ognuno dei valori di colonna nella riga specificata.Provides strongly-typed access to each of the column values in the specified row. Il Field<T>(DataRow, DataColumn, DataRowVersion) metodo supporta anche tipi nullable.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32)

Fornisce accesso fortemente tipizzato a ognuno dei valori di colonna nella riga specificata.Provides strongly-typed access to each of the column values in the specified row. Il Field<T>(DataRow, Int32) metodo supporta anche tipi nullable.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion)

Fornisce accesso fortemente tipizzato a ognuno dei valori di colonna nella riga specificata.Provides strongly-typed access to each of the column values in the specified row. Il Field<T>(DataRow, Int32, DataRowVersion) metodo supporta anche tipi nullable.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String) Field<T>(DataRow, String) Field<T>(DataRow, String) Field<T>(DataRow, String)

Fornisce accesso fortemente tipizzato a ognuno dei valori di colonna nella riga specificata.Provides strongly-typed access to each of the column values in the specified row. Il Field<T>(DataRow, String) metodo supporta anche tipi nullable.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion)

Fornisce accesso fortemente tipizzato a ognuno dei valori di colonna nella riga specificata.Provides strongly-typed access to each of the column values in the specified row. Il Field<T>(DataRow, String, DataRowVersion) metodo supporta anche tipi nullable.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T)

Imposta un nuovo valore per la colonna specificata nel DataRow.Sets a new value for the specified column in the DataRow. Il SetField<T>(DataRow, DataColumn, T) metodo supporta anche tipi nullable.The SetField<T>(DataRow, DataColumn, T) method also supports nullable types.

SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T)

Imposta un nuovo valore per la colonna specificata nel DataRow il metodo viene chiamato su.Sets a new value for the specified column in the DataRow the method is called on. Il SetField<T>(DataRow, Int32, T) metodo supporta anche tipi nullable.The SetField<T>(DataRow, Int32, T) method also supports nullable types.

SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T)

Imposta un nuovo valore per la colonna specificata nel DataRow.Sets a new value for the specified column in the DataRow. Il SetField<T>(DataRow, String, T) metodo supporta anche tipi nullable.The SetField<T>(DataRow, String, T) method also supports nullable types.

Si applica a

Thread safety

Questo tipo è sicuro per le operazioni di lettura a thread multipli.This type is safe for multithreaded read operations. È necessario sincronizzare qualsiasi operazione di scrittura.You must synchronize any write operations.

Vedi anche