DataRelation Constructores

Referencia

Definición

Espacio de nombres:: System.Data

Ensamblado:: System.Data.Common.dll

Ensamblado:: System.Data.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

ArgumentNullException

Uno o ambos objetos DataColumn contienen null.

InvalidConstraintException

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

ArgumentNullException

Uno o ambos objetos DataColumn contienen null.

InvalidConstraintException

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

ArgumentNullException

Uno o ambos objetos DataColumn contienen null.

InvalidConstraintException

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

ArgumentNullException

Uno o ambos objetos DataColumn son null.

InvalidConstraintException

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: BrowsableAttribute

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: BrowsableAttribute

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

DataRelation Constructores

Definición

Sobrecargas

DataRelation(String, DataColumn, DataColumn)

Parámetros

Excepciones

Ejemplos

Consulte también

Se aplica a

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

Parámetros

Excepciones

Ejemplos

Consulte también

Se aplica a

DataRelation(String, DataColumn, DataColumn, Boolean)

Parámetros

Excepciones

Ejemplos

Consulte también

Se aplica a

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

Parámetros

Excepciones

Ejemplos

Consulte también

Se aplica a

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

Parámetros

Comentarios

Se aplica a

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

Parámetros

Comentarios

Se aplica a

Comentarios

Recursos adicionales