DataRelationCollection.Add Metodo

Definizione

Aggiunge un oggetto DataRelation a DataRelationCollection.

Overload

Add(DataRelation)

Aggiunge un oggetto DataRelation a DataRelationCollection.

Add(DataColumn, DataColumn)

Crea un oggetto DataRelation con una colonna padre e figlio specificata e lo aggiunge all'insieme.

Add(DataColumn[], DataColumn[])

Crea un oggetto DataRelation con le colonne padre e figlio specificate e lo aggiunge all'insieme.

Add(String, DataColumn, DataColumn)

Crea un oggetto DataRelation con il nome e le colonne padre e figlio specificati e lo aggiunge all'insieme.

Add(String, DataColumn[], DataColumn[])

Crea un oggetto DataRelation con il nome e le matrici di colonne padre e figlio specificati e lo aggiunge all'insieme.

Add(String, DataColumn, DataColumn, Boolean)

Crea una classe DataRelation con il nome specificato, le colonne padre e figlio e i vincoli facoltativi in base al valore del parametro createConstraints, quindi aggiunge la classe all'insieme.

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

Crea un oggetto DataRelation con il nome specificato, le matrici di colonne padre e figlio e il valore che specifica se va creato un vincolo e lo aggiunge all'insieme.

Add(DataRelation)

Aggiunge un oggetto DataRelation a DataRelationCollection.

public:
 void Add(System::Data::DataRelation ^ relation);
public void Add (System.Data.DataRelation relation);
member this.Add : System.Data.DataRelation -> unit
Public Sub Add (relation As DataRelation)

Parametri

relation
DataRelation

Oggetto DataRelation da aggiungere alla raccolta.

Eccezioni

Il parametro relation è un valore null.

La relazione appartiene già a questo insieme oppure appartiene a un altro insieme.

L'insieme dispone già di una relazione con il nome specificato. Per il confronto non viene effettuata alcuna distinzione tra maiuscole e minuscole.

La relazione è in uno stato non valido dal momento in cui è stata creata.

Commenti

Se la relazione viene aggiunta correttamente alla raccolta, si verifica l'evento CollectionChanged .

Quando un DataRelation oggetto viene aggiunto all'insieme ForeignKeyConstraint e UniqueConstraint gli oggetti vengono creati per impostazione predefinita se non esistono già.

Vedi anche

Si applica a

Add(DataColumn, DataColumn)

Crea un oggetto DataRelation con una colonna padre e figlio specificata e lo aggiunge all'insieme.

public:
 virtual System::Data::DataRelation ^ Add(System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);
public virtual System.Data.DataRelation Add (System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
abstract member Add : System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
override this.Add : System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
Public Overridable Function Add (parentColumn As DataColumn, childColumn As DataColumn) As DataRelation

Parametri

parentColumn
DataColumn

Colonna padre della relazione.

childColumn
DataColumn

Colonna figlio della relazione.

Restituisce

Relazione creata.

Commenti

Quando un DataRelation oggetto viene aggiunto all'insieme ForeignKeyConstraint e UniqueConstraint gli oggetti vengono creati per impostazione predefinita se non esistono già.

Vedi anche

Si applica a

Add(DataColumn[], DataColumn[])

Crea un oggetto DataRelation con le colonne padre e figlio specificate e lo aggiunge all'insieme.

public:
 virtual System::Data::DataRelation ^ Add(cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);
public virtual System.Data.DataRelation Add (System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
abstract member Add : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
override this.Add : System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
Public Overridable Function Add (parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelation

Parametri

parentColumns
DataColumn[]

Colonne padre della relazione.

childColumns
DataColumn[]

Colonne figlio della relazione.

Restituisce

Relazione creata.

Eccezioni

L'argomento relation è un valore null.

La relazione appartiene già a questo insieme oppure appartiene a un altro insieme.

L'insieme dispone già di una relazione con lo stesso nome. Per il confronto non viene effettuata alcuna distinzione tra maiuscole e minuscole.

La relazione è in uno stato non valido dal momento in cui è stata creata.

Commenti

Quando un DataRelation oggetto viene aggiunto all'insieme ForeignKeyConstraint e UniqueConstraint gli oggetti vengono creati per impostazione predefinita se non esistono già.

Vedi anche

Si applica a

Add(String, DataColumn, DataColumn)

Crea un oggetto DataRelation con il nome e le colonne padre e figlio specificati e lo aggiunge all'insieme.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn);
public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn);
abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn -> System.Data.DataRelation
Public Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn) As DataRelation

Parametri

name
String

Nome della relazione.

parentColumn
DataColumn

Colonna padre della relazione.

childColumn
DataColumn

Colonna figlio della relazione.

Restituisce

Relazione creata.

Commenti

Quando un DataRelation oggetto viene aggiunto all'insieme ForeignKeyConstraint e UniqueConstraint gli oggetti vengono creati per impostazione predefinita se non esistono già.

Vedi anche

Si applica a

Add(String, DataColumn[], DataColumn[])

Crea un oggetto DataRelation con il nome e le matrici di colonne padre e figlio specificati e lo aggiunge all'insieme.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns);
public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns);
abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] -> System.Data.DataRelation
Public Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn()) As DataRelation

Parametri

name
String

Nome dell'oggetto DataRelation da creare.

parentColumns
DataColumn[]

Matrice di oggetti DataColumn padre.

childColumns
DataColumn[]

Matrice di oggetti DataColumn figlio.

Restituisce

Oggetto DataRelation creato.

Eccezioni

Il nome della relazione è un valore null.

La relazione appartiene già a questo insieme oppure appartiene a un altro insieme.

L'insieme dispone già di una relazione con lo stesso nome. Per il confronto non viene effettuata alcuna distinzione tra maiuscole e minuscole.

La relazione è in uno stato non valido dal momento in cui è stata creata.

Esempio

private void AddRelation()
{
    DataTable table = new DataTable();
    DataColumn column1 = table.Columns.Add("Column1");
    DataColumn column2 = table.Columns.Add("Column2");
    table.ChildRelations.Add("New Relation", column1, column2);
}
Private Sub AddRelation()
    Dim table As New DataTable()
    Dim column1 As DataColumn = table.Columns.Add("Column1")
    Dim column2 As DataColumn = table.Columns.Add("Column2")
    table.ChildRelations.Add("New Relation", column1, column2)
End Sub

Commenti

Se la relazione viene aggiunta correttamente alla raccolta, si verifica l'evento CollectionChanged .

Quando un DataRelation oggetto viene aggiunto all'insieme ForeignKeyConstraint e UniqueConstraint gli oggetti vengono creati per impostazione predefinita se non esistono già.

Vedi anche

Si applica a

Add(String, DataColumn, DataColumn, Boolean)

Crea una classe DataRelation con il nome specificato, le colonne padre e figlio e i vincoli facoltativi in base al valore del parametro createConstraints, quindi aggiunge la classe all'insieme.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, System::Data::DataColumn ^ parentColumn, System::Data::DataColumn ^ childColumn, bool createConstraints);
public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);
public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn parentColumn, System.Data.DataColumn childColumn, bool createConstraints);
abstract member Add : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn * System.Data.DataColumn * bool -> System.Data.DataRelation
Public Overridable Function Add (name As String, parentColumn As DataColumn, childColumn As DataColumn, createConstraints As Boolean) As DataRelation

Parametri

name
String

Nome della relazione.

parentColumn
DataColumn

Colonna padre della relazione.

childColumn
DataColumn

Colonna figlio della relazione.

createConstraints
Boolean

true per creare vincoli; in caso contrario, false. L'impostazione predefinita è true.

Restituisce

Relazione creata.

Commenti

Quando un DataRelation oggetto viene aggiunto all'insieme ForeignKeyConstraint e UniqueConstraint gli oggetti vengono creati per impostazione predefinita se non esistono già. Per evitare questo problema, è possibile impostare su createConstraints false.

Vedi anche

Si applica a

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

Crea un oggetto DataRelation con il nome specificato, le matrici di colonne padre e figlio e il valore che specifica se va creato un vincolo e lo aggiunge all'insieme.

public:
 virtual System::Data::DataRelation ^ Add(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ parentColumns, cli::array <System::Data::DataColumn ^> ^ childColumns, bool createConstraints);
public virtual System.Data.DataRelation Add (string? name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);
public virtual System.Data.DataRelation Add (string name, System.Data.DataColumn[] parentColumns, System.Data.DataColumn[] childColumns, bool createConstraints);
abstract member Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation
override this.Add : string * System.Data.DataColumn[] * System.Data.DataColumn[] * bool -> System.Data.DataRelation
Public Overridable Function Add (name As String, parentColumns As DataColumn(), childColumns As DataColumn(), createConstraints As Boolean) As DataRelation

Parametri

name
String

Nome dell'oggetto DataRelation da creare.

parentColumns
DataColumn[]

Matrice di oggetti DataColumn padre.

childColumns
DataColumn[]

Matrice di oggetti DataColumn figlio.

createConstraints
Boolean

true per creare un vincolo; in caso contrario, false.

Restituisce

Relazione creata.

Eccezioni

Il nome della relazione è un valore null.

La relazione appartiene già a questo insieme oppure appartiene a un altro insieme.

L'insieme dispone già di una relazione con lo stesso nome. Per il confronto non viene effettuata alcuna distinzione tra maiuscole e minuscole.

La relazione è in uno stato non valido dal momento in cui è stata creata.

Commenti

Quando un DataRelation oggetto viene aggiunto all'insieme ForeignKeyConstraint e UniqueConstraint gli oggetti vengono creati per impostazione predefinita se non esistono già.

Vedi anche

Si applica a