SqlMetaData Classe

  • Referência

Definição

Namespace:
Microsoft.SqlServer.Server
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacote:
System.Data.SqlClient v4.8.5

Especifica e recupera informações de metadados de parâmetros e colunas de objetos SqlDataRecord. Essa classe não pode ser herdada.

public ref class SqlMetaData sealed
public sealed class SqlMetaData
type SqlMetaData = class
Public NotInheritable Class SqlMetaData
Herança
Object
SqlMetaData

Exemplos

O exemplo a seguir mostra a criação de vários SqlMetaData objetos, que descrevem os metadados de coluna de um registro e a criação de um SqlDataRecord. Os valores de coluna do SqlDataRecord são definidos e o SqlDataRecord é enviado para o programa de chamada usando a SqlContext classe .

[Microsoft.SqlServer.Server.SqlProcedure]
public static void CreateNewRecord()
{
   // Variables.
   SqlMetaData column1Info;
   SqlMetaData column2Info;
   SqlMetaData column3Info;
   SqlDataRecord record;

   // Create the column metadata.
   column1Info = new SqlMetaData("Column1", SqlDbType.NVarChar, 12);
   column2Info = new SqlMetaData("Column2", SqlDbType.Int);
   column3Info = new SqlMetaData("Column3", SqlDbType.DateTime);

   // Create a new record with the column metadata.
   record = new SqlDataRecord(new SqlMetaData[] { column1Info,
                                                  column2Info,
                                                  column3Info });

   // Set the record fields.
   record.SetString(0, "Hello World!");
   record.SetInt32(1, 42);
   record.SetDateTime(2, DateTime.Now);

   // Send the record to the calling program.
   SqlContext.Pipe.Send(record);
}

<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub CreateNewRecord()

   ' Variables.
   Dim column1Info As SqlMetaData 
   Dim column2Info As SqlMetaData
   Dim column3Info As SqlMetaData
   Dim record As SqlDataRecord

   ' Create the column metadata.
   column1Info = new SqlMetaData("Column1", SqlDbType.NVarChar, 12)
   column2Info = new SqlMetaData("Column2", SqlDbType.Int)
   column3Info = new SqlMetaData("Column3", SqlDbType.DateTime)

   ' Create a new record with the column metadata.      
   record = new SqlDataRecord(new SqlMetaData() { column1Info, _
                                                  column2Info, _
                                                  column3Info })

   ' Set the record fields.
   record.SetString(0, "Hello World!")
   record.SetInt32(1, 42)
   record.SetDateTime(2, DateTime.Now)

   ' Send the record to the calling program.
   SqlContext.Pipe.Send(record)

End Sub

Construtores

SqlMetaData(String, SqlDbType)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna e o tipo especificados.
SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna e o servidor padrão. Este formulário do construtor dá suporte a parâmetros com valor de tabela, permitindo que você especifique se a coluna é única no parâmetro com valor de tabela, a ordem de classificação para a coluna e o ordinal da coluna de classificação.
SqlMetaData(String, SqlDbType, Byte, Byte)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, o tipo, a precisão e a escala especificados.
SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, o tipo, a precisão, a escala e padrão do servidor especificados. Este formulário do construtor dá suporte a parâmetros com valor de tabela, permitindo que você especifique se a coluna é única no parâmetro com valor de tabela, a ordem de classificação para a coluna e o ordinal da coluna de classificação.
SqlMetaData(String, SqlDbType, Int64)

Inicializa uma nova instância da classe SqlMetaData com o nome, tipo e tamanho máximo da coluna especificados.
SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, tipo, tamanho máximo e padrão do servidor especificados. Este formulário do construtor dá suporte a parâmetros com valor de tabela, permitindo que você especifique se a coluna é única no parâmetro com valor de tabela, a ordem de classificação para a coluna e o ordinal da coluna de classificação.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, o tipo, o tamanho máximo, a precisão, a escala, a identificação de localidade, as opções de comparação e o UDT (tipo definido pelo usuário) especificados.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, o tipo, o tamanho máximo, a precisão, a escala, a identificação de localidade, as opções de comparação e o UDT (tipo definido pelo usuário) especificados. Este formulário do construtor dá suporte a parâmetros com valor de tabela, permitindo que você especifique se a coluna é única no parâmetro com valor de tabela, a ordem de classificação para a coluna e o ordinal da coluna de classificação.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, o tipo, o tamanho máximo, a localidade e as opções de comparação especificados.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, tipo, tamanho máximo, localidade, opções de comparação e padrão do servidor especificados. Este formulário do construtor dá suporte a parâmetros com valor de tabela, permitindo que você especifique se a coluna é única no parâmetro com valor de tabela, a ordem de classificação para a coluna e o ordinal da coluna de classificação.
SqlMetaData(String, SqlDbType, String, String, String)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, o tipo, o nome do banco de dados, o esquema de propriedade e o nome do objeto especificados.
SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, o nome de banco de dados, o esquema de propriedade, o nome do objeto e o servidor padrão especificados. Este formulário do construtor dá suporte a parâmetros com valor de tabela, permitindo que você especifique se a coluna é única no parâmetro com valor de tabela, a ordem de classificação para a coluna e o ordinal da coluna de classificação.
SqlMetaData(String, SqlDbType, Type)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, o tipo e o UDT (tipo definido pelo usuário) especificados.
SqlMetaData(String, SqlDbType, Type, String)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, o UDT (tipo definido pelo usuário) e o tipo do SQLServer especificados.
SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32)

Inicializa uma nova instância da classe SqlMetaData com o nome da coluna, o tipo, o tipo definido pelo usuário, o tipo do SQL Server e o servidor padrão especificados. Este formulário do construtor dá suporte a parâmetros com valor de tabela, permitindo que você especifique se a coluna é única no parâmetro com valor de tabela, a ordem de classificação para a coluna e o ordinal da coluna de classificação.

Propriedades

CompareOptions

Obtém as regras de comparação usadas para a coluna ou para o parâmetro.
DbType

Obtém o tipo de dados da coluna ou do parâmetro.
IsUniqueKey

Indica se a coluna no parâmetro com valor de tabela é exclusiva.
LocaleId

Obtém a identificação de localidade da coluna ou do parâmetro.
Max

Obtém o tamanho dos tipos de dados text, ntext e image.
MaxLength

Obtém o tamanho máximo da coluna ou do parâmetro.
Name

Obtém o nome da coluna ou do parâmetro.
Precision

Obtém a precisão da coluna ou parâmetro.
Scale

Obtém a escala da coluna ou parâmetro.
SortOrder

Retorna a ordem de classificação de uma coluna.
SortOrdinal

Retorna o ordinal da coluna de classificação.
SqlDbType

Obtém o tipo de dados da coluna ou do parâmetro.
Type

Obtém o tipo CLR (Common Language Runtime) de um UDT (tipo definido pelo usuário).
TypeName

Obtém o nome de três partes do UDT (tipo definido pelo usuário) ou o tipo do SQL Server representado pela instância.
UseServerDefault

Relata se essa coluna deve usar o valor do servidor padrão.
XmlSchemaCollectionDatabase

Obtém o nome do banco de dados em que a coleção de esquemas dessa instância XML está localizada.
XmlSchemaCollectionName

Obtém o nome da coleção de esquemas desta instância XML.
XmlSchemaCollectionOwningSchema

Obtém o esquema relacional proprietário em que a coleção de esquemas dessa instância XML está localizada.

Métodos

Adjust(Boolean)

Valida o valor Boolean especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Byte)

Valida o valor Byte especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Byte[])

Valida a matriz especificada dos valores Byte em relação aos metadados e ajusta o valor, se necessário.
Adjust(Char)

Valida o valor Char especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Char[])

Valida a matriz especificada dos valores Char em relação aos metadados e ajusta o valor, se necessário.
Adjust(DateTime)

Valida o valor DateTime especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(DateTimeOffset)

Valida o valor DateTimeOffset especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Decimal)

Valida o valor Decimal especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Double)

Valida o valor Double especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Guid)

Valida o valor Guid especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Int16)

Valida o valor Int16 especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Int32)

Valida o valor Int32 especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Int64)

Valida o valor Int64 especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Object)

Valida o valor Object especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(Single)

Valida o valor Single especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlBinary)

Valida o valor SqlBinary especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlBoolean)

Valida o valor SqlBoolean especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlByte)

Valida o valor SqlByte especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlBytes)

Valida o valor SqlBytes especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlChars)

Valida o valor SqlChars especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlDateTime)

Valida o valor SqlDateTime especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlDecimal)

Valida o valor SqlDecimal especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlDouble)

Valida o valor SqlDouble especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlGuid)

Valida o valor SqlGuid especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlInt16)

Valida o valor SqlInt16 especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlInt32)

Valida o valor SqlInt32 especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlInt64)

Valida o valor SqlInt64 especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlMoney)

Valida o valor SqlMoney especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlSingle)

Valida o valor SqlSingle especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlString)

Valida o valor SqlString especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(SqlXml)

Valida o valor SqlXml especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(String)

Valida o valor String especificado em relação aos metadados e ajusta o valor, se necessário.
Adjust(TimeSpan)

Valida o valor TimeSpan especificado em relação aos metadados e ajusta o valor, se necessário.
InferFromValue(Object, String)

Infere os metadados do objeto especificado e os retorna como uma instância SqlMetaData.

Aplica-se a