Partilhar via


DataRelation Construtores

Definição

Inicializa uma nova instância da classe DataRelation.

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.

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.

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.

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.

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

Este construtor é fornecido para suporte de tempo de design no ambiente do Visual Studio.

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

Este construtor é fornecido para suporte de tempo de design no ambiente do Visual Studio.

DataRelation(String, DataColumn, DataColumn)

Origem:
DataRelation.cs
Origem:
DataRelation.cs
Origem:
DataRelation.cs

Inicializa uma nova instância da classe DataRelation usando o nome DataRelation especificado e os objetos DataColumn pai e filho.

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

O nome do DataRelation. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.

parentColumn
DataColumn

O pai DataColumn na relação.

childColumn
DataColumn

O filho DataColumn na relação.

Exceções

Um ou ambos os objetos DataColumn contêm null.

As colunas têm diferentes tipos de dados

-Ou-

As tabelas não pertencem ao mesmo DataSet.

Exemplos

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

Confira também

Aplica-se a

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

Origem:
DataRelation.cs
Origem:
DataRelation.cs
Origem:
DataRelation.cs

Inicializa uma nova instância da classe DataRelation usando o nome DataRelation e matrizes correspondentes de objetos DataColumn pai e filho.

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

O nome da relação. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.

parentColumns
DataColumn[]

Uma matriz de objetos DataColumn pai.

childColumns
DataColumn[]

Uma matriz de objetos filho DataColumn .

Exceções

Um ou ambos os objetos DataColumn contêm null.

Os objetos DataColumn têm diferentes tipos de dados

-Ou-

Uma ou ambas as matrizes não são compostas por colunas diferentes da mesma tabela.

-Ou-

As tabelas não pertencem ao mesmo DataSet.

Exemplos

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

Confira também

Aplica-se a

DataRelation(String, DataColumn, DataColumn, Boolean)

Origem:
DataRelation.cs
Origem:
DataRelation.cs
Origem:
DataRelation.cs

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.

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

O nome da relação. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.

parentColumn
DataColumn

O DataColumn pai na relação.

childColumn
DataColumn

O DataColumn filho na relação.

createConstraints
Boolean

Um valor que indica se é restrições são ou não criadas. true se as restrições forem criadas. Caso contrário, false.

Exceções

Um ou ambos os objetos DataColumn contêm null.

As colunas têm diferentes tipos de dados

-Ou-

As tabelas não pertencem ao mesmo DataSet.

Exemplos

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

Confira também

Aplica-se a

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

Origem:
DataRelation.cs
Origem:
DataRelation.cs
Origem:
DataRelation.cs

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.

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

O nome da relação. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.

parentColumns
DataColumn[]

Uma matriz de objetos DataColumn pai.

childColumns
DataColumn[]

Uma matriz de objetos filho DataColumn .

createConstraints
Boolean

Um valor que indica se é necessário criar restrições. true se as restrições forem criadas. Caso contrário, false.

Exceções

Um ou ambos os objetos DataColumn são null.

As colunas têm diferentes tipos de dados

-Ou-

As tabelas não pertencem ao mesmo DataSet.

Exemplos

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

Confira também

Aplica-se a

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

Origem:
DataRelation.cs
Origem:
DataRelation.cs
Origem:
DataRelation.cs

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

O nome da relação. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.

parentTableName
String

O nome do DataTable que é a tabela pai da relação.

childTableName
String

O nome do DataTable que é a tabela filho da relação.

parentColumnNames
String[]

Uma matriz de nomes de objeto DataColumn no DataTable pai da relação.

childColumnNames
String[]

Uma matriz de nomes de objeto DataColumn no DataTable filho da relação.

nested
Boolean

Um valor que indica se as relações são aninhadas.

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 . Se esse construtor não for chamado entre BeginInit e EndInit ocorrerá um NullReferenceException . Além disso, as tabelas e colunas com os nomes especificados devem existir no momento em que o construtor é chamado.

Aplica-se a

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

Origem:
DataRelation.cs
Origem:
DataRelation.cs
Origem:
DataRelation.cs

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

O nome do DataRelation. Se null ou uma cadeia de caracteres vazia (""), um nome padrão será fornecido quando o objeto criado for adicionado ao DataRelationCollection.

parentTableName
String

O nome do DataTable que é a tabela pai da relação.

parentTableNamespace
String

O nome do namespace da tabela pai.

childTableName
String

O nome do DataTable que é a tabela filho da relação.

childTableNamespace
String

O nome do namespace da tabela filho.

parentColumnNames
String[]

Uma matriz de nomes de objeto DataColumn no DataTable pai da relação.

childColumnNames
String[]

Uma matriz de nomes de objeto DataColumn no DataTable filho da relação.

nested
Boolean

Um valor que indica se as relações são aninhadas.

Atributos

Comentários

Qualquer DataRelation objeto criado usando esse construtor deve ser adicionado à coleção com AddRange. Tabelas e colunas com os nomes especificados devem existir no momento em que o método é chamado ou, se BeginInit tiver sido chamado antes de chamar esse construtor, as tabelas e colunas com os nomes especificados devem existir no momento em que EndInit for chamado.

Aplica-se a