.NET Framework Class Library UniqueConstraint Class Represents a restriction on a set of columns in which all values must be unique.
Inheritance Hierarchy
Namespace:
System.Data
Assembly:
System.Data (in System.Data.dll)
Syntax
Public Class UniqueConstraint _
Inherits Constraint
public class UniqueConstraint : Constraint
public ref class UniqueConstraint : public Constraint
type UniqueConstraint =
class
inherit Constraint
end
The UniqueConstraint type exposes the following members.
Constructors
|
| Name | Description |
|---|
.gif) .gif) | UniqueConstraint(DataColumn) | Initializes a new instance of the UniqueConstraint class with the specified DataColumn. | | UniqueConstraint(array<DataColumn>[]()[]) | Initializes a new instance of the UniqueConstraint class with the given array of DataColumn objects. | | UniqueConstraint(DataColumn, Boolean) | Initializes a new instance of the UniqueConstraint class with the DataColumn to constrain, and a value specifying whether the constraint is a primary key. | | UniqueConstraint(array<DataColumn>[]()[], Boolean) | Initializes a new instance of the UniqueConstraint class with an array of DataColumn objects to constrain, and a value specifying whether the constraint is a primary key. | | UniqueConstraint(String, DataColumn) | Initializes a new instance of the UniqueConstraint class with the specified name and DataColumn. | | UniqueConstraint(String, array<DataColumn>[]()[]) | Initializes a new instance of the UniqueConstraint class with the specified name and array of DataColumn objects. | | UniqueConstraint(String, DataColumn, Boolean) | Initializes a new instance of the UniqueConstraint class with the specified name, the DataColumn to constrain, and a value specifying whether the constraint is a primary key. | | UniqueConstraint(String, array<DataColumn>[]()[], Boolean) | Initializes a new instance of the UniqueConstraint class with the specified name, an array of DataColumn objects to constrain, and a value specifying whether the constraint is a primary key. | | UniqueConstraint(String, array<String>[]()[], Boolean) | Initializes a new instance of the UniqueConstraint class with the specified name, an array of DataColumn objects to constrain, and a value specifying whether the constraint is a primary key. |
Top
Properties
Methods
Remarks
The UniqueConstraint is enforced on a single column (or columns) to ensure that a primary key value is unique. Constraints are not enforced unless the EnforceConstraints property is set to true. When the a DataSet is merged with a second DataSet, constraints are not enforced until all merges are completed.
Examples
The following example adds a UniqueConstraint to a DataSet and sets the EnforceConstraints property to true.
Public Sub CreateDataTable()
Dim dataTable As DataTable = New DataTable
dataTable.Columns.Add("CustomerID", Type.GetType("System.String"))
dataTable.Columns.Add("CompanyName", Type.GetType("System.String"))
Dim uniqueConstraint As UniqueConstraint = _
New UniqueConstraint("CustConstraint", _
New DataColumn() {dataTable.Columns("CustomerID"), _
dataTable.Columns("CompanyName")})
dataTable.Constraints.Add(uniqueConstraint)
End Sub
Version Information
.NET FrameworkSupported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0 .NET Framework Client ProfileSupported in: 4, 3.5 SP1
Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Thread Safety
This type is suitable for multithreaded read operations. You must synchronize any write operations.
See Also
|
Biblioteca de clases de .NET Framework UniqueConstraint (Clase) Representa una restricción en un conjunto de columnas en el que todos los valores deben ser únicos.
Jerarquía de herencia
Espacio de nombres:
System.Data
Ensamblado:
System.Data (en System.Data.dll)
Sintaxis
Public Class UniqueConstraint _
Inherits Constraint
public class UniqueConstraint : Constraint
public ref class UniqueConstraint : public Constraint
type UniqueConstraint =
class
inherit Constraint
end
El tipo UniqueConstraint expone los siguientes miembros.
Constructores
|
| Nombre | Descripción |
|---|
| UniqueConstraint(DataColumn) | Inicializa una nueva instancia de la clase UniqueConstraint con la enumeración DataColumn especificada. | | UniqueConstraint(array<DataColumn>[]()[]) | Inicializa una nueva instancia de la clase UniqueConstraint con la matriz de objetos dada DataColumn. | | UniqueConstraint(DataColumn, Boolean) | Inicializa una nueva instancia de la clase UniqueConstraint con el DataColumn que se va a restringir y un valor que especifica si la restricción es una clave principal. | | UniqueConstraint(array<DataColumn>[]()[], Boolean) | Inicializa una nueva instancia de la clase UniqueConstraint con una matriz de objetos DataColumn que se va a restringir y un valor que especifica si la restricción es una clave principal. | | UniqueConstraint(String, DataColumn) | Inicializa una nueva instancia de la clase UniqueConstraint con el nombre y DataColumn especificados. | | UniqueConstraint(String, array<DataColumn>[]()[]) | Inicializa una nueva instancia de la clase UniqueConstraint con el nombre y la matriz de objetos DataColumn especificados. | | UniqueConstraint(String, DataColumn, Boolean) | Inicializa una nueva instancia de la clase UniqueConstraint con el nombre especificado, el DataColumn que se va a restringir y un valor que especifica si la restricción es una clave principal. | | UniqueConstraint(String, array<DataColumn>[]()[], Boolean) | Inicializa una nueva instancia de la clase UniqueConstraint con el nombre especificado, una matriz de objetos DataColumn que se va a restringir y un valor que especifica si la restricción es una clave principal. | | UniqueConstraint(String, array<String>[]()[], Boolean) | Inicializa una nueva instancia de la clase UniqueConstraint con el nombre especificado, una matriz de objetos DataColumn que se va a restringir y un valor que especifica si la restricción es una clave principal. |
Arriba
Propiedades
Métodos
Comentarios
UniqueConstraint se fuerza en una sola columna (o columnas) para garantizar que un valor de clave principal es único. Las restricciones no se fuerzan a menos que la propiedad EnforceConstraints esté establecida en true. Cuando un DataSet se combina con un segundo DataSet, las restricciones no se fuerzan hasta que se completan todos las combinaciones.
Ejemplos
En el ejemplo siguiente se agrega un UniqueConstraint a un DataSet y se establece la propiedad EnforceConstraints en true.
Public Sub CreateDataTable()
Dim dataTable As DataTable = New DataTable
dataTable.Columns.Add("CustomerID", Type.GetType("System.String"))
dataTable.Columns.Add("CompanyName", Type.GetType("System.String"))
Dim uniqueConstraint As UniqueConstraint = _
New UniqueConstraint("CustConstraint", _
New DataColumn() {dataTable.Columns("CustomerID"), _
dataTable.Columns("CompanyName")})
dataTable.Constraints.Add(uniqueConstraint)
End Sub
Información de versión
.NET FrameworkCompatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0 .NET Framework Client ProfileCompatible con: 4, 3.5 SP1
Plataformas
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Seguridad para subprocesos
Este tipo es adecuado para operaciones de lectura multiproceso. Debe sincronizar cualquier operación de escritura.
Vea también
|