Partager via


Utilisation des types de données

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

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 ensemble de règles. L’objet DataType classifie le type de données afin qu’elles puissent être gérées correctement par Microsoft SQL Server. L'objet DataType est associé aux objets qui acceptent des données. Les SQL Server objets SMO (Management Objects) suivants acceptent les 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 DataType classe, par exemple Int. Cela retourne en fait une instance d’un DataType objet .

L'objet DataType a plusieurs propriétés qui définissent le type de données. Par exemple, la SqlDataType propriété spécifie le type de données SQL Server. Les valeurs constantes qui représentent SQL Server types de données sont répertoriées dans l’énumérationSqlDataType. Cela fait référence à des types de données tels que varchar, nchar, currency, integer, floatet 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 UserDefinedDataType est basé sur SQL Server types de données de l’énumérationSqlDataType. est basé sur les UserDefinedType 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 qui est fourni, vous devrez choisir l'environnement de programmation, le modèle de programmation et le langage de programmation dans lequel créer votre application. Pour plus d’informations, consultez Créer un projet SMO Visual C# dans Visual Studio .NET.

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és 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 arguments 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és 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 arguments 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és 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.

Note Les UserDefinedTypetypes , UserDefinedDataTypeet XML nécessitent tous une valeur de nom pour 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és 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.

Note Les UserDefinedTypetypes , UserDefinedDataTypeet XML nécessitent tous une valeur de nom pour 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;   
}