Freigeben über


DataSet.ExtendedProperties-Eigenschaft

Ruft die dem DataSet zugeordnete Auflistung von benutzerdefinierten Benutzerinformationen ab.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public ReadOnly Property ExtendedProperties As PropertyCollection
'Usage
Dim instance As DataSet
Dim value As PropertyCollection

value = instance.ExtendedProperties
public PropertyCollection ExtendedProperties { get; }
public:
property PropertyCollection^ ExtendedProperties {
    PropertyCollection^ get ();
}
/** @property */
public PropertyCollection get_ExtendedProperties ()
public function get ExtendedProperties () : PropertyCollection

Eigenschaftenwert

Eine PropertyCollection mit sämtlichen benutzerdefinierten Benutzerinformationen.

Hinweise

Mithilfe der ExtendedProperties-Eigenschaft können Sie benutzerdefinierte Informationen mit dem DataSet speichern. Sie können z. B. einen Zeitpunkt speichern, zu dem die Daten aktualisiert werden sollen.

Erweiterte Eigenschaften müssen vom Typ String sein, wenn sie beim Schreiben von DataSet als XML beibehalten werden sollen.

Beispiel

Im folgenden Beispiel wird der von der ExtendedProperties-Eigenschaft zurückgegebenen PropertyCollection eine benutzerdefinierte Eigenschaft hinzugefügt. Im zweiten Beispiel wird die benutzerdefinierte Eigenschaft abgerufen.

Private Sub DemonstrateEnforceConstraints()
    ' Create a DataSet with one table, one column and 
    ' a UniqueConstraint.
    Dim dataSet As DataSet = New DataSet("dataSet")
    Dim table As DataTable = New DataTable("table")
    Dim column As DataColumn = New DataColumn("col1")
    column.Unique = True
    table.Columns.Add(column)
    dataSet.Tables.Add(table)
    Console.WriteLine("constraints.count: " _
        & table.Constraints.Count)

    ' add five rows.
    Dim row As DataRow
    Dim i As Integer
    For i = 0 To 4
       row = table.NewRow()
       row("col1") = i
       table.Rows.Add(row)
    Next
    table.AcceptChanges()
     
    dataSet.EnforceConstraints = False
    ' Change the values of all rows to 1.
    Dim thisRow As DataRow
    For Each thisRow In table.rows
       thisRow("col1") = 1
    Next
 
    Try
        dataSet.EnforceConstraints = True
    Catch e As System.Data.ConstraintException
        ' Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.", _
            e.GetType().ToString())
    End Try
End Sub
private void DemonstrateEnforceConstraints()
{
    // Create a DataSet with one table, one column and 
    // a UniqueConstraint.
    DataSet dataSet= new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn column = new DataColumn("col1");

    // A UniqueConstraint is added when the Unique 
    // property is true.
    column.Unique=true;
    table.Columns.Add(column);
    dataSet.Tables.Add(table);
    Console.WriteLine("constraints.count: " + 
        table.Constraints.Count);

    // add five rows.
    DataRow row ;
    for(int i=0;i<5;i++)
    {
        row = table.NewRow();
        row["col1"] = i;
        table.Rows.Add(row);
    }
    table.AcceptChanges();

    dataSet.EnforceConstraints=false;
    // Change the values of all rows to 1.
    foreach(DataRow thisRow in table.Rows)
    {
        thisRow["col1"]=1;
        //Console.WriteLine("\table" + thisRow[0]);
    }
    try
    {
        dataSet.EnforceConstraints=true;
    }
    catch(System.Data.ConstraintException e)
    {
        // Process exception and return.
        Console.WriteLine("Exception of type {0} occurred.", 
            e.GetType());
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataSet-Klasse
DataSet-Member
System.Data-Namespace

Weitere Ressourcen

Verwenden von DataSets in ADO.NET