DataRowView Classe

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Source:

DataRowView.cs

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 class DataRowView : System.ComponentModel.ICustomTypeDescriptor, System.ComponentModel.IDataErrorInfo, System.ComponentModel.IEditableObject, System.ComponentModel.INotifyPropertyChanged

type DataRowView = class
    interface ICustomTypeDescriptor
    interface IDataErrorInfo
    interface IEditableObject
    interface INotifyPropertyChanged

Public Class DataRowView
Implements ICustomTypeDescriptor, IDataErrorInfo, IEditableObject, INotifyPropertyChanged

Héritage

Object

DataRowView

Implémente

ICustomTypeDescriptor IDataErrorInfo IEditableObject INotifyPropertyChanged

Exemples

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

Remarques

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, Currentet 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.

Propriétés

DataView	Obtient le DataView auquel cette ligne appartient.
IsEdit	Indique si la ligne est en mode édition.
IsNew	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é.
RowVersion	Obtient la description de la version actuelle de DataRow.

Méthodes

BeginEdit()	Commence une procédure de modification.
CancelEdit()	Annule une procédure de modification.
CreateChildView(DataRelation)	Retourne DataView pour le DataTable enfant avec la DataRelation enfant spécifiée.
CreateChildView(DataRelation, Boolean)	Retourne un DataView pour le DataTable enfant avec le DataRelation et le parent spécifiés.
CreateChildView(String)	Retourne DataView pour le DataTable enfant avec le nom DataRelation enfant spécifié.
CreateChildView(String, Boolean)	Retourne une DataView pour le DataTable enfant avec le nom DataRelation et le parent spécifiés.
Delete()	Supprime une ligne.
EndEdit()	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é.
GetHashCode()	Retourne le code de hachage de l'objet DataRow.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

PropertyChanged

Événement qui est déclenché lorsqu'une propriété DataRowView est modifiée.

Implémentations d’interfaces explicites

ICustomTypeDescriptor.GetAttributes()	Retourne une collection d’attributs personnalisés pour cette instance d’un composant.
ICustomTypeDescriptor.GetClassName()	Retourne le nom de classe de cette instance d’un composant.
ICustomTypeDescriptor.GetComponentName()	Retourne le nom de cette instance d’un composant.
ICustomTypeDescriptor.GetConverter()	Retourne un convertisseur de type pour cette instance d’un composant.
ICustomTypeDescriptor.GetDefaultEvent()	Retourne l’événement par défaut pour cette instance d’un composant.
ICustomTypeDescriptor.GetDefaultProperty()	Retourne la propriété par défaut pour cette instance d’un composant.
ICustomTypeDescriptor.GetEditor(Type)	Retourne un éditeur du type spécifié pour cette instance d’un composant.
ICustomTypeDescriptor.GetEvents()	Retourne les événements pour cette instance d’un composant.
ICustomTypeDescriptor.GetEvents(Attribute[])	Retourne les événements pour cette instance d'un composant avec des attributs spécifiés.
ICustomTypeDescriptor.GetProperties()	Retourne les propriétés pour cette instance d’un composant.
ICustomTypeDescriptor.GetProperties(Attribute[])	Retourne les propriétés pour cette instance d'un composant avec des attributs spécifiés.
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Retourne un objet qui contient la propriété décrite par le descripteur de propriété spécifié.
IDataErrorInfo.Error	Obtient un message qui décrit les erreurs de validation pour l'objet.
IDataErrorInfo.Item[String]	Obtient le message d'erreur pour la propriété portant le nom donné.

Cohérence de thread

Ce type est sécurisé pour les opérations de lecture multithread. Vous devez synchroniser toutes les opérations d’écriture.

Voir aussi

• DataRow