Compartilhar via


SqlMetaData Classe

Definição

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