SqlMetaData Clase

Definición

Espacio de nombres:

Microsoft.Data.SqlClient.Server

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Especifica y recupera información de metadatos de los parámetros y columnas de los objetos SqlDataRecord. Esta clase no puede heredarse.

public ref class SqlMetaData sealed

public sealed class SqlMetaData

type SqlMetaData = class

Public NotInheritable Class SqlMetaData

Herencia

Object

SqlMetaData

Ejemplos

En el ejemplo siguiente se muestra la creación de varios SqlMetaData objetos, que describen los metadatos de columna de un registro y la creación de .SqlDataRecord Los valores de columna de SqlDataRecord se establecen y SqlDataRecord se envían al programa que realiza la llamada mediante la SqlContext clase .

// 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);
}

Constructores

SqlMetaData(String, SqlDbType)	Inicializa una nueva instancia de la clase SqlMetaData con el tipo y el nombre de columna especificados.
SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna especificado y el servidor predeterminado. Esta forma del constructor admite parámetros con valores de tabla que permiten especificar si la columna es única en el parámetro con valores de tabla, el criterio de ordenación de la columna y el ordinal de la columna de ordenación.
SqlMetaData(String, SqlDbType, Byte, Byte)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo, la precisión y la escala especificados.
SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo, la precisión y la escala especificados así como el servidor predeterminado. Esta forma del constructor admite parámetros con valores de tabla que permiten especificar si la columna es única en el parámetro con valores de tabla, el criterio de ordenación de la columna y el ordinal de la columna de ordenación.
SqlMetaData(String, SqlDbType, Int64)	Inicializa una nueva instancia de la clase SqlMetaData con el tipo, el nombre de columna y la longitud máxima especificados.
SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo, la longitud máxima especificados y el servidor predeterminado. Esta forma del constructor admite parámetros con valores de tabla que permiten especificar si la columna es única en el parámetro con valores de tabla, el criterio de ordenación de la columna y el ordinal de la columna de ordenación.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo, la longitud máxima, la precisión, la escala, el identificador de configuración regional, las opciones de comparación y el tipo definido por el usuario (UDT) especificados.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo, la longitud máxima, la precisión, la escala, el identificador de configuración regional, las opciones de comparación y el tipo definido por el usuario (UDT) especificados. Esta forma del constructor admite parámetros con valores de tabla que permiten especificar si la columna es única en el parámetro con valores de tabla, el criterio de ordenación de la columna y el ordinal de la columna de ordenación.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo, la longitud máxima, la configuración regional y las opciones de comparación especificados.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo, la longitud máxima, la configuración regional y las opciones de comparación especificados, así como el servidor predeterminado. Esta forma del constructor admite parámetros con valores de tabla que permiten especificar si la columna es única en el parámetro con valores de tabla, el criterio de ordenación de la columna y el ordinal de la columna de ordenación.
SqlMetaData(String, SqlDbType, String, String, String)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo, el nombre de base de datos, el esquema propietario y el nombre de objeto especificados.
SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el nombre de base de datos, el esquema propietario y el nombre de objeto especificados, así como el servidor predeterminado. Esta forma del constructor admite parámetros con valores de tabla que permiten especificar si la columna es única en el parámetro con valores de tabla, el criterio de ordenación de la columna y el ordinal de la columna de ordenación.
SqlMetaData(String, SqlDbType, Type)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo y el tipo definido por el usuario (UDT) especificados.
SqlMetaData(String, SqlDbType, Type, String)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo definido por el usuario (UDT) y el tipo de SQL Server especificados.
SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32)	Inicializa una nueva instancia de la clase SqlMetaData con el nombre de columna, el tipo, el tipo definido por el usuario y el tipo de SQL Server especificados así como el servidor predeterminado. Esta forma del constructor admite parámetros con valores de tabla que permiten especificar si la columna es única en el parámetro con valores de tabla, el criterio de ordenación de la columna y el ordinal de la columna de ordenación.

Propiedades

CompareOptions	Obtiene las reglas de comparación utilizadas para la columna o el parámetro.
DbType	Obtiene el tipo de datos de la columna o del parámetro.
IsUniqueKey	Indica si la columna del parámetro con valores de tabla es única.
LocaleId	Obtiene el identificador de configuración local de la columna o del parámetro.
Max	Obtiene la longitud de los tipos de datos text, ntext e image.
MaxLength	Obtiene la longitud máxima de la columna o del parámetro.
Name	Obtiene el nombre de la columna o del parámetro.
Precision	Obtiene la precisión de la columna o del parámetro.
Scale	Obtiene la escala de la columna o del parámetro.
SortOrder	Devuelve el criterio de ordenación de una columna.
SortOrdinal	Devuelve el ordinal de la columna de ordenación.
SqlDbType	Obtiene el tipo de datos de la columna o del parámetro.
Type	Obtiene el tipo de Common Language Runtime (CLR) de un tipo definido por el usuario (UDT).
TypeName	Obtiene el nombre compuesto por tres partes del tipo definido por el usuario (UDT) o del tipo de SQL Server representado por la instancia.
UseServerDefault	Notifica si esta columna debe usar el valor de servidor predeterminado.
XmlSchemaCollectionDatabase	Obtiene el nombre de la base de datos donde se encuentra la colección de esquemas para esta instancia XML.
XmlSchemaCollectionName	Obtiene el nombre de la colección de esquemas para esta instancia XML.
XmlSchemaCollectionOwningSchema	Obtiene el esquema relacional propietario donde está ubicada la colección de esquemas para esta instancia de XML.

Métodos

Adjust(Boolean)	Valida el valor Boolean especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Byte)	Valida el valor Byte especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Byte[])	Valida la matriz especificada de valores de Byte con los metadatos y ajusta el valor si es necesario.
Adjust(Char)	Valida el valor Char especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Char[])	Valida la matriz especificada de valores de Char con los metadatos y ajusta el valor si es necesario.
Adjust(DateTime)	Valida el valor DateTime especificado con los metadatos y ajusta el valor si es necesario.
Adjust(DateTimeOffset)	Valida el valor DateTimeOffset especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Decimal)	Valida el valor Decimal especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Double)	Valida el valor Double especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Guid)	Valida el valor Guid especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Int16)	Valida el valor Int16 especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Int32)	Valida el valor Int32 especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Int64)	Valida el valor Int64 especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Object)	Valida el valor Object especificado con los metadatos y ajusta el valor si es necesario.
Adjust(Single)	Valida el valor Single especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlBinary)	Valida el valor SqlBinary especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlBoolean)	Valida el valor SqlBoolean especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlByte)	Valida el valor SqlByte especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlBytes)	Valida el valor SqlBytes especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlChars)	Valida el valor SqlChars especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlDateTime)	Valida el valor SqlDateTime especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlDecimal)	Valida el valor SqlDecimal especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlDouble)	Valida el valor SqlDouble especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlGuid)	Valida el valor SqlGuid especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlInt16)	Valida el valor SqlInt16 especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlInt32)	Valida el valor SqlInt32 especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlInt64)	Valida el valor SqlInt64 especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlMoney)	Valida el valor SqlMoney especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlSingle)	Valida el valor SqlSingle especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlString)	Valida el valor SqlString especificado con los metadatos y ajusta el valor si es necesario.
Adjust(SqlXml)	Valida el valor SqlXml especificado con los metadatos y ajusta el valor si es necesario.
Adjust(String)	Valida el valor String especificado con los metadatos y ajusta el valor si es necesario.
Adjust(TimeSpan)	Valida el valor TimeSpan especificado con los metadatos y ajusta el valor si es necesario.
InferFromValue(Object, String)	Deduce los metadatos del objeto especificado y los devuelve como una instancia de SqlMetaData.