SqlMetaData Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 sealedpublic sealed class SqlMetaDatatype SqlMetaData = classPublic 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 |
| 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. |