DataRowView Classe
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente une vue personnalisée d’un DataRow.
public ref class DataRowView : System::ComponentModel::ICustomTypeDescriptor, System::ComponentModel::IDataErrorInfo, System::ComponentModel::IEditableObject, System::ComponentModel::INotifyPropertyChanged
public ref class DataRowView : System::ComponentModel::ICustomTypeDescriptor, System::ComponentModel::IDataErrorInfo, System::ComponentModel::IEditableObject
public class DataRowView : System.ComponentModel.ICustomTypeDescriptor, System.ComponentModel.IDataErrorInfo, System.ComponentModel.IEditableObject, System.ComponentModel.INotifyPropertyChanged
public class DataRowView : System.ComponentModel.ICustomTypeDescriptor, System.ComponentModel.IDataErrorInfo, System.ComponentModel.IEditableObject
type DataRowView = class
interface ICustomTypeDescriptor
interface IDataErrorInfo
interface IEditableObject
interface INotifyPropertyChanged
type DataRowView = class
interface ICustomTypeDescriptor
interface IEditableObject
interface IDataErrorInfo
type DataRowView = class
interface ICustomTypeDescriptor
interface IEditableObject
interface IDataErrorInfo
interface INotifyPropertyChanged
Public Class DataRowView
Implements ICustomTypeDescriptor, IDataErrorInfo, IEditableObject, INotifyPropertyChanged
Public Class DataRowView
Implements ICustomTypeDescriptor, IDataErrorInfo, IEditableObject
- Héritage
-
DataRowView
- Implémente
L’exemple suivant utilise la RowVersion propriété pour déterminer l’état d’une ligne dans le DataRowView. (Voir RowFilter pour un autre exemple d’utilisation DataRowViewde .)
private static void DemonstrateRowVersion()
{
// Create a DataTable with one column.
DataTable table = new DataTable("Table");
DataColumn column = new DataColumn("Column");
table.Columns.Add(column);
// Add ten rows.
DataRow row;
for (int i = 0; i < 10; i++)
{
row = table.NewRow();
row["Column"] = "item " + i;
table.Rows.Add(row);
}
table.AcceptChanges();
// Create a DataView with the table.
DataView view = new DataView(table);
// Change one row's value:
table.Rows[1]["Column"] = "Hello";
// Add one row:
row = table.NewRow();
row["Column"] = "World";
table.Rows.Add(row);
// Set the RowStateFilter to display only added
// and modified rows.
view.RowStateFilter = DataViewRowState.Added |
DataViewRowState.ModifiedCurrent;
// Print those rows. Output includes "Hello" and "World".
PrintView(view, "ModifiedCurrent and Added");
// Set filter to display only originals of modified rows.
view.RowStateFilter = DataViewRowState.ModifiedOriginal;
PrintView(view, "ModifiedOriginal");
// Delete three rows.
table.Rows[1].Delete();
table.Rows[2].Delete();
table.Rows[3].Delete();
// Set the RowStateFilter to display only deleted rows.
view.RowStateFilter = DataViewRowState.Deleted;
PrintView(view, "Deleted");
// Set filter to display only current rows.
view.RowStateFilter = DataViewRowState.CurrentRows;
PrintView(view, "Current");
// Set filter to display only unchanged rows.
view.RowStateFilter = DataViewRowState.Unchanged;
PrintView(view, "Unchanged");
// Set filter to display only original rows.
// Current values of unmodified rows are also returned.
view.RowStateFilter = DataViewRowState.OriginalRows;
PrintView(view, "OriginalRows");
}
private static void PrintView(DataView view, string label)
{
Console.WriteLine("\n" + label);
for (int i = 0; i < view.Count; i++)
{
Console.WriteLine(view[i]["Column"]);
Console.WriteLine("DataViewRow.RowVersion: {0}",
view[i].RowVersion);
}
}
Private Sub DemonstrateRowVersion()
Dim i As Integer
' Create a DataTable with one column.
Dim table As New DataTable("Table")
Dim column As New DataColumn("Column")
table.Columns.Add(column)
' Add ten rows.
Dim row As DataRow
For i = 0 To 9
row = table.NewRow()
row("Column") = "item " + i.ToString()
table.Rows.Add(row)
Next i
table.AcceptChanges()
' Create a DataView with the table.
Dim view As New DataView(table)
' Change one row's value:
table.Rows(1)("Column") = "Hello"
' Add one row:
row = table.NewRow()
row("Column") = "World"
table.Rows.Add(row)
' Set the RowStateFilter to display only added and modified rows.
view.RowStateFilter = _
DataViewRowState.Added Or DataViewRowState.ModifiedCurrent
' Print those rows. Output includes "Hello" and "World".
PrintView(view, "ModifiedCurrent and Added")
' Set filter to display only originals of modified rows.
view.RowStateFilter = DataViewRowState.ModifiedOriginal
PrintView(view, "ModifiedOriginal")
' Delete three rows.
table.Rows(1).Delete()
table.Rows(2).Delete()
table.Rows(3).Delete()
' Set the RowStateFilter to display only deleted rows.
view.RowStateFilter = DataViewRowState.Deleted
PrintView(view, "Deleted")
' Set filter to display only current rows.
view.RowStateFilter = DataViewRowState.CurrentRows
PrintView(view, "Current")
' Set filter to display only unchanged rows.
view.RowStateFilter = DataViewRowState.Unchanged
PrintView(view, "Unchanged")
' Set filter to display only original rows.
' Current values of unmodified rows are also returned.
view.RowStateFilter = DataViewRowState.OriginalRows
PrintView(view, "OriginalRows")
End Sub
Private Sub PrintView(ByVal view As DataView, ByVal label As String)
Console.WriteLine(ControlChars.Cr + label)
Dim i As Integer
For i = 0 To view.Count - 1
Console.WriteLine(view(i)("Column"))
Console.WriteLine("DataRowView.RowVersion: {0}", _
view(i).RowVersion)
Next i
End Sub
Chaque fois que des données sont affichées, par exemple dans un DataGrid contrôle, une seule version de chaque ligne peut être affichée. La ligne affichée est un DataRowView.
Un DataRowView peut avoir l’un des quatre états de version différents : Default
, Original
, Current
et Proposed
.
Après l’appel BeginEdit sur un DataRow, toute valeur modifiée devient la Proposed
valeur . Tant que CancelEdit ou EndEdit n’est pas appelé, la ligne a une Original
version et une Proposed
version. Si CancelEdit est appelé, la version proposée est ignorée et la valeur revient à Original
. Si EndEdit est appelé, le DataRowView n’a plus de Proposed
version ; au lieu de cela, la valeur proposée devient la valeur actuelle. Les valeurs par défaut sont disponibles uniquement sur les lignes qui ont des colonnes avec des valeurs par défaut définies.
Data |
Obtient le DataView auquel cette ligne appartient. |
Is |
Indique si la ligne est en mode édition. |
Is |
Indique si DataRowView est nouveau. |
Item[Int32] |
Obtient ou définit une valeur dans une colonne spécifiée. |
Item[String] |
Obtient ou définit une valeur dans une colonne spécifiée. |
Row |
Obtient le DataRow actuellement affiché. |
Row |
Obtient la description de la version actuelle de DataRow. |
Begin |
Commence une procédure de modification. |
Cancel |
Annule une procédure de modification. |
Create |
Retourne DataView pour le DataTable enfant avec la DataRelation enfant spécifiée. |
Create |
Retourne un DataView pour le DataTable enfant avec le DataRelation et le parent spécifiés. |
Create |
Retourne DataView pour le DataTable enfant avec le nom DataRelation enfant spécifié. |
Create |
Retourne une DataView pour le DataTable enfant avec le nom DataRelation et le parent spécifiés. |
Delete() |
Supprime une ligne. |
End |
Valide les modifications apportées à la DataRow sous-jacente et met fin à la session d'édition qui a été démarrée avec BeginEdit(). Utilise CancelEdit() pour supprimer les modifications apportées à DataRow. |
Equals(Object) |
Obtient une valeur indiquant si le DataRowView actuel est identique à l'objet spécifié. |
Get |
Retourne le code de hachage de l'objet DataRow. |
Get |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
Memberwise |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
To |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Property |
Événement qui est déclenché lorsqu'une propriété DataRowView est modifiée. |
ICustom |
Retourne une collection d’attributs personnalisés pour cette instance d’un composant. |
ICustom |
Retourne le nom de classe de cette instance d’un composant. |
ICustom |
Retourne le nom de cette instance d’un composant. |
ICustom |
Retourne un convertisseur de type pour cette instance d’un composant. |
ICustom |
Retourne l’événement par défaut pour cette instance d’un composant. |
ICustom |
Retourne la propriété par défaut pour cette instance d’un composant. |
ICustom |
Retourne un éditeur du type spécifié pour cette instance d’un composant. |
ICustom |
Retourne les événements pour cette instance d’un composant. |
ICustom |
Retourne les événements pour cette instance d'un composant avec des attributs spécifiés. |
ICustom |
Retourne les propriétés pour cette instance d’un composant. |
ICustom |
Retourne les propriétés pour cette instance d'un composant avec des attributs spécifiés. |
ICustom |
Retourne un objet qui contient la propriété décrite par le descripteur de propriété spécifié. |
IData |
Obtient un message qui décrit les erreurs de validation pour l'objet. |
IData |
Obtient le message d'erreur pour la propriété portant le nom donné. |
Ce type est sécurisé pour les opérations de lecture multithread. Vous devez synchroniser toutes les opérations d’écriture.
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :