DataRelation Construtores

Definição

Inicializa uma nova instância da classe DataRelation.Initializes a new instance of the DataRelation class.

Sobrecargas

DataRelation(String, DataColumn, DataColumn)

Inicializa uma nova instância da classe DataRelation usando o nome DataRelation especificado e os objetos DataColumn pai e filho.Initializes a new instance of the DataRelation class using the specified DataRelation name, and parent and child DataColumn objects.

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

Inicializa uma nova instância da classe DataRelation usando o nome DataRelation e matrizes correspondentes de objetos DataColumn pai e filho.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)

Inicializa uma nova instância da classe DataRelation usando o nome especificado, os objetos DataColumn pai e filho e um valor que indica se é necessário criar restrições.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)

Inicializa uma nova instância da classe DataRelation usando o nome especificado, matrizes correspondentes de objetos DataColumn pai e filho e um valor que indica se é necessário criar restrições.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)

Este construtor é fornecido para suporte de tempo de design no ambiente do Visual Studio.This constructor is provided for design time support in the Visual Studio environment.

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

Este construtor é fornecido para suporte de tempo de design no ambiente do Visual Studio.This constructor is provided for design time support in the Visual Studio environment.

DataRelation(String, DataColumn, DataColumn)

Inicializa uma nova instância da classe DataRelation usando o nome DataRelation especificado e os objetos DataColumn pai e filho.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

O nome do DataRelation.The name of the DataRelation. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumn
DataColumn

O pai DataColumn na relação.The parent DataColumn in the relationship.

childColumn
DataColumn

O filho DataColumn na relação.The child DataColumn in the relationship.

Exceções

Um ou ambos os objetos DataColumn contêm null.One or both of the DataColumn objects contains null.

As colunas têm diferentes tipos de dadosThe columns have different data types -Ou--Or- As tabelas não pertencem ao mesmo DataSet.The tables do not belong to the same DataSet.

Exemplos

O exemplo a seguir cria um novo DataRelation e o adiciona ao DataRelationCollection de um DataSet.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

Veja também

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

Inicializa uma nova instância da classe DataRelation usando o nome DataRelation e matrizes correspondentes de objetos DataColumn pai e filho.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

O nome da relação.The name of the relation. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumns
DataColumn[]

Uma matriz de objetos DataColumn pai.An array of parent DataColumn objects.

childColumns
DataColumn[]

Uma matriz de objetos filho DataColumn .An array of child DataColumn objects.

Exceções

Um ou ambos os objetos DataColumn contêm null.One or both of the DataColumn objects contains null.

Os objetos DataColumn têm diferentes tipos de dadosThe DataColumn objects have different data types -Ou--Or- Uma ou ambas as matrizes não são compostas por colunas diferentes da mesma tabela.One or both of the arrays are not composed of distinct columns from the same table.

-Ou--Or- As tabelas não pertencem ao mesmo DataSet.The tables do not belong to the same DataSet.

Exemplos

O exemplo a seguir cria um novo DataRelation e o adiciona ao DataRelationCollection de um DataSet.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

Veja também

DataRelation(String, DataColumn, DataColumn, Boolean)

Inicializa uma nova instância da classe DataRelation usando o nome especificado, os objetos DataColumn pai e filho e um valor que indica se é necessário criar restrições.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

O nome da relação.The name of the relation. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumn
DataColumn

O DataColumn pai na relação.The parent DataColumn in the relation.

childColumn
DataColumn

O DataColumn filho na relação.The child DataColumn in the relation.

createConstraints
Boolean

Um valor que indica se é restrições são ou não criadas.A value that indicates whether constraints are created. true se as restrições são criadas.true, if constraints are created. Caso contrário, false.Otherwise, false.

Exceções

Um ou ambos os objetos DataColumn contêm null.One or both of the DataColumn objects contains null.

As colunas têm diferentes tipos de dadosThe columns have different data types -Ou--Or- As tabelas não pertencem ao mesmo DataSet.The tables do not belong to the same DataSet.

Exemplos

O exemplo a seguir cria um novo DataRelation e o adiciona ao DataRelationCollection de um DataSet.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

Veja também

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

Inicializa uma nova instância da classe DataRelation usando o nome especificado, matrizes correspondentes de objetos DataColumn pai e filho e um valor que indica se é necessário criar restrições.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

O nome da relação.The name of the relation. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentColumns
DataColumn[]

Uma matriz de objetos DataColumn pai.An array of parent DataColumn objects.

childColumns
DataColumn[]

Uma matriz de objetos filho DataColumn .An array of child DataColumn objects.

createConstraints
Boolean

Um valor que indica se é necessário criar restrições.A value that indicates whether to create constraints. true se as restrições forem criadas.true, if constraints are created. Caso contrário, false.Otherwise, false.

Exceções

Um ou ambos os objetos DataColumn são null.One or both of the DataColumn objects is null.

As colunas têm diferentes tipos de dadosThe columns have different data types -Ou--Or- As tabelas não pertencem ao mesmo DataSet.The tables do not belong to the same DataSet.

Exemplos

O exemplo a seguir cria um novo DataRelation e o adiciona ao DataRelationCollection de um DataSet.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

Veja também

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

Este construtor é fornecido para suporte de tempo de design no ambiente do 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

O nome da relação.The name of the relation. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentTableName
String

O nome do DataTable que é a tabela pai da relação.The name of the DataTable that is the parent table of the relation.

childTableName
String

O nome do DataTable que é a tabela filho da relação.The name of the DataTable that is the child table of the relation.

parentColumnNames
String[]

Uma matriz de nomes de objeto DataColumn no DataTable pai da relação.An array of DataColumn object names in the parent DataTable of the relation.

childColumnNames
String[]

Uma matriz de nomes de objeto DataColumn no DataTable filho da relação.An array of DataColumn object names in the child DataTable of the relation.

nested
Boolean

Um valor que indica se as relações são aninhadas.A value that indicates whether relationships are nested.

Atributos

Comentários

Qualquer DataRelation objeto criado usando esse construtor deve ser adicionado à coleção com o AddRange método dentro de um BeginInit bloco e 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. Se esse construtor não for chamado entre BeginInit e EndInit um NullReferenceException ocorrerá.If this constructor is not called between BeginInit and EndInit a NullReferenceException will occur. Além disso, as tabelas e colunas com os nomes especificados devem existir no momento em que o construtor é chamado.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)

Este construtor é fornecido para suporte de tempo de design no ambiente do 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

O nome do DataRelation.The name of the DataRelation. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.If null or an empty string (""), a default name will be given when the created object is added to the DataRelationCollection.

parentTableName
String

O nome do DataTable que é a tabela pai da relação.The name of the DataTable that is the parent table of the relation.

parentTableNamespace
String

O nome do namespace da tabela pai.The name of the parent table namespace.

childTableName
String

O nome do DataTable que é a tabela filho da relação.The name of the DataTable that is the child table of the relation.

childTableNamespace
String

O nome do namespace da tabela filho.The name of the child table namespace.

parentColumnNames
String[]

Uma matriz de nomes de objeto DataColumn no DataTable pai da relação.An array of DataColumn object names in the parent DataTable of the relation.

childColumnNames
String[]

Uma matriz de nomes de objeto DataColumn no DataTable filho da relação.An array of DataColumn object names in the child DataTable of the relation.

nested
Boolean

Um valor que indica se as relações são aninhadas.A value that indicates whether relationships are nested.

Atributos

Comentários

Qualquer DataRelation objeto criado usando esse construtor deve ser adicionado à coleção com AddRange.Any DataRelation object created by using this constructor must then be added to the collection with AddRange. As tabelas e colunas com os nomes especificados devem existir no momento em que o método for chamado, BeginInit ou se tiver sido chamado antes de chamar esse construtor, as tabelas e colunas com os nomes especificados devem existir no EndInit momento que for chamado.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.

Aplica-se a