Partager via

SqlMetaData Classe

  • Référence

Définition

Espace de noms:
Microsoft.SqlServer.Server
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paquet:
System.Data.SqlClient v4.8.5

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 .

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

S’applique à