This topic has not yet been rated - Rate this topic

DataRelation.RelationName Property

.NET Framework 3.5

Other Versions

Gets or sets the name used to retrieve a DataRelation from the DataRelationCollection.

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

Syntax

C++

JScript

public virtual string RelationName { get; set; }

Property Value

Type: System.String
The name of the a DataRelation.

Exceptions

Exception	Condition
ArgumentException	null or empty string ("") was passed into a DataColumn that is a DataRelation.
DuplicateNameException	The DataRelation belongs to a collection that already contains a DataRelation with the same name.

Remarks

Use the RelationName property to retrieve a DataRelation from the DataRelationCollection.

Examples

The following example uses the RelationName property to retrieve a DataRelation from a DataRelationCollection.

Private Sub GetRelation()
    ' Get the collection of a DataSet. 
    Dim collection As DataRelationCollection = _
        DataSet1.Relations

    ' Add a relation named CustomerOrders. 
    Dim myRel As DataRelation = _
        collection("CustomerOrders")

    ' Print the RelationName.
    Console.WriteLine(myRel.RelationName.ToString())
End Sub

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

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

Version Information