DataRow Classe

Definição

Representa uma linha de dados em um DataTable.Represents a row of data in a DataTable.

public ref class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
Public Class DataRow
Herança
DataRow
Atributos

Exemplos

O exemplo a seguir cria um DataRow novo chamando o NewRow método do DataTable objeto.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

Comentários

Os DataRow objetos DataColumn e são componentes primários de DataTableum.The DataRow and DataColumn objects are primary components of a DataTable. Use o DataRow objeto e suas propriedades e métodos para recuperar e avaliar; e inserir, excluir e atualizar os valores DataTableno.Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. O DataRowCollection representa os objetos DataRow reais DataTable DataColumn no, e DataTablecontém os objetos que descrevem o esquema do. DataColumnCollectionThe DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. Use a Item[String, DataRowVersion] Propriedade sobrecarregada para retornar ou definir o valor DataColumnde a.Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

Use as HasVersion propriedades IsNull e para determinar o status de um valor de linha específico e a RowState propriedade para determinar o estado da linha em relação a seu pai 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.

Para criar um novo DataRow, use o NewRow método do DataTable objeto.To create a new DataRow, use the NewRow method of the DataTable object. Depois de criar um DataRownovo, use Add o método para DataRowCollectionadicionar o DataRow novo ao.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. Por fim, chame AcceptChanges o método DataTable do objeto para confirmar a adição.Finally, call the AcceptChanges method of the DataTable object to confirm the addition. Para obter mais informações sobre como adicionar dados DataTablea um, consulte adicionando dados a uma DataTable.For more information about adding data to a DataTable, see Adding Data to a DataTable.

Você pode excluir um DataRow DataRowCollection do Remove Delete DataRow chamando o método do ou chamando o método do objeto. DataRowCollectionYou 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. O Remove método remove a linha da coleção.The Remove method removes the row from the collection. Por outro lado Delete , o DataRow marca o para remoção.In contrast, Delete marks the DataRow for removal. A remoção real ocorre quando você chama AcceptChanges o método.The actual removal occurs when you call AcceptChanges method. Ao chamar Delete, você pode verificar programaticamente quais linhas são marcadas para remoção antes de excluí-las.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. Para obter mais informações, consulte exclusão de DataRow.For more information, see DataRow Deletion.

Construtores

DataRow(DataRowBuilder)

Inicializa uma nova instância do DataRow.Initializes a new instance of the DataRow. Constrói uma linha do construtor.Constructs a row from the builder. Somente para uso interno.Only for internal usage.

Propriedades

HasErrors

Obtém um valor que indica se há erros em uma linha.Gets a value that indicates whether there are errors in a row.

Item[DataColumn, DataRowVersion]

Obtém a versão especificada de dados armazenados no DataColumn especificado.Gets the specified version of data stored in the specified DataColumn.

Item[DataColumn]

Obtém ou define os dados armazenados no DataColumn especificado.Gets or sets the data stored in the specified DataColumn.

Item[Int32, DataRowVersion]

Obtém os dados armazenados na coluna, especificados pelo índice e a versão dos dados a serem recuperados.Gets the data stored in the column, specified by index and version of the data to retrieve.

Item[Int32]

Obtém ou define os dados armazenados na coluna especificada por índice.Gets or sets the data stored in the column specified by index.

Item[String, DataRowVersion]

Obtém a versão especificada de dados armazenados na coluna nomeada.Gets the specified version of data stored in the named column.

Item[String]

Obtém ou define os dados armazenados na coluna especificada por nome.Gets or sets the data stored in the column specified by name.

ItemArray

Obtém ou define todos os valores para essa linha por meio de uma matriz.Gets or sets all the values for this row through an array.

RowError

Obtém ou define a descrição de erro personalizada de uma linha.Gets or sets the custom error description for a row.

RowState

Obtém o estado atual da linha no que diz respeito à sua relação com o DataRowCollection.Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table

Obtém o DataTable para o qual essa linha tem um esquema.Gets the DataTable for which this row has a schema.

Métodos

AcceptChanges()

Confirma todas as alterações feitas nessa linha desde a última vez que AcceptChanges() foi chamado.Commits all the changes made to this row since the last time AcceptChanges() was called.

BeginEdit()

Inicia uma operação de edição em um objeto DataRow.Starts an edit operation on a DataRow object.

CancelEdit()

Cancela a edição atual da linha.Cancels the current edit on the row.

ClearErrors()

Limpa os erros da linha.Clears the errors for the row. Isso inclui o RowError e erros definidos com SetColumnError(Int32, String).This includes the RowError and errors set with SetColumnError(Int32, String).

Delete()

Exclui o DataRow.Deletes the DataRow.

EndEdit()

Finaliza a edição que ocorre na linha.Ends the edit occurring on the row.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetChildRows(DataRelation)

Obtém as linhas filho deste DataRow usando o DataRelation especificado.Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion)

Obtém as linhas filho de um DataRow usando o DataRelation especificado e DataRowVersion.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String)

Obtém as linhas filhas de uma DataRow usando o RelationName especificado de uma DataRelation.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(String, DataRowVersion)

Obtém as linhas filho de uma DataRow usando o RelationName especificado de uma DataRelation e DataRowVersion.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetColumnError(DataColumn)

Obtém a descrição de erro da DataColumn especificada.Gets the error description of the specified DataColumn.

GetColumnError(Int32)

Obtém a descrição do erro da coluna especificada pelo índice.Gets the error description for the column specified by index.

GetColumnError(String)

Obtém a descrição do erro da coluna, especificada pelo nome.Gets the error description for a column, specified by name.

GetColumnsInError()

Obtém uma matriz de colunas que contêm erros.Gets an array of columns that have errors.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetParentRow(DataRelation)

Obtém a linha pai de um DataRow usando o DataRelation especificado.Gets the parent row of a DataRow using the specified DataRelation.

GetParentRow(DataRelation, DataRowVersion)

Obtém a linha pai de um DataRow usando o DataRelatione DataRowVersion.Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRow(String)

Obtém a linha pai de um DataRow usando o RelationName especificado de uma DataRelation.Gets the parent row of a DataRow using the specified RelationName of a DataRelation.

GetParentRow(String, DataRowVersion)

Obtém a linha pai de um DataRow usando o RelationName especificado de uma DataRelation e DataRowVersion.Gets the parent row of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetParentRows(DataRelation)

Obtém as linhas pai de um DataRow usando o DataRelation especificado.Gets the parent rows of a DataRow using the specified DataRelation.

GetParentRows(DataRelation, DataRowVersion)

Obtém as linhas pai de um DataRow usando a DataRelation especificada e a DataRowVersion.Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String)

Obtém as linhas pai de um DataRow usando o RelationName especificado de uma DataRelation.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation.

GetParentRows(String, DataRowVersion)

Obtém as linhas pai de um DataRow usando o RelationName especificado de um DataRelation e a DataRowVersion.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
HasVersion(DataRowVersion)

Obtém um valor que indica se existe uma versão especificada.Gets a value that indicates whether a specified version exists.

IsNull(DataColumn)

Obtém um valor que indica se o DataColumn especificado contém um valor null.Gets a value that indicates whether the specified DataColumn contains a null value.

IsNull(DataColumn, DataRowVersion)

Obtém um valor que indica se o DataColumn e DataRowVersion especificados contêm um valor nulo.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

IsNull(Int32)

Obtém um valor que indica se a coluna no índice especificado contém um valor nulo.Gets a value that indicates whether the column at the specified index contains a null value.

IsNull(String)

Obtém um valor que indica se a coluna nomeada contém um valor null.Gets a value that indicates whether the named column contains a null value.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
RejectChanges()

Rejeita todas as alterações feitas na linha desde que AcceptChanges() foi chamado pela última vez.Rejects all changes made to the row since AcceptChanges() was last called.

SetAdded()

Altera o RowState de um DataRow para Added.Changes the RowState of a DataRow to Added.

SetColumnError(DataColumn, String)

Define a descrição do erro para uma coluna especificada como um DataColumn.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

Define a descrição do erro da coluna especificada pelo índice.Sets the error description for a column specified by index.

SetColumnError(String, String)

Define a descrição do erro da coluna especificada pelo nome.Sets the error description for a column specified by name.

SetModified()

Altera o RowState de um DataRow para Modified.Changes the RowState of a DataRow to Modified.

SetNull(DataColumn)

Define o valor do DataColumn especificado para um valor nulo.Sets the value of the specified DataColumn to a null value.

SetParentRow(DataRow)

Define a linha pai de um DataRow com novo pai especificado DataRow.Sets the parent row of a DataRow with specified new parent DataRow.

SetParentRow(DataRow, DataRelation)

Define a linha pai de um DataRow com novo pai especificado DataRow e DataRelation.Sets the parent row of a DataRow with specified new parent DataRow and DataRelation.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Métodos de Extensão

Field<T>(DataRow, DataColumn)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, DataColumn) também dá suporte a tipos que permitem valor nulo.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, DataColumn, DataRowVersion) também dá suporte a tipos que permitem valor nulo.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, Int32) também dá suporte a tipos que permitem valor nulo.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, Int32, DataRowVersion) também dá suporte a tipos que permitem valor nulo.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, String) também dá suporte a tipos que permitem valor nulo.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, String, DataRowVersion) também dá suporte a tipos que permitem valor nulo.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

SetField<T>(DataRow, DataColumn, T)

Define um novo valor para a coluna especificada no DataRow.Sets a new value for the specified column in the DataRow. O método SetField<T>(DataRow, DataColumn, T) também dá suporte a tipos que permitem valor nulo.The SetField<T>(DataRow, DataColumn, T) method also supports nullable types.

SetField<T>(DataRow, Int32, T)

Define um novo valor para a coluna especificada na DataRow em que o método é chamado.Sets a new value for the specified column in the DataRow the method is called on. O método SetField<T>(DataRow, Int32, T) também dá suporte a tipos que permitem valor nulo.The SetField<T>(DataRow, Int32, T) method also supports nullable types.

SetField<T>(DataRow, String, T)

Define um novo valor para a coluna especificada no DataRow.Sets a new value for the specified column in the DataRow. O método SetField<T>(DataRow, String, T) também dá suporte a tipos que permitem valor nulo.The SetField<T>(DataRow, String, T) method also supports nullable types.

Aplica-se a

Acesso thread-safe

Este tipo é seguro para operações de leitura e multithread.This type is safe for multithreaded read operations. Você deve sincronizar todas as operações de gravação.You must synchronize any write operations.

Veja também