SqlMetaData Classe

Définition

Espace de noms:

Microsoft.Data.SqlClient.Server

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

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

Object

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 .

// using Microsoft.Data.SqlClient.Server;

[Microsoft.Data.SqlClient.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);
}

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 text, ntext et image.
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.