Share via


UniqueConstraint Konstruktoren

Definition

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
Quelle:
UniqueConstraint.cs
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

Gilt für:

UniqueConstraint(DataColumn[])

Quelle:
UniqueConstraint.cs
Quelle:
UniqueConstraint.cs
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

Gilt für:

UniqueConstraint(DataColumn, Boolean)

Quelle:
UniqueConstraint.cs
Quelle:
UniqueConstraint.cs
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

Gilt für:

UniqueConstraint(DataColumn[], Boolean)

Quelle:
UniqueConstraint.cs
Quelle:
UniqueConstraint.cs
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

Gilt für:

UniqueConstraint(String, DataColumn)

Quelle:
UniqueConstraint.cs
Quelle:
UniqueConstraint.cs
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);
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

Gilt für:

UniqueConstraint(String, DataColumn[])

Quelle:
UniqueConstraint.cs
Quelle:
UniqueConstraint.cs
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);
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

Gilt für:

UniqueConstraint(String, DataColumn, Boolean)

Quelle:
UniqueConstraint.cs
Quelle:
UniqueConstraint.cs
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);
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

Gilt für:

UniqueConstraint(String, DataColumn[], Boolean)

Quelle:
UniqueConstraint.cs
Quelle:
UniqueConstraint.cs
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);
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

Gilt für:

UniqueConstraint(String, String[], Boolean)

Quelle:
UniqueConstraint.cs
Quelle:
UniqueConstraint.cs
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)]
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

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

Gilt für: