DataRelation Construtores

Definição

Espaço de Nomes:: System.Data

Assemblagens:: netstandard.dll, System.Data.Common.dll

Assemblagem:: System.Data.Common.dll

Assemblagem:: System.Data.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da DataRelation classe.

Sobrecargas

Name	Description
DataRelation(String, DataColumn, DataColumn)	Inicializa uma nova instância da DataRelation classe usando o nome especificado DataRelation , e os objetos pai e filho DataColumn .
DataRelation(String, DataColumn[], DataColumn[])	Inicializa uma nova instância da DataRelation classe usando o nome especificado DataRelation e os arrays correspondentes de objetos pai e filho DataColumn .
DataRelation(String, DataColumn, DataColumn, Boolean)	Inicializa uma nova instância da DataRelation classe usando o nome especificado, objetos pai e filho DataColumn , e um valor que indica se deve criar restrições.
DataRelation(String, DataColumn[], DataColumn[], Boolean)	Inicializa uma nova instância da DataRelation classe usando o nome especificado, arrays correspondentes de objetos pai e filho DataColumn , e valor que indica se deve criar restrições.
DataRelation(String, String, String, String[], String[], Boolean)	Este construtor é fornecido para suporte em tempo de design no ambiente Visual Studio.
DataRelation(String, String, String, String, String, String[], String[], Boolean)	Este construtor é fornecido para suporte em tempo de design no ambiente Visual Studio.

DataRelation(String, DataColumn, DataColumn)

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Inicializa uma nova instância da DataRelation classe usando o nome especificado DataRelation , e os 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);

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 for uma cadeia vazia (""), um nome padrão será dado quando o objeto criado for adicionado ao DataRelationCollection.

parentColumn: DataColumn

O progenitor 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 diferentes tipos de dados

-Ou-

As tabelas não pertencem à mesma DataSet.

Exemplos

O exemplo seguinte cria um novo DataRelation e adiciona-o 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

Ver também

Aplica-se a

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

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Inicializa uma nova instância da DataRelation classe usando o nome especificado DataRelation e os arrays 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);

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 for uma cadeia vazia (""), um nome padrão será dado quando o objeto criado for adicionado ao DataRelationCollection.

parentColumns: DataColumn[]

Um array de objetos pais DataColumn .

childColumns: DataColumn[]

Um conjunto de objetos filhos DataColumn .

Exceções

ArgumentNullException

Um ou ambos os DataColumn objetos contêm null.

InvalidConstraintException

Os DataColumn objetos têm diferentes tipos de dados

-Ou-

Um ou ambos os arrays não são compostos por colunas distintas da mesma tabela.

-Ou-

As tabelas não pertencem à mesma DataSet.

Exemplos

O exemplo seguinte cria um novo DataRelation e adiciona-o 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

Ver também

Aplica-se a

DataRelation(String, DataColumn, DataColumn, Boolean)

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Inicializa uma nova instância da DataRelation classe usando o nome especificado, objetos pai e filho DataColumn , e um valor que indica se deve 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 for uma cadeia vazia (""), um nome padrão será dado quando o objeto criado for adicionado ao DataRelationCollection.

parentColumn: DataColumn

O progenitor DataColumn na relação.

childColumn: DataColumn

A criança DataColumn na relação.

createConstraints: Boolean

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

Exceções

ArgumentNullException

Um ou ambos os DataColumn objetos contêm null.

InvalidConstraintException

As colunas têm diferentes tipos de dados

-Ou-

As tabelas não pertencem à mesma DataSet.

Exemplos

O exemplo seguinte cria um novo DataRelation e adiciona-o 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

Ver também

Aplica-se a

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

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Inicializa uma nova instância da DataRelation classe usando o nome especificado, arrays correspondentes de objetos pai e filho DataColumn , e valor que indica se deve 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 for uma cadeia vazia (""), um nome padrão será dado quando o objeto criado for adicionado ao DataRelationCollection.

parentColumns: DataColumn[]

Um array de objetos pais DataColumn .

childColumns: DataColumn[]

Um conjunto de objetos filhos DataColumn .

createConstraints: Boolean

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

Exceções

ArgumentNullException

Um ou ambos os DataColumn objetos é null.

InvalidConstraintException

As colunas têm diferentes tipos de dados

-Ou-

As tabelas não pertencem à mesma DataSet.

Exemplos

O exemplo seguinte cria um novo DataRelation e adiciona-o 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

Ver também

Aplica-se a

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

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Este construtor é fornecido para suporte em tempo de design no ambiente 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 for uma cadeia vazia (""), um nome padrão será dado quando o objeto criado for adicionado ao DataRelationCollection.

parentTableName: String

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

childTableName: String

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

parentColumnNames: String[]

Um array de DataColumn nomes de objetos no pai DataTable da relação.

childColumnNames: String[]

Um array de DataColumn nomes de objetos no filho DataTable da relação.

nested: Boolean

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

Atributos: BrowsableAttribute

Observações

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

Origem:: DataRelation.cs

Origem:: DataRelation.cs

Este construtor é fornecido para suporte em tempo de design no ambiente 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 for uma cadeia vazia (""), um nome padrão será dado quando o objeto criado for adicionado ao DataRelationCollection.

parentTableName: String

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

parentTableNamespace: String

O nome do namespace da tabela principal.

childTableName: String

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

childTableNamespace: String

O nome do espaço de nomes da tabela filha.

parentColumnNames: String[]

Um array de DataColumn nomes de objetos no pai DataTable da relação.

childColumnNames: String[]

Um array de DataColumn nomes de objetos no filho DataTable da relação.

nested: Boolean

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

Atributos: BrowsableAttribute

Observações

Qualquer DataRelation objeto criado usando este construtor deve então 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 este construtor, as tabelas e colunas com os nomes especificados devem existir no momento em que EndInit é chamado.

Aplica-se a

Comentários

Esta página foi útil?