DataRow Classe
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta una riga di dati in un oggetto DataTable.
public ref class DataRow
public class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
[<System.Serializable>]
type DataRow = class
Public Class DataRow
- Ereditarietà
-
DataRow
- Attributi
Nell'esempio seguente viene creato un nuovo DataRow oggetto chiamando il NewRow metodo dell'oggetto DataTable .
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
Gli DataRow oggetti e DataColumn sono componenti principali di un oggetto DataTable. Utilizzare l'oggetto DataRow e le relative proprietà e metodi per recuperare e valutare; e inserire, eliminare e aggiornare i valori in DataTable. Rappresenta DataRowCollection gli oggetti effettivi DataRow in DataTablee DataColumnCollection contiene gli DataColumn oggetti che descrivono lo schema dell'oggetto DataTable. Utilizzare la proprietà di Item[] overload per restituire o impostare il valore di un oggetto DataColumn.
Utilizzare le HasVersion proprietà e IsNull per determinare lo stato di un determinato valore di riga e la RowState proprietà per determinare lo stato della riga rispetto al relativo padre DataTable.
Per creare un nuovo DataRowoggetto , utilizzare il NewRow metodo dell'oggetto DataTable . Dopo aver creato un nuovo DataRowoggetto , usare il Add metodo per aggiungere il nuovo DataRow oggetto a DataRowCollection. Infine, chiamare il AcceptChanges metodo dell'oggetto DataTable per confermare l'aggiunta. Per altre informazioni sull'aggiunta di dati a un DataTableoggetto , vedere Aggiunta di dati a una tabella DataTable.
È possibile eliminare un DataRow oggetto da DataRowCollection chiamando il Remove metodo di DataRowCollectionoppure chiamando il Delete metodo dell'oggetto DataRow . Il Remove metodo rimuove la riga dall'insieme. Al contrario, Delete contrassegna l'oggetto per la DataRow rimozione. La rimozione effettiva si verifica quando si chiama AcceptChanges il metodo . DeleteChiamando , è possibile controllare a livello di codice quali righe sono contrassegnate per la rimozione prima di eliminarle effettivamente. Per altre informazioni, vedere Eliminazione di DataRow.
Data |
Inizializza una nuova istanza della classe DataRow utilizzando il generatore specificato. Solo per uso interno. |
Has |
Ottiene un valore che indica se sono presenti errori in una riga. |
Item[Data |
Ottiene la versione specificata dei dati archiviati nell'oggetto DataColumn specificato. |
Item[Data |
Ottiene o imposta i dati archiviati nell'oggetto DataColumn specificato. |
Item[Int32, Data |
Ottiene i dati archiviati nella colonna specificata in base all'indice e alla versione dei dati da recuperare. |
Item[Int32] |
Ottiene o imposta i dati archiviati nella colonna specificata in base all'indice. |
Item[String, Data |
Ottiene la versione specificata dei dati archiviati nella colonna specificata. |
Item[String] |
Ottiene o imposta i dati archiviati nella colonna specificata in base al nome. |
Item |
Ottiene o imposta tutti i valori per la riga mediante una matrice. |
Row |
Ottiene o imposta la descrizione personalizzata dell'errore di una riga. |
Row |
Ottiene lo stato corrente della riga rispetto alla relativa relazione con la classe DataRowCollection. |
Table |
Ottiene l'oggetto DataTable di cui è presente uno schema in questa riga. |
Accept |
Conferma tutte le modifiche apportate a questa riga dall'ultima chiamata al metodo AcceptChanges(). |
Begin |
Avvia un'operazione di modifica su un oggetto DataRow. |
Cancel |
Annulla la modifica corrente sulla riga. |
Clear |
Cancella gli errori della riga. Ciò include la proprietà RowError e gli errori impostati con il metodo SetColumnError(Int32, String). |
Delete() |
Elimina l'oggetto DataRow. |
End |
Chiude il processo di modifica della riga. |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
Get |
Ottiene le righe figlio di questo oggetto DataRow utilizzando l'oggetto DataRelation specificato. |
Get |
Ottiene le righe figlio di un oggetto DataRow utilizzando gli oggetti DataRelation e DataRowVersion specificati. |
Get |
Ottiene le righe figlio di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation. |
Get |
Ottiene le righe figlio di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation e DataRowVersion. |
Get |
Ottiene la descrizione dell'errore dell'oggetto DataColumn specificato. |
Get |
Ottiene la descrizione dell'errore per la colonna specificata in base all'indice. |
Get |
Ottiene la descrizione dell'errore per una colonna specificata in base al nome. |
Get |
Ottiene una matrice delle colonne che contengono errori. |
Get |
Funge da funzione hash predefinita. (Ereditato da Object) |
Get |
Ottiene la riga padre di un oggetto DataRow utilizzando l'oggetto DataRelation specificato. |
Get |
Ottiene la riga padre di un oggetto DataRow utilizzando gli oggetti DataRelation e DataRowVersion specificati. |
Get |
Ottiene la riga padre di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation. |
Get |
Ottiene la riga padre di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation e DataRowVersion. |
Get |
Ottiene le righe padre di un oggetto DataRow utilizzando l'oggetto DataRelation specificato. |
Get |
Ottiene le righe padre di un oggetto DataRow utilizzando gli oggetti DataRelation e DataRowVersion specificati. |
Get |
Ottiene le righe padre di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation. |
Get |
Ottiene le righe padre di un oggetto DataRow utilizzando la proprietà RelationName specificata di un oggetto DataRelation e DataRowVersion. |
Get |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
Has |
Ottiene un valore che indica se esiste una versione specificata. |
Is |
Ottiene un valore che indica se nella classe DataColumn specificata è presente un valore null. |
Is |
Ottiene un valore che indica se nella classe DataColumn e nell'enumerazione DataRowVersion specificate è presente un valore null. |
Is |
Ottiene un valore che indica se nella colonna è presente un valore null in corrispondenza dell'indice specificato. |
Is |
Ottiene un valore che indica se nella colonna denominata è presente un valore null. |
Memberwise |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
Reject |
Rifiuta tutte le modifiche apportate alla riga sin dall'ultima chiamata al metodo AcceptChanges(). |
Set |
Modifica la proprietà RowState di una classe DataRow in |
Set |
Imposta la descrizione dell'errore per una colonna specificata come oggetto DataColumn. |
Set |
Imposta la descrizione dell'errore per una colonna specificata in base all'indice. |
Set |
Imposta la descrizione dell'errore per una colonna specificata in base al nome. |
Set |
Modifica la proprietà RowState di una classe DataRow in |
Set |
Imposta il valore della classe DataColumn specificata su un valore null. |
Set |
Imposta la riga padre di un oggetto DataRow con il nuovo oggetto DataRow padre specificato. |
Set |
Imposta la riga padre di un oggetto DataRow con il nuovo oggetto DataRow e il nuovo oggetto DataRelation padre specificati. |
To |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Field<T>(Data |
Fornisce accesso fortemente tipizzato a ognuno dei valori della colonna nella riga specificata. Il metodo Field<T>(DataRow, DataColumn) supporta anche tipi nullable. |
Field<T>(Data |
Fornisce accesso fortemente tipizzato a ognuno dei valori della colonna nella riga specificata. Il metodo Field<T>(DataRow, DataColumn, DataRowVersion) supporta anche tipi nullable. |
Field<T>(Data |
Fornisce accesso fortemente tipizzato a ognuno dei valori della colonna nella riga specificata. Il metodo Field<T>(DataRow, Int32) supporta anche tipi nullable. |
Field<T>(Data |
Fornisce accesso fortemente tipizzato a ognuno dei valori della colonna nella riga specificata. Il metodo Field<T>(DataRow, Int32, DataRowVersion) supporta anche tipi nullable. |
Field<T>(Data |
Fornisce accesso fortemente tipizzato a ognuno dei valori della colonna nella riga specificata. Il metodo Field<T>(DataRow, String) supporta anche tipi nullable. |
Field<T>(Data |
Fornisce accesso fortemente tipizzato a ognuno dei valori della colonna nella riga specificata. Il metodo Field<T>(DataRow, String, DataRowVersion) supporta anche tipi nullable. |
Set |
Imposta un nuovo valore per la colonna specificata nell'oggetto DataRow. Il metodo SetField<T>(DataRow, DataColumn, T) supporta anche tipi nullable. |
Set |
Imposta un nuovo valore per la colonna specificata nell'oggetto DataRow su cui viene chiamato il metodo. Il metodo SetField<T>(DataRow, Int32, T) supporta anche tipi nullable. |
Set |
Imposta un nuovo valore per la colonna specificata nell'oggetto DataRow. Il metodo SetField<T>(DataRow, String, T) supporta anche tipi nullable. |
Prodotto | Versioni |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Questo tipo è sicuro per le operazioni di lettura multithreading. È necessario sincronizzare tutte le operazioni di scrittura.
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: