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.
.gif "Observação") Observaçã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çã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;
}