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