DataRelation Construtores

Definição

Namespace:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa uma nova instância da classe DataRelation.

Sobrecargas

Nome	Description
DataRelation(String, DataColumn, DataColumn)	Inicializa uma nova instância da DataRelation classe usando o nome especificado DataRelation e objetos pai e filho DataColumn .
DataRelation(String, DataColumn[], DataColumn[])	Inicializa uma nova instância da DataRelation classe usando o nome especificado DataRelation e matrizes correspondentes de objetos pai e filho DataColumn .
DataRelation(String, DataColumn, DataColumn, Boolean)	Inicializa uma nova instância da DataRelation classe usando o nome, os objetos pai e filho DataColumn especificados e um valor que indica se as restrições devem ser criadas.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Inicializa uma nova instância da DataRelation classe usando o nome especificado, matrizes correspondentes de objetos pai e filho DataColumn e valor que indica se as restrições devem ser criadas.
DataRelation(String, String, String, String[], String[], Boolean)	Esse construtor é fornecido para suporte a tempo de design no ambiente do Visual Studio.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Esse construtor é fornecido para suporte a tempo de design no ambiente do Visual Studio.

DataRelation(String, DataColumn, DataColumn)

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

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

A criança DataColumn na relação.

Exceções

ArgumentNullException

Um ou ambos os DataColumn objetos contêm null.

InvalidConstraintException

As colunas têm tipos de dados diferentes

-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[])

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

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 pai DataColumn .

childColumns: DataColumn[]

Uma matriz de objetos filho DataColumn .

Exceções

ArgumentNullException

Um ou ambos os DataColumn objetos contêm null.

InvalidConstraintException

Os DataColumn objetos têm tipos de dados diferentes

-Ou-

Uma ou ambas as matrizes não são compostas por colunas distintas 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)

Inicializa uma nova instância da DataRelation classe usando o nome, os objetos pai e filho DataColumn especificados e um valor que indica se as restrições devem ser criadas.

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. 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.

createConstraints: Boolean

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

Exceções

ArgumentNullException

Um ou ambos os DataColumn objetos contêm null.

InvalidConstraintException

As colunas têm tipos de dados diferentes

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

Inicializa uma nova instância da DataRelation classe usando o nome especificado, matrizes correspondentes de objetos pai e filho DataColumn e valor que indica se as restrições devem ser criadas.

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. 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 pai DataColumn .

childColumns: DataColumn[]

Uma matriz de objetos filho DataColumn .

createConstraints: Boolean

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

Exceções

ArgumentNullException

Um ou ambos os DataColumn objetos são null.

InvalidConstraintException

As colunas têm tipos de dados diferentes

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

Esse construtor é fornecido para suporte a 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)>]
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 da DataTable tabela pai da relação.

childTableName: String

O nome da DataTable tabela filho da relação.

parentColumnNames: String[]

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

childColumnNames: String[]

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

nested: Boolean

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

Atributos: BrowsableAttribute

Comentários

Qualquer DataRelation objeto criado usando esse construtor deve ser adicionado à coleção com o AddRange método dentro de um BeginInit e EndInit bloco. 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)

Esse construtor é fornecido para suporte a 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)>]
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 da DataTable tabela pai da relação.

parentTableNamespace: String

O nome do namespace da tabela pai.

childTableName: String

O nome da DataTable tabela filho da relação.

childTableNamespace: String

O nome do namespace da tabela filho.

parentColumnNames: String[]

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

childColumnNames: String[]

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

nested: Boolean

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

Atributos: BrowsableAttribute

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

Comentários

Esta página foi útil?