SqlMetaData Clase

  • Referencia

Definición

Espacio de nombres:
Microsoft.SqlServer.Server
Ensamblado:
System.Data.SqlClient.dll
Ensamblado:
System.Data.dll
Paquete:
System.Data.SqlClient v4.8.5

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 un SqlDataRecordobjeto . Los valores de columna de SqlDataRecord se establecen y SqlDataRecord se envía al programa que realiza la llamada mediante la SqlContext clase .

[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

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.

Se aplica a