Compartir vía


DataRelation Constructores

Definición

Inicializa una nueva instancia de la clase DataRelation.

Sobrecargas

DataRelation(String, DataColumn, DataColumn)

Inicializa una nueva instancia de la clase DataRelation mediante el nombre DataRelation especificado y los objetos DataColumn primarios y secundarios.

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.

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.

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.

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

Este constructor proporciona compatibilidad en tiempo de diseño en el entorno de Visual Studio.

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

Este constructor proporciona compatibilidad en tiempo de diseño en el entorno de Visual Studio.

DataRelation(String, DataColumn, DataColumn)

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

Inicializa una nueva instancia de la clase DataRelation mediante el nombre DataRelation especificado y los objetos DataColumn primarios y secundarios.

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);
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

Nombre del objeto DataRelation. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.

parentColumn
DataColumn

DataColumn primario de la relación.

childColumn
DataColumn

DataColumn secundario de la relación.

Excepciones

Uno o ambos objetos DataColumn contienen null.

Las columnas tienen tipos de datos diferentes.

-O bien-

Las tablas no pertenecen al mismo DataSet.

Ejemplos

En el ejemplo siguiente se crea un nuevo DataRelation objeto y se agrega a DataRelationCollection de .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

Se aplica a

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

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

Inicializa una nueva instancia de la clase DataRelation mediante el nombre DataRelation especificado y las matrices coincidentes de los objetos DataColumn primarios y secundarios.

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);
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

Nombre de la relación. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.

parentColumns
DataColumn[]

Matriz de objetos DataColumn primarios.

childColumns
DataColumn[]

Matriz de objetos DataColumn secundarios.

Excepciones

Uno o ambos objetos DataColumn contienen null.

Los objetos DataColumn tienen tipos de datos distintos.

-O bien-

Una o ambas matrices no están compuestas por columnas diferentes de la misma tabla.

-O bien-

Las tablas no pertenecen al mismo DataSet.

Ejemplos

En el ejemplo siguiente se crea un nuevo DataRelation objeto y se agrega a DataRelationCollection de .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

Se aplica a

DataRelation(String, DataColumn, DataColumn, Boolean)

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

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.

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);
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

Nombre de la relación. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.

parentColumn
DataColumn

DataColumn primario de la relación.

childColumn
DataColumn

DataColumn secundario de la relación.

createConstraints
Boolean

Valor que indica si se crean restricciones. true, si se crean restricciones. En caso contrario, es false.

Excepciones

Uno o ambos objetos DataColumn contienen null.

Las columnas tienen tipos de datos diferentes.

-O bien-

Las tablas no pertenecen al mismo DataSet.

Ejemplos

En el ejemplo siguiente se crea un nuevo DataRelation objeto y se agrega a DataRelationCollection de .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

Se aplica a

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

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

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.

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);
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

Nombre de la relación. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.

parentColumns
DataColumn[]

Matriz de objetos DataColumn primarios.

childColumns
DataColumn[]

Matriz de objetos DataColumn secundarios.

createConstraints
Boolean

Valor que indica si se van a crear restricciones. true, si se crean restricciones. En caso contrario, es false.

Excepciones

Uno o ambos objetos DataColumn son null.

Las columnas tienen tipos de datos diferentes.

-O bien-

Las tablas no pertenecen al mismo DataSet.

Ejemplos

En el ejemplo siguiente se crea un nuevo DataRelation objeto y se agrega a DataRelationCollection de .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

Se aplica a

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

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

Este constructor proporciona compatibilidad en tiempo de diseño en el entorno de Visual Studio.

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);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string parentTableName, string childTableName, string[] parentColumnNames, string[] childColumnNames, bool nested);
[<System.ComponentModel.Browsable(false)>]
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

Nombre de la relación. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.

parentTableName
String

Nombre del DataTable que es la tabla primaria de la relación.

childTableName
String

Nombre del DataTable que es la tabla secundaria de la relación.

parentColumnNames
String[]

Matriz de nombres de objetos DataColumn del DataTable primario de la relación.

childColumnNames
String[]

Matriz de nombres de objetos DataColumn del DataTable secundario de la relación.

nested
Boolean

Valor que indica si se anidan relaciones.

Atributos

Comentarios

Cualquier DataRelation objeto creado mediante este constructor debe agregarse a la colección con el AddRange método dentro de un BeginInit bloque y EndInit . Si no se llama a este constructor entre BeginInit y EndInit se producirá una NullReferenceException . Además, las tablas y columnas con los nombres especificados deben existir en el momento en que se llama al constructor.

Se aplica a

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

Source:
DataRelation.cs
Source:
DataRelation.cs
Source:
DataRelation.cs

Este constructor proporciona compatibilidad en tiempo de diseño en el entorno de Visual Studio.

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);
[System.ComponentModel.Browsable(false)]
public DataRelation (string relationName, string parentTableName, string parentTableNamespace, string childTableName, string childTableNamespace, string[] parentColumnNames, string[] childColumnNames, bool nested);
[<System.ComponentModel.Browsable(false)>]
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

Nombre del objeto DataRelation. Si es null o una cadena vacía (""), se le asignará un nombre predeterminado cuando el objeto creado se agregue al DataRelationCollection.

parentTableName
String

Nombre del DataTable que es la tabla primaria de la relación.

parentTableNamespace
String

Nombre del espacio de nombres de la tabla primaria.

childTableName
String

Nombre del DataTable que es la tabla secundaria de la relación.

childTableNamespace
String

Nombre del espacio de nombres de la tabla secundaria.

parentColumnNames
String[]

Matriz de nombres de objetos DataColumn del DataTable primario de la relación.

childColumnNames
String[]

Matriz de nombres de objetos DataColumn del DataTable secundario de la relación.

nested
Boolean

Valor que indica si se anidan relaciones.

Atributos

Comentarios

Cualquier DataRelation objeto creado mediante este constructor debe agregarse a la colección con AddRange. Las tablas y columnas con los nombres especificados deben existir en el momento en que se llama al método, o si BeginInit se ha llamado a este constructor, las tablas y columnas con los nombres especificados deben existir en el momento en que EndInit se llama a .

Se aplica a