Compartir a través de

Trabajar con tipos de datos

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Los datos se presentan en diversos tipos y tamaños como, por ejemplo, una cadena con una longitud definida, un número con una precisión específica o un tipo de datos definido por el usuario que es otro objeto que tiene su propio conjunto de reglas. El DataType objeto clasifica el tipo de datos para que Microsoft SQL Server pueda controlarlos correctamente. El objeto DataType está asociada a objetos que aceptan datos. Los siguientes objetos SQL Server Management Objects (SMO) aceptan datos que deben definirse mediante una DataType propiedad de objeto:

La propiedad DataType de los objetos que aceptan los datos puede establecerse de varias formas.

  • Use el constructor predeterminado y especifique las propiedades de objeto DataType de forma explícita.

  • Use un constructor sobrecargado y especifique las propiedades DataType como parámetros.

  • Especifique el objeto DataType insertado en el constructor de objeto.

  • Use uno de los miembros estáticos de la DataType clase, por ejemplo Int. De hecho, devolverá una instancia de un DataType objeto .

El objeto DataType tiene varias propiedades que definen el tipo de datos. Por ejemplo, la SqlDataType propiedad especifica el tipo de datos SQL Server. Los valores constantes que representan SQL Server tipos de datos se enumeran en la SqlDataType enumeración . Se trata de tipos de datos como varchar, nchar, currency, integer, floaty datetime.

Al establecer el tipo de datos, deben establecerse propiedades concretas para los datos. Por ejemplo, si es un tipo nchar , la longitud de los datos de cadena debe establecerse en la propiedad Length . Esto mismo se aplica a los valores numéricos, en los que debe especificarse una precisión y una escala.

Los tipos de datos UserDefinedDataType y UserDefinedType hacen referencia a objetos que contienen la definición del tipo de datos definido por el usuario. UserDefinedDataType se basa en SQL Server tipos de datos de la SqlDataType enumeración . UserDefinedType se basa en los tipos de datos de Microsoft .NET. Normalmente, representarían datos de un tipo específico que la base de datos reutiliza con frecuencia debido a las reglas de negocios definidas por la organización. Por ejemplo, un tipo de datos que almacena una cantidad de dinero y un denominador de divisa resultarían de gran utilidad en una compañía que trabaje con distintas divisas.

La SqlDataType enumeración contiene una lista de todos los tipos de datos admitidos SQL Server.

Ejemplos

Para utilizar cualquier ejemplo de código que se proporcione, deberá elegir el entorno de programación, la plantilla de programación y el lenguaje de programación con los que crear su aplicación. Para obtener más información, vea Crear un proyecto SMO de Visual C# en Visual Studio .NET.

Construir un objeto DataType con la especificación del constructor de Visual Basic

En este ejemplo de código se muestra cómo usar el constructor para crear instancias de tipos de datos basados en diferentes tipos de datos SQL Server.

Nota

Los tipos UserDefinedType, UserDefinedDataType y XML exigen, todos ellos, un valor de nombre que identifique el objeto.

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

Construir un objeto DataType con la especificación del constructor de Visual Basic C#

En este ejemplo de código se muestra cómo usar el constructor para crear instancias de tipos de datos basados en diferentes tipos de datos SQL Server.

Nota

Los tipos UserDefinedType, UserDefinedDataType y XML exigen, todos ellos, un valor de nombre que identifique el objeto.

{   
//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);   
}

Construir un objeto DataType utilizando el constructor predeterminado de Visual Basic

En este ejemplo de código se muestra cómo usar el constructor predeterminado para crear instancias de tipos de datos basados en diferentes tipos de datos SQL Server. Después, las propiedades se utilizan para especificar el tipo de datos.

Nota Todos UserDefinedTypelos tipos XML , UserDefinedDataTypey requieren un valor de nombre para identificar el objeto.

'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

Construir un objeto DataType utilizando el constructor predeterminado de Visual C#

En este ejemplo de código se muestra cómo usar el constructor predeterminado para crear instancias de tipos de datos basados en diferentes tipos de datos SQL Server. Después, las propiedades se utilizan para especificar el tipo de datos.

Nota Todos UserDefinedTypelos tipos XML , UserDefinedDataTypey requieren un valor de nombre para identificar el objeto.

{   
//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;   
}