Compartilhar via


Trabalhando com tipos de dados

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 objeto DataType classifica o tipo de dados de forma que ele possa ser tratado corretamente pelo MicrosoftSQL Server. O objeto DataType é associado a objetos que aceitam dados. Os objetos SQL Server Management Objects (SMO) a seguir aceitam dados que devem ser definidos por uma propriedade de objeto DataType:

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 classe DataType, por exemplo Int. Isso retornará, na realidade, uma instância de um objeto DataType.

O objeto DataType tem várias propriedades que definem o tipo de dados. Por exemplo, a propriedade SqlDataType especifica o tipo de dados do SQL Server. Os valores constantes que representam tipos de dados do SQL Server são listados na enumeração SqlDataType. Isso se refere a tipos de dados como varchar, nchar, currency, integer, float e 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 se baseia em tipos de dados do SQL Server da enumeração SqlDataType. O UserDefinedType se baseia 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 enumeração SqlDataType contém uma lista de todos os tipos de dados com suporte no 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 "Como: criar um projeto SMO do Visual Basic no Visual Studio .NET" ou "Como: criar um projeto Visual C# SMO no Visual Studio .NET" nos Manuais Online do SQL Server.

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 baseadas em diferentes tipos de dados do SQL Server.

ObservaçãoObservação

Todos os tipos UserDefinedType, UserDefinedDataType e XML exigem um valor de nome para identificação do 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 arguements 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 baseadas em diferentes tipos de dados do SQL Server.

ObservaçãoObservação

Todos os tipos UserDefinedType, UserDefinedDataType e XML exigem um valor de nome para identificação do objeto.

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

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 baseadas em diferentes tipos de dados do SQL Server. As propriedades são, então, usadas para especificar o tipo de dados.

Observação Todos os tipos UserDefinedType, UserDefinedDataType e XML exigem um valor de nome para identificação do 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 baseadas em diferentes tipos de dados do SQL Server. As propriedades são, então, usadas para especificar o tipo de dados.

Observação Todos os tipos UserDefinedType, UserDefinedDataType e XML exigem um valor de nome para identificação do 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; 
}