Trabalhando com tipos de dados

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse Analytics

Existem muitos tipos e tamanhos de dados, como uma cadeia de caracteres com comprimento definido, um número com uma precisão específica ou um tipo de dados definido pelo usuário que é um outro objeto com seu próprio conjunto de regras. O DataType objeto classifica o tipo de dados para que ele possa ser tratado corretamente pelo Microsoft SQL Server. O objeto DataType é associado a objetos que aceitam dados. Os seguintes objetos SMO (SQL Server Management Objects) aceitam dados que devem ser definidos por uma DataType propriedade de objeto:

• Column

• UserDefinedDataType

• UserDefinedType

• UserDefinedFunctionParameter

• StoredProcedureParameter

• UserDefinedFunctionParameter

• UserDefinedAggregateParameter

A propriedade DataType para objetos que aceitam dados pode ser definida de várias maneiras.

• Use o construtor padrão e especifique propriedades de objeto DataType explicitamente.

• Use um construtor sobrecarregado e especifique as propriedades DataType como parâmetros.

• Especifique o DataType embutido no construtor de objeto.

• Use um dos membros estáticos da DataType classe , por exemplo , Int. Na verdade, isso retornará uma instância de um DataType objeto .

O objeto DataType tem várias propriedades que definem o tipo de dados. Por exemplo, a SqlDataType propriedade especifica o tipo de dados SQL Server. Os valores constantes que representam SQL Server tipos de dados são listados na SqlDataType enumeração . Isso se refere a tipos de dados como varchar, nchar, currency, integer, floate datetime.

Quando o tipo de dados for estabelecido, propriedades específicas deverão ser definidas para os dados. Por exemplo, se ele for um tipo nchar , o comprimento dos dados de cadeia de caracteres deverá ser definido na propriedade Length . O mesmo se aplica a valores numéricos, nos quais você teria que especificar a precisão e a escala.

Os tipos de dadosUserDefinedDataType e UserDefinedType se referem a objetos que contêm a definição do tipo de dados definido pelo usuário. O UserDefinedDataType é baseado em SQL Server tipos de dados da SqlDataType enumeração . O UserDefinedType é baseado em tipos de dados do Microsoft .NET. Normalmente, esses representariam dados de um tipo específico que é reutilizado com frequência pelo banco de dados por causa de regras comerciais definidas pela organização. Por exemplo, um tipo de dados que armazena uma quantia de dinheiro e um denominador monetário seria útil em uma empresa que trabalha com várias moedas.

A SqlDataType enumeração contém uma lista de todos os tipos de dados compatíveis com SQL Server.

Exemplos

Para usar qualquer exemplo de código fornecido, será necessário escolher o ambiente de programação, o modelo de programação e a linguagem de programação para criar o aplicativo. Para obter mais informações, consulte Criar um projeto SMO do Visual C# no Visual Studio .NET.

Construindo um objeto DataType com a especificação do construtor no Visual Basic

Este exemplo de código mostra como usar o construtor para criar instâncias de tipos de dados com base em diferentes tipos de dados SQL Server.

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

Construindo um objeto DataType com a especificação do construtor no Visual C#

Este exemplo de código mostra como usar o construtor para criar instâncias de tipos de dados com base em diferentes tipos de dados SQL Server.

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

Construindo um objeto DataType com o construtor padrão no Visual Basic

Este exemplo de código mostra como usar o construtor padrão para criar instâncias de tipos de dados com base em diferentes tipos de dados SQL Server. As propriedades são, então, usadas para especificar o tipo de dados.

Nota Todos os UserDefinedTypetipos , UserDefinedDataTypee XML exigem um valor de nome para identificar o 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

Construindo um objeto DataType com o construtor padrão no Visual C#

Este exemplo de código mostra como usar o construtor padrão para criar instâncias de tipos de dados com base em diferentes tipos de dados SQL Server. As propriedades são, então, usadas para especificar o tipo de dados.

Nota Todos os UserDefinedTypetipos , UserDefinedDataTypee XML exigem um valor de nome para identificar o 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;   
}