DataRelation Constructores

Definición

Espacio de nombres:: System.Data

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

Nombre	Description
DataRelation(String, DataColumn, DataColumn)	Inicializa una nueva instancia de la DataRelation clase con el nombre especificado DataRelation y los objetos primarios y secundarios DataColumn .
DataRelation(String, DataColumn[], DataColumn[])	Inicializa una nueva instancia de la DataRelation clase utilizando el nombre especificado DataRelation y matrices coincidentes de objetos primarios y secundarios DataColumn .
DataRelation(String, DataColumn, DataColumn, Boolean)	Inicializa una nueva instancia de la DataRelation clase utilizando el nombre, los objetos primarios y secundarios DataColumn especificados, y un valor que indica si se deben crear restricciones.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Inicializa una nueva instancia de la DataRelation clase con el nombre especificado, las matrices coincidentes de objetos primarios y secundarios DataColumn , y el valor que indica si se deben crear restricciones.
DataRelation(String, String, String, String[], String[], Boolean)	Este constructor se proporciona para la compatibilidad con tiempo de diseño en el entorno de Visual Studio.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Este constructor se proporciona para la compatibilidad con tiempo de diseño en el entorno de Visual Studio.

DataRelation(String, DataColumn, DataColumn)

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

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

El nombre del DataRelation. Si null o una cadena vacía (""), se proporcionará un nombre predeterminado cuando el objeto creado se agregue a DataRelationCollection.

parentColumn: DataColumn

Elemento primario DataColumn de la relación.

childColumn: DataColumn

Elemento secundario DataColumn de la relación.

Excepciones

ArgumentNullException

Uno o ambos DataColumn objetos contienen null.

InvalidConstraintException

Las columnas tienen tipos de datos diferentes

-O bien-

Las tablas no pertenecen a la misma DataSet.

Ejemplos

En el ejemplo siguiente se crea un objeto DataRelation 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[])

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

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

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

parentColumns: DataColumn[]

Matriz de objetos primarios DataColumn .

childColumns: DataColumn[]

Matriz de objetos secundarios DataColumn .

Excepciones

ArgumentNullException

Uno o ambos DataColumn objetos contienen null.

InvalidConstraintException

Los DataColumn objetos tienen tipos de datos diferentes

-O bien-

Una o ambas matrices no se componen de columnas distintas de la misma tabla.

-O bien-

Las tablas no pertenecen a la misma DataSet.

Ejemplos

En el ejemplo siguiente se crea un objeto DataRelation 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)

Inicializa una nueva instancia de la DataRelation clase utilizando el nombre, los objetos primarios y secundarios DataColumn especificados, y un valor que indica si se deben 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);

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 null o una cadena vacía (""), se proporcionará un nombre predeterminado cuando el objeto creado se agregue a DataRelationCollection.

parentColumn: DataColumn

Elemento primario DataColumn de la relación.

childColumn: DataColumn

El elemento secundario DataColumn en 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 DataColumn objetos contienen null.

InvalidConstraintException

Las columnas tienen tipos de datos diferentes

-O bien-

Las tablas no pertenecen a la misma DataSet.

Ejemplos

En el ejemplo siguiente se crea un objeto DataRelation 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)

Inicializa una nueva instancia de la DataRelation clase con el nombre especificado, las matrices coincidentes de objetos primarios y secundarios DataColumn , y el valor que indica si se deben 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);

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 null o una cadena vacía (""), se proporcionará un nombre predeterminado cuando el objeto creado se agregue a DataRelationCollection.

parentColumns: DataColumn[]

Matriz de objetos primarios DataColumn .

childColumns: DataColumn[]

Matriz de objetos secundarios DataColumn .

createConstraints: Boolean

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

Excepciones

ArgumentNullException

Uno o ambos DataColumn objetos son null.

InvalidConstraintException

Las columnas tienen tipos de datos diferentes

-O bien-

Las tablas no pertenecen a la misma DataSet.

Ejemplos

En el ejemplo siguiente se crea un objeto DataRelation 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)

Este constructor se proporciona para la compatibilidad con 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)>]
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 null o una cadena vacía (""), se proporcionará un nombre predeterminado cuando el objeto creado se agregue a DataRelationCollection.

parentTableName: String

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

childTableName: String

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

parentColumnNames: String[]

Matriz de nombres de DataColumn objeto en el elemento primario DataTable de la relación.

childColumnNames: String[]

Matriz de nombres de DataColumn objeto en el elemento secundario DataTable de la relación.

nested: Boolean

Valor que indica si las relaciones están anidadas.

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)

Este constructor se proporciona para la compatibilidad con 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)>]
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

El nombre del DataRelation. Si null o una cadena vacía (""), se proporcionará un nombre predeterminado cuando el objeto creado se agregue a DataRelationCollection.

parentTableName: String

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

parentTableNamespace: String

Nombre del espacio de nombres de la tabla primaria.

childTableName: String

Nombre de que DataTable 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 DataColumn objeto en el elemento primario DataTable de la relación.

childColumnNames: String[]

Matriz de nombres de DataColumn objeto en el elemento secundario DataTable de la relación.

nested: Boolean

Valor que indica si las relaciones están anidadas.

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 antes de llamar 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

Comentarios

¿Le ha resultado útil esta página?