Export (0) Print
Expand All

DataSet.ExtendedProperties Property

Gets the collection of customized user information associated with the DataSet.

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

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

value = instance.ExtendedProperties

/** @property */
public PropertyCollection get_ExtendedProperties ()

public function get ExtendedProperties () : PropertyCollection

Property Value

A PropertyCollection with all custom user information.

The ExtendedProperties property enables you to store custom information with the DataSet. For example, you might store a time when the data should be refreshed.

Extended properties must be of type String if you want them persisted when the DataSet is written as XML.

The following example adds a custom property to the PropertyCollection returned by the ExtendedProperties property. The second example retrieves the custom property.

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

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft