DataRow Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
-
DataRow
- Atributos
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 paiDataTable.
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 marcar programaticamente quais linhas são marcadas para remoção antes de realmente excluí-las. Para obter mais informações, confira Exclusão de DataRow.
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() | |
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() | |
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.