UniqueConstraint Konstruktoren

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Initialisiert eine neue Instanz der UniqueConstraint-Klasse.

Überlädt

UniqueConstraint(DataColumn)	Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit der angegebenen DataColumn.
UniqueConstraint(DataColumn[])	Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Array von DataColumn-Objekten.
UniqueConstraint(DataColumn, Boolean)	Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit der einzuschränkenden DataColumn und einem Wert, der angibt, ob es sich bei der Einschränkung um einen Primärschlüssel handelt.
UniqueConstraint(DataColumn[], Boolean)	Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit einem Array von einzuschränkenden DataColumn-Objekten sowie einem Wert, der angibt, ob es sich bei der Einschränkung um einen Primärschlüssel handelt.
UniqueConstraint(String, DataColumn)	Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Namen und der angegebenen DataColumn.
UniqueConstraint(String, DataColumn[])	Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Namen und dem angegebenen Array von DataColumn-Objekten.
UniqueConstraint(String, DataColumn, Boolean)	Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Namen, der einzuschränkenden DataColumn sowie einem Wert, der angibt, ob es sich bei der Einschränkung um einen Primärschlüssel handelt.
UniqueConstraint(String, DataColumn[], Boolean)	Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Namen, einem Array von einzuschränkenden DataColumn-Objekten sowie einem Wert, der angibt, ob es sich bei der Einschränkung um einen Primärschlüssel handelt.
UniqueConstraint(String, String[], Boolean)	Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Namen, einem Array von einzuschränkenden DataColumn-Objekten sowie einem Wert, der angibt, ob es sich bei der Einschränkung um einen Primärschlüssel handelt.

UniqueConstraint(DataColumn)

Quelle:

UniqueConstraint.cs

Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit der angegebenen DataColumn.

public:
 UniqueConstraint(System::Data::DataColumn ^ column);

public UniqueConstraint (System.Data.DataColumn column);

new System.Data.UniqueConstraint : System.Data.DataColumn -> System.Data.UniqueConstraint

Public Sub New (column As DataColumn)

Parameter

column

DataColumn

Die einzuschränkende DataColumn.

Beispiele

Im folgenden Beispiel wird ein neues UniqueConstraint erstellt und der ParentKeyConstraint -Eigenschaft eines DataRelationzugewiesen.

Private Sub CreateUniqueConstraint(ByVal dataSetSuppliers As DataSet)
    Dim uniqueConstraint As UniqueConstraint

    ' Get the DataColumn of a table in a DataSet.
    Dim dataColumn As DataColumn
    dataColumn = dataSetSuppliers.Tables("Suppliers").Columns("SupplierID")

    ' Create the constraint.
    uniqueConstraint = New UniqueConstraint("supplierIdConstraint", dataColumn)

    ' Add the constraint to the ConstraintCollection of the DataTable.
    dataSetSuppliers.Tables("Suppliers").Constraints.Add(uniqueConstraint)
End Sub

Weitere Informationen

• Hinzufügen von Einschränkungen zu einer Tabelle

UniqueConstraint(DataColumn[])

Quelle:

UniqueConstraint.cs

Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Array von DataColumn-Objekten.

public:
 UniqueConstraint(cli::array <System::Data::DataColumn ^> ^ columns);

public UniqueConstraint (System.Data.DataColumn[] columns);

new System.Data.UniqueConstraint : System.Data.DataColumn[] -> System.Data.UniqueConstraint

Public Sub New (columns As DataColumn())

Parameter

columns

DataColumn[]

Das Array von einzuschränkenden DataColumn-Objekten.

Weitere Informationen

• Hinzufügen von Einschränkungen zu einer Tabelle

UniqueConstraint(DataColumn, Boolean)

Quelle:

UniqueConstraint.cs

Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit der einzuschränkenden DataColumn und einem Wert, der angibt, ob es sich bei der Einschränkung um einen Primärschlüssel handelt.

public:
 UniqueConstraint(System::Data::DataColumn ^ column, bool isPrimaryKey);

public UniqueConstraint (System.Data.DataColumn column, bool isPrimaryKey);

new System.Data.UniqueConstraint : System.Data.DataColumn * bool -> System.Data.UniqueConstraint

Public Sub New (column As DataColumn, isPrimaryKey As Boolean)

Parameter

column

DataColumn

Die einzuschränkende DataColumn.

isPrimaryKey

Boolean

true gibt an, dass die Einschränkung ein Primärschlüssel ist, andernfalls false.

Weitere Informationen

• Hinzufügen von Einschränkungen zu einer Tabelle

UniqueConstraint(DataColumn[], Boolean)

Quelle:

UniqueConstraint.cs

Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit einem Array von einzuschränkenden DataColumn-Objekten sowie einem Wert, der angibt, ob es sich bei der Einschränkung um einen Primärschlüssel handelt.

public:
 UniqueConstraint(cli::array <System::Data::DataColumn ^> ^ columns, bool isPrimaryKey);

public UniqueConstraint (System.Data.DataColumn[] columns, bool isPrimaryKey);

new System.Data.UniqueConstraint : System.Data.DataColumn[] * bool -> System.Data.UniqueConstraint

Public Sub New (columns As DataColumn(), isPrimaryKey As Boolean)

Parameter

columns

DataColumn[]

Ein Array von einzuschränkenden DataColumn-Objekten.

isPrimaryKey

Boolean

true gibt an, dass die Einschränkung ein Primärschlüssel ist, andernfalls false.

Weitere Informationen

• Hinzufügen von Einschränkungen zu einer Tabelle

UniqueConstraint(String, DataColumn)

Quelle:

UniqueConstraint.cs

Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Namen und der angegebenen DataColumn.

public:
 UniqueConstraint(System::String ^ name, System::Data::DataColumn ^ column);

public UniqueConstraint (string? name, System.Data.DataColumn column);

new System.Data.UniqueConstraint : string * System.Data.DataColumn -> System.Data.UniqueConstraint

Public Sub New (name As String, column As DataColumn)

Parameter

name

String

Der Name der Einschränkung.

column

DataColumn

Die einzuschränkende DataColumn.

Beispiele

Im folgenden Beispiel wird ein neues UniqueConstraint erstellt und der ParentKeyConstraint -Eigenschaft eines DataRelationzugewiesen.

Private Sub CreateUniqueConstraint(ByVal dataSetSuppliers As DataSet)
    Dim uniqueConstraint As UniqueConstraint

    ' Get the DataColumn of a table in a DataSet.
    Dim dataColumn As DataColumn
    dataColumn = dataSetSuppliers.Tables("Suppliers").Columns("SupplierID")

    ' Create the constraint.
    uniqueConstraint = New UniqueConstraint("supplierIdConstraint", dataColumn)

    ' Add the constraint to the ConstraintCollection of the DataTable.
    dataSetSuppliers.Tables("Suppliers").Constraints.Add(uniqueConstraint)
End Sub

Weitere Informationen

• DataRelation
• ParentKeyConstraint
• Hinzufügen von Einschränkungen zu einer Tabelle

UniqueConstraint(String, DataColumn[])

Quelle:

UniqueConstraint.cs

Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Namen und dem angegebenen Array von DataColumn-Objekten.

public:
 UniqueConstraint(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns);

public UniqueConstraint (string? name, System.Data.DataColumn[] columns);

new System.Data.UniqueConstraint : string * System.Data.DataColumn[] -> System.Data.UniqueConstraint

Public Sub New (name As String, columns As DataColumn())

Parameter

name

String

Der Name der Einschränkung.

columns

DataColumn[]

Das Array von einzuschränkenden DataColumn-Objekten.

Beispiele

Im folgenden Beispiel wird ein DataTable mit zwei Spalten erstellt und der ConstraintCollectioneine neue UniqueConstraint hinzugefügt.

static private void MakeTableWithUniqueConstraint()
{
    // Create a DataTable with 2 DataColumns.
    DataTable dataTable = new DataTable("dataTable");
    DataColumn idColumn = new DataColumn(
        "id", System.Type.GetType("System.Int32"));
    DataColumn nameColumn = new DataColumn(
        "Name", System.Type.GetType("System.String"));
    dataTable.Columns.Add(idColumn);
    dataTable.Columns.Add(nameColumn);

    // Run procedure to create a constraint.
    AddUniqueConstraint(dataTable);

    // Add one row to the table.
    DataRow dataRow;
    dataRow = dataTable.NewRow();
    dataRow["id"] = 1;
    dataRow["Name"] = "John";
    dataTable.Rows.Add(dataRow);

    // Display the constraint name.
    Console.WriteLine(
        dataTable.Constraints[0].ConstraintName);

    // Try to add an identical row,
    // which throws an exception.
    try
    {
        dataRow = dataTable.NewRow();
        dataRow["id"] = 1;
        dataRow["Name"] = "John";
        dataTable.Rows.Add(dataRow);
    }
    catch (Exception ex)
    {
        Console.WriteLine(
            "Exception Type: {0}", ex.GetType());
        Console.WriteLine(
            "Exception Message: {0}", ex.Message);
    }
}
static private void AddUniqueConstraint(
    DataTable dataTable)
{
    // Create the DataColumn array.
    DataColumn[] dataColumns = new DataColumn[2];
    dataColumns[0] = dataTable.Columns["id"];
    dataColumns[1] = dataTable.Columns["Name"];

    // Create the constraint on both columns.
    UniqueConstraint uniqueConstraint =
        new UniqueConstraint("idNameConstraint", dataColumns);
    dataTable.Constraints.Add(uniqueConstraint);
}

Private Sub MakeTableWithUniqueConstraint()
    ' Create a DataTable with 2 DataColumns.
    Dim dataTable As New DataTable("dataTable")
    Dim idColumn As New DataColumn( _
        "ID", System.Type.GetType("System.Int32"))
    Dim nameColumn As New DataColumn( _
        "Name", System.Type.GetType("System.String"))
    dataTable.Columns.Add(idColumn)
    dataTable.Columns.Add(nameColumn)

    ' Run procedure to create a constraint.
    AddUniqueConstraint(dataTable)

    ' Add one row to the table.
    Dim dataRow As DataRow
    dataRow = dataTable.NewRow()
    dataRow("ID") = 1
    dataRow("Name") = "John"
    dataTable.Rows.Add(dataRow)

    ' Display the constraint name.
    Console.WriteLine(dataTable.Constraints(0).ConstraintName)

    ' Try to add an identical row,
    ' which throws an exception.
    Try
        dataRow = dataTable.NewRow()
        dataRow("ID") = 1
        dataRow("Name") = "John"
        dataTable.Rows.Add(dataRow)
    Catch ex As Exception
        Console.WriteLine("Exception Type: {0}", ex.GetType())
        Console.WriteLine("Exception Message: {0}", ex.Message)
    End Try
End Sub

Private Sub AddUniqueConstraint(ByVal dataTable As DataTable)
    ' Create the DataColumn array.
    Dim dataColumns(1) As DataColumn
    dataColumns(0) = dataTable.Columns("ID")
    dataColumns(1) = dataTable.Columns("Name")

    ' Create the constraint on both columns.
    Dim uniqueConstraint As UniqueConstraint = _
        New UniqueConstraint("idNameConstraint", dataColumns)
    dataTable.Constraints.Add(uniqueConstraint)
End Sub

Weitere Informationen

• Hinzufügen von Einschränkungen zu einer Tabelle

UniqueConstraint(String, DataColumn, Boolean)

Quelle:

UniqueConstraint.cs

Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Namen, der einzuschränkenden DataColumn sowie einem Wert, der angibt, ob es sich bei der Einschränkung um einen Primärschlüssel handelt.

public:
 UniqueConstraint(System::String ^ name, System::Data::DataColumn ^ column, bool isPrimaryKey);

public UniqueConstraint (string? name, System.Data.DataColumn column, bool isPrimaryKey);

new System.Data.UniqueConstraint : string * System.Data.DataColumn * bool -> System.Data.UniqueConstraint

Public Sub New (name As String, column As DataColumn, isPrimaryKey As Boolean)

Parameter

name

String

Der Name der Einschränkung.

column

DataColumn

Die einzuschränkende DataColumn.

isPrimaryKey

Boolean

true gibt an, dass die Einschränkung ein Primärschlüssel ist, andernfalls false.

Weitere Informationen

• Hinzufügen von Einschränkungen zu einer Tabelle

UniqueConstraint(String, DataColumn[], Boolean)

Quelle:

UniqueConstraint.cs

Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Namen, einem Array von einzuschränkenden DataColumn-Objekten sowie einem Wert, der angibt, ob es sich bei der Einschränkung um einen Primärschlüssel handelt.

public:
 UniqueConstraint(System::String ^ name, cli::array <System::Data::DataColumn ^> ^ columns, bool isPrimaryKey);

public UniqueConstraint (string? name, System.Data.DataColumn[] columns, bool isPrimaryKey);

new System.Data.UniqueConstraint : string * System.Data.DataColumn[] * bool -> System.Data.UniqueConstraint

Public Sub New (name As String, columns As DataColumn(), isPrimaryKey As Boolean)

Parameter

name

String

Der Name der Einschränkung.

columns

DataColumn[]

Ein Array von einzuschränkenden DataColumn-Objekten.

isPrimaryKey

Boolean

true gibt an, dass die Einschränkung ein Primärschlüssel ist, andernfalls false.

Weitere Informationen

• Hinzufügen von Einschränkungen zu einer Tabelle

UniqueConstraint(String, String[], Boolean)

Quelle:

UniqueConstraint.cs

Initialisiert eine neue Instanz der UniqueConstraint-Klasse mit dem angegebenen Namen, einem Array von einzuschränkenden DataColumn-Objekten sowie einem Wert, der angibt, ob es sich bei der Einschränkung um einen Primärschlüssel handelt.

public:
 UniqueConstraint(System::String ^ name, cli::array <System::String ^> ^ columnNames, bool isPrimaryKey);

[System.ComponentModel.Browsable(false)]
public UniqueConstraint (string? name, string[]? columnNames, bool isPrimaryKey);

[<System.ComponentModel.Browsable(false)>]
new System.Data.UniqueConstraint : string * string[] * bool -> System.Data.UniqueConstraint

Public Sub New (name As String, columnNames As String(), isPrimaryKey As Boolean)

Parameter

name

String

Der Name der Einschränkung.

columnNames

String[]

Ein Array von einzuschränkenden DataColumn-Objekten.

isPrimaryKey

Boolean

true gibt an, dass die Einschränkung ein Primärschlüssel ist, andernfalls false.

Attribute

BrowsableAttribute

Hinweise

Dieser Konstruktor wird für die Entwurfszeitunterstützung in der Visual Studio .NET-Umgebung bereitgestellt. Mit diesem Konstruktor erstellte UniqueConstraint-Objekte müssen der Auflistung anschließend über AddRange hinzugefügt werden. Spalten mit den angegebenen Namen müssen zum Zeitpunkt des Aufrufs der Methode vorhanden sein, oder wenn BeginInit vor dem Aufruf dieses Konstruktors aufgerufen wurde, müssen die Spalten mit den angegebenen Namen zum Zeitpunkt EndInit des Aufrufs vorhanden sein.

Weitere Informationen

• Hinzufügen von Einschränkungen zu einer Tabelle