Utilisation des types de données
Il existe des données de nombreux types et tailles différents, telles qu'une chaîne qui a une longueur définie, un nombre qui a une précision spécifique ou un type de données défini par l'utilisateur qui est un autre objet ayant son propre jeu de règles. L'objet DataType classifie le type de données afin qu'il puisse être géré correctement par Microsoft SQL Server. L'objet DataType est associé aux objets qui acceptent des données. Les objets SQL Server Management Objects (SMO) suivants acceptent des données qui doivent être définies par une propriété d'objet DataType :
La propriété DataType pour les objets qui acceptent des données peut être définie de plusieurs façons.
Utilisez le constructeur par défaut et spécifiez des propriétés d'objet DataType explicitement.
Utilisez un constructeur surchargé et spécifiez les propriétés DataType comme paramètres.
Spécifiez le type DataType inline dans le constructeur d'objet.
Utilisez l'un des membres statiques de la classe DataType, par exemple Int. Cela retourne en fait une instance d'un objet DataType.
L'objet DataType a plusieurs propriétés qui définissent le type de données. Par exemple, la propriété SqlDataType spécifie le type de données SQL Server. Les valeurs constantes qui représentent des types de données SQL Server sont répertoriées dans l'énumération SqlDataType. Cela fait référence à des types de données tels que varchar, nchar, currency, integer, float et datetime.
Lorsque le type de données est établi, des propriétés spécifiques doivent être définies pour les données. Par exemple, s'il s'agit d'un type nchar, la longueur des données de chaîne doit être définie dans la propriété Length. La même règle s'applique aux valeurs numériques, pour lesquelles il vous faudrait spécifier la précision et l'échelle.
Les types de données UserDefinedDataType et UserDefinedType font référence à des objets qui contiennent la définition du type de données défini par l'utilisateur. Le type UserDefinedDataType est basé sur les types de données SQL Server de l'énumération SqlDataType. Le type UserDefinedType est basé sur les types de données Microsoft .NET. En général, ces types représentent des données d'un type spécifique qui est fréquemment réutilisé par la base de données à cause de règles d'entreprise définies par l'organisation. Par exemple, un type de données qui stocke une somme d'argent et un dénominateur de devise serait utile dans une société qui négocie dans plusieurs devises.
L'énumération SqlDataType contient une liste de tous les types de données pris en charge par SQL Server.
Exemples
Pour utiliser un exemple de code fourni, vous devrez sélectionner l'environnement, le modèle et le langage de programmation dans lequel créer votre application. Pour plus d'informations, consultez « Procédure : créer un projet Visual Basic SMO dans Visual Studio .NET » ou « Procédure : créer un projet Visual C# SMO dans Visual Studio .NET » dans la documentation en ligne de SQL Server.
Construction d'un objet DataType avec la spécification dans le constructeur en Visual Basic
Cet exemple de code montre comment utiliser le constructeur pour créer des instances de types de données basées sur différents types de données SQL Server.
Notes
Les types UserDefinedType, UserDefinedDataType et XML requièrent tous une valeur de nom afin d'identifier l'objet.
'Declare a DataType object variable and define the data type in the constructor.
Dim dt As DataType
'For the decimal data type the following two arguements specify precision, and scale.
dt = New DataType(SqlDataType.Decimal, 10, 2)
Construction d'un objet DataType avec la spécification dans le constructeur en Visual C#
Cet exemple de code montre comment utiliser le constructeur pour créer des instances de types de données basées sur différents types de données SQL Server.
Notes
Les types UserDefinedType, UserDefinedDataType et XML requièrent tous une valeur de nom afin d'identifier l'objet.
{
//Declare a DataType object variable and define the data type in the constructor.
DataType dt;
//For the decimal data type the following two arguements specify precision, and scale.
dt = new DataType(SqlDataType.Decimal, 10, 2);
}
Construction d'un objet DataType à l'aide du constructeur par défaut en Visual Basic
Cet exemple de code montre comment utiliser le constructeur par défaut pour créer des instances de types de données basées sur différents types de données SQL Server. Les propriétés sont ensuite utilisées pour spécifier le type de données.
Remarque Les types UserDefinedType, UserDefinedDataType et XML requièrent tous une valeur de nom afin d'identifier l'objet.
'Declare and create a DataType object variable.
Dim dt As DataType
dt = New DataType
'Define the data type by setting the SqlDataType property.
dt.SqlDataType = SqlDataType.VarChar
'The VarChar data type requires a value for the MaximumLength property.
dt.MaximumLength = 100
Construction d'un objet DataType à l'aide du constructeur par défaut en Visual C#
Cet exemple de code montre comment utiliser le constructeur par défaut pour créer des instances de types de données basées sur différents types de données SQL Server. Les propriétés sont ensuite utilisées pour spécifier le type de données.
Remarque Les types UserDefinedType, UserDefinedDataType et XML requièrent tous une valeur de nom afin d'identifier l'objet.
{
//Declare and create a DataType object variable.
DataType dt;
dt = new DataType();
//Define the data type by setting the SqlDataType property.
dt.SqlDataType = SqlDataType.VarChar;
//The VarChar data type requires a value for the MaximumLength property.
dt.MaximumLength = 100;
}