DataRelation DataRelation DataRelation DataRelation Constructors

Definición

Sobrecargas

DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn)

Inicializa una nueva instancia de la clase DataRelation mediante el nombre DataRelation especificado y los objetos DataColumn primarios y secundarios.Initializes a new instance of the DataRelation class using the specified DataRelation name, and parent and child DataColumn objects.

DataRelation(String, DataColumn[], DataColumn[]) DataRelation(String, DataColumn[], DataColumn[]) DataRelation(String, DataColumn[], DataColumn[]) DataRelation(String, DataColumn[], DataColumn[])

Inicializa una nueva instancia de la clase DataRelation mediante el nombre DataRelation especificado y las matrices coincidentes de los objetos DataColumn primarios y secundarios.Initializes a new instance of the DataRelation class using the specified DataRelation name and matched arrays of parent and child DataColumn objects.

DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean)

Inicializa una nueva instancia de la clase DataRelation utilizando el nombre especificado, los objetos DataColumn primarios y secundarios y un valor que indica si se van a crear restricciones.Initializes a new instance of the DataRelation class using the specified name, parent and child DataColumn objects, and a value that indicates whether to create constraints.

DataRelation(String, DataColumn[], DataColumn[], Boolean) DataRelation(String, DataColumn[], DataColumn[], Boolean) DataRelation(String, DataColumn[], DataColumn[], Boolean) DataRelation(String, DataColumn[], DataColumn[], Boolean)

Inicializa una nueva instancia de la clase DataRelation utilizando el nombre especificado, matrices coincidentes de objetos DataColumn primarios y secundarios y un valor que indica si se van a crear restricciones.Initializes a new instance of the DataRelation class using the specified name, matched arrays of parent and child DataColumn objects, and value that indicates whether to create constraints.

DataRelation(String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String[], String[], Boolean)

Este constructor proporciona compatibilidad en tiempo de diseño en el entorno de Visual Studio.This constructor is provided for design time support in the Visual Studio environment.

DataRelation(String, String, String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String, String, String[], String[], Boolean)

Este constructor proporciona compatibilidad en tiempo de diseño en el entorno de Visual Studio.This constructor is provided for design time support in the Visual Studio environment.

DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn) DataRelation(String, DataColumn, DataColumn)

Inicializa una nueva instancia de la clase DataRelation mediante el nombre DataRelation especificado y los objetos DataColumn primarios y secundarios.Initializes a new instance of the DataRelation class using the specified DataRelation name, and parent and child DataColumn objects.

public:
 DataRelation(System::String ^ relationName, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);
public DataRelation (string relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
new System.Data.DataRelation : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumn As DataColumn, childColumn As DataColumn)

Parámetros

relationName
String String String String

Nombre del objeto DataRelation.The name of the DataRelation. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumn
DataColumn DataColumn DataColumn DataColumn

DataColumn primario de la relación.The parent DataColumn in the relationship.

childColumn
DataColumn DataColumn DataColumn DataColumn

DataColumn secundario de la relación.The child DataColumn in the relationship.

Excepciones

Uno o ambos objetos DataColumn contienen null.One or both of the DataColumn objects contains null.

Las columnas tienen tipos de datos diferentes.The columns have different data types O bien-Or- Las tablas no pertenecen al mismo DataSet.The tables do not belong to the same DataSet.

Ejemplos

En el ejemplo siguiente se crea DataRelation un nuevo y se agrega DataRelationCollection a la DataSetde.The following example creates a new DataRelation and adds it to the DataRelationCollection of a DataSet.

private void CreateRelation()
{
    // Code to get the DataSet not shown here.
    // Get the DataColumn objects from two DataTable 
    // objects in a DataSet.
    DataColumn[] parentCols = new DataColumn[] 
        {DataSet1.Tables["Customers"].Columns["CustID"],
        DataSet1.Tables["Customers"].Columns["OrdID"]};
    DataColumn[] childCols= new DataColumn[] 
        {DataSet1.Tables["Orders"].Columns["CustID"],
        DataSet1.Tables["Orders"].Columns["OrdID"]};

    // Create DataRelation.
    DataRelation CustOrderRel = new DataRelation(
        "CustomersOrders", parentCols, childCols);

    // Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel);
}

 Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentCols As DataColumn() = _
        {DataSet1.Tables("Customers").Columns("CustID"), _
        DataSet1.Tables("Customers").Columns("OrdID")}
    Dim childCols As DataColumn() = _
        {DataSet1.Tables("Orders").Columns("CustID"), _
        DataSet1.Tables("Orders").Columns("OrdID")}

    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentCols, childCols)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub
Consulte también:

DataRelation(String, DataColumn[], DataColumn[]) DataRelation(String, DataColumn[], DataColumn[]) DataRelation(String, DataColumn[], DataColumn[]) DataRelation(String, DataColumn[], DataColumn[])

Inicializa una nueva instancia de la clase DataRelation mediante el nombre DataRelation especificado y las matrices coincidentes de los objetos DataColumn primarios y secundarios.Initializes a new instance of the DataRelation class using the specified DataRelation name and matched arrays of parent and child DataColumn objects.

public:
 DataRelation(System::String ^ relationName, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);
public DataRelation (string relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
new System.Data.DataRelation : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumns As DataColumn(), childColumns As DataColumn())

Parámetros

relationName
String String String String

Nombre de la relación.The name of the relation. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumns
DataColumn[]

Matriz de objetos DataColumn primarios.An array of parent DataColumn objects.

childColumns
DataColumn[]

Matriz de objetos DataColumn secundarios.An array of child DataColumn objects.

Excepciones

Uno o ambos objetos DataColumn contienen null.One or both of the DataColumn objects contains null.

Los objetos DataColumn tienen tipos de datos distintos.The DataColumn objects have different data types O bien-Or- Una o ambas matrices no están compuestas por columnas diferentes de la misma tabla.One or both of the arrays are not composed of distinct columns from the same table.

O bien-Or- Las tablas no pertenecen al mismo DataSet.The tables do not belong to the same DataSet.

Ejemplos

En el ejemplo siguiente se crea DataRelation un nuevo y se agrega DataRelationCollection a la DataSetde.The following example creates a new DataRelation and adds it to the DataRelationCollection of a DataSet.

Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumns() As DataColumn
    Dim childColumns() As DataColumn
    parentColumns(0) = DataSet1.Tables( _
        "Customers").Columns("CustID")
    parentColumns(1) = DataSet1.Tables( _
        "Customers").Columns("OrdID")
 
    childColumns(0) = DataSet1.Tables( _
        "Orders").Columns("CustID")
    childColumns(1) = DataSet1.Tables( _
        "Orders").Columns("OrdID")

    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentColumns, childColumns)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub
Consulte también:

DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean) DataRelation(String, DataColumn, DataColumn, Boolean)

Inicializa una nueva instancia de la clase DataRelation utilizando el nombre especificado, los objetos DataColumn primarios y secundarios y un valor que indica si se van a crear restricciones.Initializes a new instance of the DataRelation class using the specified name, parent and child DataColumn objects, and a value that indicates whether to create constraints.

public:
 DataRelation(System::String ^ relationName, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn, bool createConstraints);
public DataRelation (string relationName, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);
new System.Data.DataRelation : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean)

Parámetros

relationName
String String String String

Nombre de la relación.The name of the relation. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumn
DataColumn DataColumn DataColumn DataColumn

DataColumn primario de la relación.The parent DataColumn in the relation.

childColumn
DataColumn DataColumn DataColumn DataColumn

DataColumn secundario de la relación.The child DataColumn in the relation.

createConstraints
Boolean Boolean Boolean Boolean

Valor que indica si se crean restricciones.A value that indicates whether constraints are created. true, si se crean restricciones.true, if constraints are created. En caso contrario, es false.Otherwise, false.

Excepciones

Uno o ambos objetos DataColumn contienen null.One or both of the DataColumn objects contains null.

Las columnas tienen tipos de datos diferentes.The columns have different data types O bien-Or- Las tablas no pertenecen al mismo DataSet.The tables do not belong to the same DataSet.

Ejemplos

En el ejemplo siguiente se crea DataRelation un nuevo y se agrega DataRelationCollection a la DataSetde.The following example creates a new DataRelation and adds it to the DataRelationCollection of a DataSet.


 Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumn As DataColumn = DataSet1.Tables( _
        "Customers").Columns("CustID")
    Dim childColumn As DataColumn = _
        DataSet1.Tables("Orders").Columns("CustID")

    ' Create DataRelation.
    Dim bConstraints As Boolean = True
    Dim customerOrdersRelation As DataRelation = _
        New DataRelation("CustomersOrders", _
        parentColumn, childColumn, bConstraints)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(customerOrdersRelation)
End Sub
Consulte también:

DataRelation(String, DataColumn[], DataColumn[], Boolean) DataRelation(String, DataColumn[], DataColumn[], Boolean) DataRelation(String, DataColumn[], DataColumn[], Boolean) DataRelation(String, DataColumn[], DataColumn[], Boolean)

Inicializa una nueva instancia de la clase DataRelation utilizando el nombre especificado, matrices coincidentes de objetos DataColumn primarios y secundarios y un valor que indica si se van a crear restricciones.Initializes a new instance of the DataRelation class using the specified name, matched arrays of parent and child DataColumn objects, and value that indicates whether to create constraints.

public:
 DataRelation(System::String ^ relationName, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns, bool createConstraints);
public DataRelation (string relationName, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);
new System.Data.DataRelation : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean)

Parámetros

relationName
String String String String

Nombre de la relación.The name of the relation. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumns
DataColumn[]

Matriz de objetos DataColumn primarios.An array of parent DataColumn objects.

childColumns
DataColumn[]

Matriz de objetos DataColumn secundarios.An array of child DataColumn objects.

createConstraints
Boolean Boolean Boolean Boolean

Valor que indica si se van a crear restricciones.A value that indicates whether to create constraints. true, si se crean restricciones.true, if constraints are created. En caso contrario, es false.Otherwise, false.

Excepciones

Uno o ambos objetos DataColumn son null.One or both of the DataColumn objects is null.

Las columnas tienen tipos de datos diferentes.The columns have different data types O bien-Or- Las tablas no pertenecen al mismo DataSet.The tables do not belong to the same DataSet.

Ejemplos

En el ejemplo siguiente se crea DataRelation un nuevo y se agrega DataRelationCollection a la DataSetde.The following example creates a new DataRelation and adds it to the DataRelationCollection of a DataSet.

Private Sub CreateRelation()
    ' Code to get the DataSet not shown here.
    ' Get the DataColumn objects from two DataTable 
    ' objects in a DataSet.
    Dim parentColumns() As DataColumn
    Dim childColumns() As DataColumn
    parentColumns(0) = DataSet1.Tables( _
        "Customers").Columns("CustID")
    parentColumns(1) = DataSet1.Tables( _
        "Customers").Columns("OrdID")
 
    childColumns(0) = DataSet1.Tables( _
        "Orders").Columns("CustID")
    childColumns(1) = DataSet1.Tables( _
        "Orders").Columns("OrdID")
 
    Dim bConstraints As Boolean = True
    ' Create DataRelation.
    Dim CustOrderRel As New DataRelation( _
        "CustomersOrders", parentColumns, childColumns,  _
        bConstraints)

    ' Add the relation to the DataSet.
    DataSet1.Relations.Add(CustOrderRel)
End Sub
Consulte también:

DataRelation(String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String[], String[], Boolean)

Este constructor proporciona compatibilidad en tiempo de diseño en el entorno de Visual Studio.This constructor is provided for design time support in the Visual Studio environment.

public:
 DataRelation(System::String ^ relationName, System::String ^ parentTableName, System::String ^ childTableName, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, bool nested);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string parentTableName, string childTableName, string[] parentColumnNames, string[] childColumnNames, bool nested);
new System.Data.DataRelation : string * string * string * string[] * string[] * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentTableName As String, childTableName As String, parentColumnNames As String(), childColumnNames As String(), nested As Boolean)

Parámetros

relationName
String String String String

Nombre de la relación.The name of the relation. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentTableName
String String String String

Nombre del DataTable que es la tabla primaria de la relación.The name of the DataTable that is the parent table of the relation.

childTableName
String String String String

Nombre del DataTable que es la tabla secundaria de la relación.The name of the DataTable that is the child table of the relation.

parentColumnNames
String[]

Matriz de nombres de objetos DataColumn del DataTable primario de la relación.An array of DataColumn object names in the parent DataTable of the relation.

childColumnNames
String[]

Matriz de nombres de objetos DataColumn del DataTable secundario de la relación.An array of DataColumn object names in the child DataTable of the relation.

nested
Boolean Boolean Boolean Boolean

Valor que indica si se anidan relaciones.A value that indicates whether relationships are nested.

Comentarios

Cualquier DataRelation objeto creado con este constructor se debe agregar a la colección con el AddRange método dentro de un BeginInit bloque and EndInit .Any DataRelation object created by using this constructor must be added to the collection with the AddRange method inside of a BeginInit and EndInit block. Si no se llama a este constructor BeginInit entre EndInit y NullReferenceException se producirá una excepción.If this constructor is not called between BeginInit and EndInit a NullReferenceException will occur. Además, las tablas y columnas con los nombres especificados deben existir en el momento en que se llama al constructor.In addition, the tables and columns with the specified names must exist at the time the constructor is called.

DataRelation(String, String, String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String, String, String[], String[], Boolean) DataRelation(String, String, String, String, String, String[], String[], Boolean)

Este constructor proporciona compatibilidad en tiempo de diseño en el entorno de Visual Studio.This constructor is provided for design time support in the Visual Studio environment.

public:
 DataRelation(System::String ^ relationName, System::String ^ parentTableName, System::String ^ parentTableNamespace, System::String ^ childTableName, System::String ^ childTableNamespace, cli::array <System::String ^> ^ parentColumnNames, cli::array <System::String ^> ^ childColumnNames, bool nested);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string parentTableName, string parentTableNamespace, string childTableName, string childTableNamespace, string[] parentColumnNames, string[] childColumnNames, bool nested);
new System.Data.DataRelation : string * string * string * string * string * string[] * string[] * bool -> System.Data.DataRelation
Public Sub New (relationName As String, parentTableName As String, parentTableNamespace As String, childTableName As String, childTableNamespace As String, parentColumnNames As String(), childColumnNames As String(), nested As Boolean)

Parámetros

relationName
String String String String

Nombre del objeto DataRelation.The name of the DataRelation. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentTableName
String String String String

Nombre del DataTable que es la tabla primaria de la relación.The name of the DataTable that is the parent table of the relation.

parentTableNamespace
String String String String

Nombre del espacio de nombres de la tabla primaria.The name of the parent table namespace.

childTableName
String String String String

Nombre del DataTable que es la tabla secundaria de la relación.The name of the DataTable that is the child table of the relation.

childTableNamespace
String String String String

Nombre del espacio de nombres de la tabla secundaria.The name of the child table namespace.

parentColumnNames
String[]

Matriz de nombres de objetos DataColumn del DataTable primario de la relación.An array of DataColumn object names in the parent DataTable of the relation.

childColumnNames
String[]

Matriz de nombres de objetos DataColumn del DataTable secundario de la relación.An array of DataColumn object names in the child DataTable of the relation.

nested
Boolean Boolean Boolean Boolean

Valor que indica si se anidan relaciones.A value that indicates whether relationships are nested.

Comentarios

Cualquier DataRelation objeto creado con este constructor se debe agregar a la colección con AddRange.Any DataRelation object created by using this constructor must then be added to the collection with AddRange. Las tablas y columnas con los nombres especificados deben existir en el momento en que se llama al BeginInit método, o bien, si se ha llamado a antes de llamar a este constructor, las tablas y columnas con EndInit los nombres especificados deben existir en el momento en que se llama a.Tables and columns with the specified names must exist at the time the method is called, or if BeginInit has been called before calling this constructor, the tables and columns with the specified names must exist at the time that EndInit is called.

Se aplica a