SqlMetaData Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie et récupère des informations de métadonnées à partir de paramètres et colonnes d'objets SqlDataRecord. Cette classe ne peut pas être héritée.
public ref class SqlMetaData sealed
public sealed class SqlMetaData
type SqlMetaData = class
Public NotInheritable Class SqlMetaData
- Héritage
-
SqlMetaData
Exemples
L’exemple suivant montre la création de plusieurs SqlMetaData objets, qui décrivent les métadonnées de colonne d’un enregistrement, et la création d’un SqlDataRecord. Les valeurs de colonne de sont SqlDataRecord définies et le SqlDataRecord est envoyé au programme appelant à l’aide de la 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
Constructeurs
SqlMetaData(String, SqlDbType) |
Initialise une nouvelle instance de la classe SqlMetaData à l'aide du nom et du type de colonne spécifiés. |
SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32) |
Initialise une nouvelle instance de la classe SqlMetaData à l'aide du nom de colonne et du serveur par défaut spécifiés. Cette forme du constructeur prend en charge les paramètres table en vous permettant de spécifier si la colonne est unique dans le paramètre table, ainsi que l'ordre de tri pour la colonne et l'ordinal de la colonne de tri. |
SqlMetaData(String, SqlDbType, Byte, Byte) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom, le type de colonne, la précision et l'échelle spécifiés. |
SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom et le type de colonne, la précision, l'échelle et le serveur par défaut spécifiés. Cette forme du constructeur prend en charge les paramètres table en vous permettant de spécifier si la colonne est unique dans le paramètre table, ainsi que l'ordre de tri pour la colonne et l'ordinal de la colonne de tri. |
SqlMetaData(String, SqlDbType, Int64) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom et le type de colonne, ainsi que la longueur maximale spécifiés. |
SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom et le type de colonne, la longueur maximale et le serveur par défaut spécifiés. Cette forme du constructeur prend en charge les paramètres table en vous permettant de spécifier si la colonne est unique dans le paramètre table, ainsi que l'ordre de tri pour la colonne et l'ordinal de la colonne de tri. |
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom et le type de colonne, la longueur maximale, la précision, l'échelle, l'ID de paramètres régionaux, les options de comparaison et le type défini par l'utilisateur spécifiés. |
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom et le type de colonne, la longueur maximale, la précision, l'échelle, l'ID de paramètres régionaux, les options de comparaison et le type défini par l'utilisateur spécifiés. Cette forme du constructeur prend en charge les paramètres table en vous permettant de spécifier si la colonne est unique dans le paramètre table, ainsi que l'ordre de tri pour la colonne et l'ordinal de la colonne de tri. |
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom et le type de colonne, ainsi que la longueur maximale, les paramètres régionaux et les options de comparaison spécifiés. |
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom et le type de colonne, ainsi que la longueur maximale, les paramètres régionaux, les options de comparaison et le serveur par défaut spécifiés. Cette forme du constructeur prend en charge les paramètres table en vous permettant de spécifier si la colonne est unique dans le paramètre table, ainsi que l'ordre de tri pour la colonne et l'ordinal de la colonne de tri. |
SqlMetaData(String, SqlDbType, String, String, String) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom et le type de colonne, le nom de la base de données, le schéma propriétaire et le nom d'objet spécifiés. |
SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom de colonne, le nom de la base de données, le schéma propriétaire, le nom d'objet et le serveur par défaut spécifiés. Cette forme du constructeur prend en charge les paramètres table en vous permettant de spécifier si la colonne est unique dans le paramètre table, ainsi que l'ordre de tri pour la colonne et l'ordinal de la colonne de tri. |
SqlMetaData(String, SqlDbType, Type) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom de colonne, le type et le type défini par l'utilisateur spécifiés. |
SqlMetaData(String, SqlDbType, Type, String) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom de colonne, le type défini par l'utilisateur et le type SQL Server spécifiés. |
SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32) |
Initialise une nouvelle instance de la classe SqlMetaData avec le nom et le type de colonne, le type défini par l'utilisateur, le type SQL Server et le serveur par défaut spécifiés. Cette forme du constructeur prend en charge les paramètres table en vous permettant de spécifier si la colonne est unique dans le paramètre table, ainsi que l'ordre de tri pour la colonne et l'ordinal de la colonne de tri. |
Propriétés
CompareOptions |
Obtient les règles de comparaison utilisées pour la colonne ou le paramètre. |
DbType |
Obtient le type de données de la colonne ou du paramètre. |
IsUniqueKey |
Indique si la colonne dans le paramètre table est unique. |
LocaleId |
Obtient l'ID de paramètres régionaux de la colonne ou du paramètre. |
Max |
Obtient la longueur des données de type |
MaxLength |
Obtient la longueur maximale de la colonne ou du paramètre. |
Name |
Obtient le nom de la colonne ou du paramètre. |
Precision |
Obtient la précision de la colonne ou du paramètre. |
Scale |
Obtient l'échelle de la colonne ou du paramètre. |
SortOrder |
Retourne l'ordre de tri pour une colonne. |
SortOrdinal |
Retourne l'ordinal de la colonne de tri. |
SqlDbType |
Obtient le type de données de la colonne ou du paramètre. |
Type |
Obtient le type CLR d'un type défini par l'utilisateur. |
TypeName |
Obtient le nom en trois parties du type défini par l'utilisateur ou du type SQL Server représenté par l'instance. |
UseServerDefault |
Indique si la colonne doit utiliser la valeur de serveur par défaut. |
XmlSchemaCollectionDatabase |
Obtient le nom de la base de données où se trouve la collection de schémas pour cette instance XML. |
XmlSchemaCollectionName |
Obtient le nom de la collection de schémas pour cette instance XML. |
XmlSchemaCollectionOwningSchema |
Obtient le schéma relationnel propriétaire où se trouve la collection de schémas pour cette instance XML. |
Méthodes
Adjust(Boolean) |
Valide la valeur Boolean spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Byte) |
Valide la valeur Byte spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Byte[]) |
Valide le tableau spécifié de valeurs Byte par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Char) |
Valide la valeur Char spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Char[]) |
Valide le tableau spécifié de valeurs Char par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(DateTime) |
Valide la valeur DateTime spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(DateTimeOffset) |
Valide la valeur DateTimeOffset spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Decimal) |
Valide la valeur Decimal spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Double) |
Valide la valeur Double spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Guid) |
Valide la valeur Guid spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Int16) |
Valide la valeur Int16 spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Int32) |
Valide la valeur Int32 spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Int64) |
Valide la valeur Int64 spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Object) |
Valide la valeur Object spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(Single) |
Valide la valeur Single spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlBinary) |
Valide la valeur SqlBinary spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlBoolean) |
Valide la valeur SqlBoolean spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlByte) |
Valide la valeur SqlByte spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlBytes) |
Valide la valeur SqlBytes spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlChars) |
Valide la valeur SqlChars spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlDateTime) |
Valide la valeur SqlDateTime spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlDecimal) |
Valide la valeur SqlDecimal spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlDouble) |
Valide la valeur SqlDouble spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlGuid) |
Valide la valeur SqlGuid spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlInt16) |
Valide la valeur SqlInt16 spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlInt32) |
Valide la valeur SqlInt32 spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlInt64) |
Valide la valeur SqlInt64 spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlMoney) |
Valide la valeur SqlMoney spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlSingle) |
Valide la valeur SqlSingle spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlString) |
Valide la valeur SqlString spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(SqlXml) |
Valide la valeur SqlXml spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(String) |
Valide la valeur String spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
Adjust(TimeSpan) |
Valide la valeur TimeSpan spécifiée par rapport aux métadonnées et ajuste la valeur si nécessaire. |
InferFromValue(Object, String) |
Déduit les métadonnées de l'objet spécifié et les retourne sous la forme d'une instance de SqlMetaData. |