UniqueConstraint 建構函式

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

初始化 UniqueConstraint 類別的新執行個體。

多載

UniqueConstraint(DataColumn)	使用指定的 UniqueConstraint 初始化 DataColumn 類別的新執行個體。
UniqueConstraint(DataColumn[])	使用 UniqueConstraint 物件的指定陣列，初始化 DataColumn 類別的新執行個體。
UniqueConstraint(DataColumn, Boolean)	使用要限制的 UniqueConstraint 和指定條件約束是否為主索引鍵的值，來初始化 DataColumn 類別的新執行個體。
UniqueConstraint(DataColumn[], Boolean)	使用要限制的 UniqueConstraint 物件陣列和指定條件約束是否為主索引鍵的值，來初始化 DataColumn 類別的新執行個體。
UniqueConstraint(String, DataColumn)	使用指定名稱和 UniqueConstraint 來初始化 DataColumn 類別的新執行個體。
UniqueConstraint(String, DataColumn[])	使用指定名稱和 UniqueConstraint 物件的陣列，來初始化 DataColumn 類別的新執行個體。
UniqueConstraint(String, DataColumn, Boolean)	使用指定名稱、要限制的 UniqueConstraint 和指定條件約束是否為主索引鍵的值，來初始化 DataColumn 類別的新執行個體。
UniqueConstraint(String, DataColumn[], Boolean)	使用指定名稱、要限制的 UniqueConstraint 物件陣列和指定條件約束是否為主索引鍵的值，來初始化 DataColumn 類別的新執行個體。
UniqueConstraint(String, String[], Boolean)	使用指定名稱、要限制的 UniqueConstraint 物件陣列和指定條件約束是否為主索引鍵的值，來初始化 DataColumn 類別的新執行個體。

UniqueConstraint(DataColumn)

來源:

UniqueConstraint.cs

使用指定的 UniqueConstraint 初始化 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)

參數

column

DataColumn

要限制的 DataColumn。

範例

下列範例會建立新的 UniqueConstraint ，並將它指派給 ParentKeyConstraint 的 DataRelation屬性。

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

另請參閱

• 將條件約束新增至數據表

UniqueConstraint(DataColumn[])

來源:

UniqueConstraint.cs

使用 UniqueConstraint 物件的指定陣列，初始化 DataColumn 類別的新執行個體。

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

參數

columns

DataColumn[]

要限制的 DataColumn 物件陣列。

另請參閱

• 將條件約束新增至數據表

UniqueConstraint(DataColumn, Boolean)

來源:

UniqueConstraint.cs

使用要限制的 UniqueConstraint 和指定條件約束是否為主索引鍵的值，來初始化 DataColumn 類別的新執行個體。

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)

參數

column

DataColumn

要限制的 DataColumn。

isPrimaryKey

Boolean

若要指示條件約束是主索引鍵，則為 true，否則為 false。

另請參閱

• 將條件約束新增至數據表

UniqueConstraint(DataColumn[], Boolean)

來源:

UniqueConstraint.cs

使用要限制的 UniqueConstraint 物件陣列和指定條件約束是否為主索引鍵的值，來初始化 DataColumn 類別的新執行個體。

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)

參數

columns

DataColumn[]

要限制的 DataColumn 物件陣列。

isPrimaryKey

Boolean

若要指示條件約束是主索引鍵，則為 true，否則為 false。

另請參閱

• 將條件約束新增至數據表

UniqueConstraint(String, DataColumn)

來源:

UniqueConstraint.cs

使用指定名稱和 UniqueConstraint 來初始化 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)

參數

name

String

條件約束的名稱。

column

DataColumn

要限制的 DataColumn。

範例

下列範例會建立新的 UniqueConstraint ，並將它指派給 ParentKeyConstraint 的 DataRelation屬性。

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

另請參閱

• DataRelation
• ParentKeyConstraint
• 將條件約束新增至數據表

UniqueConstraint(String, DataColumn[])

來源:

UniqueConstraint.cs

使用指定名稱和 UniqueConstraint 物件的陣列，來初始化 DataColumn 類別的新執行個體。

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

參數

name

String

條件約束的名稱。

columns

DataColumn[]

要限制的 DataColumn 物件陣列。

範例

下列範例會 DataTable 建立具有兩個資料行的 ，並將新的 UniqueConstraint 加入至 ConstraintCollection。

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

另請參閱

• 將條件約束新增至數據表

UniqueConstraint(String, DataColumn, Boolean)

來源:

UniqueConstraint.cs

使用指定名稱、要限制的 UniqueConstraint 和指定條件約束是否為主索引鍵的值，來初始化 DataColumn 類別的新執行個體。

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)

參數

name

String

條件約束的名稱。

column

DataColumn

要限制的 DataColumn。

isPrimaryKey

Boolean

若要指示條件約束是主索引鍵，則為 true，否則為 false。

另請參閱

• 將條件約束新增至數據表

UniqueConstraint(String, DataColumn[], Boolean)

來源:

UniqueConstraint.cs

使用指定名稱、要限制的 UniqueConstraint 物件陣列和指定條件約束是否為主索引鍵的值，來初始化 DataColumn 類別的新執行個體。

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)

參數

name

String

條件約束的名稱。

columns

DataColumn[]

要限制的 DataColumn 物件陣列。

isPrimaryKey

Boolean

若要指示條件約束是主索引鍵，則為 true，否則為 false。

另請參閱

• 將條件約束新增至數據表

UniqueConstraint(String, String[], Boolean)

來源:

UniqueConstraint.cs

使用指定名稱、要限制的 UniqueConstraint 物件陣列和指定條件約束是否為主索引鍵的值，來初始化 DataColumn 類別的新執行個體。

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)

參數

name

String

條件約束的名稱。

columnNames

String[]

要限制的 DataColumn 物件陣列。

isPrimaryKey

Boolean

若要指示條件約束是主索引鍵，則為 true，否則為 false。

屬性

BrowsableAttribute

備註

此建構函式是在 Visual Studio .NET 環境中提供設計時間支援。 接著必須透過 UniqueConstraint，將使用此建構函式建立的 AddRange 物件加入至集合中。 呼叫方法時必須存在具有指定名稱的數據行，或者如果在 BeginInit 呼叫這個建構函式之前已呼叫，則具有指定名稱的數據行必須在呼叫時 EndInit 存在。

另請參閱

• 將條件約束新增至數據表