DataRow Classe

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à
DataRow
Attributi

Esempi

Nell'esempio seguente viene creato un DataRow nuovo chiamando il NewRow metodo dell' 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 New DataTable("Names") 

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

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

    Dim lNameColumn As 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

Gli DataRow oggetti DataColumn e sono componenti primari di un DataTableoggetto.The DataRow and DataColumn objects are primary components of a DataTable. Utilizzare l' DataRow oggetto e le relative proprietà e metodi per recuperare e valutare, nonché inserire, eliminare e aggiornare i valori DataTablein.Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. DataTable DataRow DataTableRappresenta gli oggetti effettivi DataColumn in e contiene gli oggetti che descrivono lo schema di. DataColumnCollection DataRowCollectionThe DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. Utilizzare la Item[String, DataRowVersion] proprietà di overload per restituire o impostare il valore di un oggetto DataColumn.Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

Usare le HasVersion proprietà IsNull e per determinare lo stato di un valore di riga particolare e la RowState proprietà per determinare lo stato della riga rispetto al relativo elemento 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 un nuovo DataRow, usare il NewRow metodo dell' DataTable oggetto.To create a new DataRow, use the NewRow method of the DataTable object. Dopo la creazione di DataRowun nuovo oggetto Add , utilizzare il metodo per DataRow DataRowCollectionaggiungere il nuovo oggetto a.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Infine, chiamare il AcceptChanges metodo DataTable dell'oggetto per confermare l'aggiunta.Finally, call the AcceptChanges method of the DataTable object to confirm the addition. Per ulteriori informazioni sull'aggiunta di dati a DataTableun, 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 DataRowCollection da chiamando il Remove metodo dell' DataRowCollection DataRow oggetto oppure chiamando il Delete metodo dell'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 contrassegna per DataRow la rimozione.In contrast, Delete marks the DataRow for removal. La rimozione effettiva si verifica quando si AcceptChanges chiama il metodo.The actual removal occurs when you call AcceptChanges method. Chiamando Delete, è possibile verificare a livello di codice le righe contrassegnate per la rimozione prima di eliminarle effettivamente.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. Per ulteriori informazioni, vedere eliminazione di DataRow.For more information, see DataRow Deletion.

Costruttori

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

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

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]

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

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]

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]

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

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.

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.

RowError

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

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

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

Metodi

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()

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

CancelEdit()

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

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()

Elimina l'oggetto DataRow.Deletes the DataRow.

EndEdit()

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

Equals(Object)

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

(Ereditato da Object)
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)

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)

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)

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)

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

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)

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

GetColumnsInError()

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

GetHashCode()

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

(Ereditato da Object)
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)

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)

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)

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)

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)

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)

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)

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()

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

(Ereditato da Object)
HasVersion(DataRowVersion)

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

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)

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)

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)

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()

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

(Ereditato da Object)
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()

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

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)

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)

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

SetModified()

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

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)

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)

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()

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

(Ereditato da Object)

Metodi di estensione

Field<T>(DataRow, DataColumn)

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

Field<T>(DataRow, DataColumn, DataRowVersion)

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

Field<T>(DataRow, Int32)

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

Field<T>(DataRow, Int32, DataRowVersion)

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

Field<T>(DataRow, String)

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

Field<T>(DataRow, String, DataRowVersion)

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

SetField<T>(DataRow, DataColumn, T)

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

SetField<T>(DataRow, Int32, T)

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

SetField<T>(DataRow, String, T)

Imposta un nuovo valore per la colonna specificata nell'oggetto DataRow.Sets a new value for the specified column in the DataRow. Il metodo SetField<T>(DataRow, String, T) 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 multithread.This type is safe for multithreaded read operations. È necessario sincronizzare le operazioni di scrittura.You must synchronize any write operations.

Vedi anche