DataRow Classe

  • Referência

Definição

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Representa uma linha de dados em um DataTable.

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

Exemplos

O exemplo a seguir cria um novo DataRow chamando o NewRow método do DataTable objeto .

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 e DataColumn são componentes primários de um DataTable. Use o DataRow objeto e suas propriedades e métodos para recuperar e avaliar; e inserir, excluir e atualizar os valores no DataTable. O DataRowCollection representa os objetos reais DataRow no DataTablee o DataColumnCollection contém os DataColumn objetos que descrevem o esquema do DataTable. Use a propriedade sobrecarregada Item[] para retornar ou definir o valor de um DataColumn.

Use as HasVersion propriedades e IsNull para determinar o status de um valor de linha específico e a RowState propriedade para determinar o estado da linha em relação ao seu pai DataTable.

Para criar um novo DataRow, use o NewRow método do DataTable objeto . Depois de criar um novo DataRow, use o Add método para adicionar o novo DataRow ao DataRowCollection. Por fim, chame o AcceptChanges método do DataTable objeto para confirmar a adição. Para obter mais informações sobre como adicionar dados a um DataTable, consulte Adicionando dados a uma DataTable.

Você pode excluir um DataRow do DataRowCollection chamando o Remove método do DataRowCollectionou chamando o Delete método do DataRow objeto . O Remove método remove a linha da coleção. Por outro lado, Delete marca o DataRow para remoção. A remoção real ocorre quando você chama AcceptChanges o método . Ao chamar Delete, você pode verificar programaticamente quais linhas estão marcadas para remoção antes de realmente excluí-las. Para obter mais informações, consulte DataRow Deletion.

Construtores

DataRow(DataRowBuilder)

Inicializa uma nova instância da classe DataRow usando o construtor especificado. Somente para uso interno.

Propriedades

HasErrors

Obtém um valor que indica se há erros em uma linha.
Item[DataColumn, DataRowVersion]

Obtém a versão especificada de dados armazenados no DataColumn especificado.
Item[DataColumn]

Obtém ou define os dados armazenados no DataColumn especificado.
Item[Int32, DataRowVersion]

Obtém os dados armazenados na coluna, especificados pelo índice e a versão dos dados a serem recuperados.
Item[Int32]

Obtém ou define os dados armazenados na coluna especificada por índice.
Item[String, DataRowVersion]

Obtém a versão especificada de dados armazenados na coluna nomeada.
Item[String]

Obtém ou define os dados armazenados na coluna especificada por nome.
ItemArray

Obtém ou define todos os valores para essa linha por meio de uma matriz.
RowError

Obtém ou define a descrição de erro personalizada de uma linha.
RowState

Obtém o estado atual da linha no que diz respeito à sua relação com o DataRowCollection.
Table

Obtém o DataTable para o qual essa linha tem um esquema.

Métodos

AcceptChanges()

Confirma todas as alterações feitas nessa linha desde a última vez que AcceptChanges() foi chamado.
BeginEdit()

Inicia uma operação de edição em um objeto DataRow.
CancelEdit()

Cancela a edição atual da linha.
ClearErrors()

Limpa os erros da linha. Isso inclui o RowError e erros definidos com SetColumnError(Int32, String).
Delete()

Exclui o DataRow.
EndEdit()

Finaliza a edição que ocorre na linha.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetChildRows(DataRelation)

Obtém as linhas filho deste DataRow usando o DataRelation especificado.
GetChildRows(DataRelation, DataRowVersion)

Obtém as linhas filho de um DataRow usando o DataRelation especificado e DataRowVersion.
GetChildRows(String)

Obtém as linhas filhas de uma DataRow usando o RelationName especificado de uma DataRelation.
GetChildRows(String, DataRowVersion)

Obtém as linhas filho de uma DataRow usando o RelationName especificado de uma DataRelation e DataRowVersion.
GetColumnError(DataColumn)

Obtém a descrição de erro da DataColumn especificada.
GetColumnError(Int32)

Obtém a descrição do erro da coluna especificada pelo índice.
GetColumnError(String)

Obtém a descrição do erro da coluna, especificada pelo nome.
GetColumnsInError()

Obtém uma matriz de colunas que contêm erros.
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetParentRow(DataRelation)

Obtém a linha pai de um DataRow usando o DataRelation especificado.
GetParentRow(DataRelation, DataRowVersion)

Obtém a linha pai de um DataRow usando o DataRelatione DataRowVersion.
GetParentRow(String)

Obtém a linha pai de um DataRow usando o RelationName especificado de uma DataRelation.
GetParentRow(String, DataRowVersion)

Obtém a linha pai de um DataRow usando o RelationName especificado de uma DataRelation e DataRowVersion.
GetParentRows(DataRelation)

Obtém as linhas pai de um DataRow usando o DataRelation especificado.
GetParentRows(DataRelation, DataRowVersion)

Obtém as linhas pai de um DataRow usando a DataRelation especificada e a DataRowVersion.
GetParentRows(String)

Obtém as linhas pai de um DataRow usando o RelationName especificado de uma DataRelation.
GetParentRows(String, DataRowVersion)

Obtém as linhas pai de um DataRow usando o RelationName especificado de um DataRelation e a DataRowVersion.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
HasVersion(DataRowVersion)

Obtém um valor que indica se existe uma versão especificada.
IsNull(DataColumn)

Obtém um valor que indica se o DataColumn especificado contém um valor null.
IsNull(DataColumn, DataRowVersion)

Obtém um valor que indica se o DataColumn e DataRowVersion especificados contêm um valor nulo.
IsNull(Int32)

Obtém um valor que indica se a coluna no índice especificado contém um valor nulo.
IsNull(String)

Obtém um valor que indica se a coluna nomeada contém um valor null.
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
RejectChanges()

Rejeita todas as alterações feitas na linha desde que AcceptChanges() foi chamado pela última vez.
SetAdded()

Altera o RowState de um DataRow para Added.
SetColumnError(DataColumn, String)

Define a descrição do erro para uma coluna especificada como um DataColumn.
SetColumnError(Int32, String)

Define a descrição do erro da coluna especificada pelo índice.
SetColumnError(String, String)

Define a descrição do erro da coluna especificada pelo nome.
SetModified()

Altera o RowState de um DataRow para Modified.
SetNull(DataColumn)

Define o valor do DataColumn especificado para um valor nulo.
SetParentRow(DataRow)

Define a linha pai de um DataRow com novo pai especificado DataRow.
SetParentRow(DataRow, DataRelation)

Define a linha pai de um DataRow com novo pai especificado DataRow e DataRelation.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(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. O método Field<T>(DataRow, DataColumn) também dá suporte a tipos que permitem valor nulo.
Field<T>(DataRow, DataColumn, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, DataColumn, DataRowVersion) também dá suporte a tipos que permitem valor nulo.
Field<T>(DataRow, Int32)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, Int32) também dá suporte a tipos que permitem valor nulo.
Field<T>(DataRow, Int32, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, Int32, DataRowVersion) também dá suporte a tipos que permitem valor nulo.
Field<T>(DataRow, String)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, String) também dá suporte a tipos que permitem valor nulo.
Field<T>(DataRow, String, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, String, DataRowVersion) também dá suporte a tipos que permitem valor nulo.
SetField<T>(DataRow, DataColumn, T)

Define um novo valor para a coluna especificada no DataRow. O método SetField<T>(DataRow, DataColumn, T) também dá suporte a tipos que permitem valor nulo.
SetField<T>(DataRow, Int32, T)

Define um novo valor para a coluna especificada na DataRow em que o método é chamado. O método SetField<T>(DataRow, Int32, T) também dá suporte a tipos que permitem valor nulo.
SetField<T>(DataRow, String, T)

Define um novo valor para a coluna especificada no DataRow. O método SetField<T>(DataRow, String, T) também dá suporte a tipos que permitem valor nulo.

Aplica-se a

Acesso thread-safe

Este tipo é seguro para operações de leitura e multithread. Você deve sincronizar todas as operações de gravação.

Confira também