SqlMetaData Constructores

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

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la clase SqlMetaData.

Sobrecargas

SqlMetaData(String, SqlDbType)	Inicializa una nueva instancia de la clase SqlMetaData con el tipo y el nombre de columna 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, 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, 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, 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.
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, 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, 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, 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, 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, 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, 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, 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, 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)

Inicializa una nueva instancia de la clase SqlMetaData con el tipo y el nombre de columna especificados.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType);

public SqlMetaData (string name, System.Data.SqlDbType dbType);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

Excepciones

ArgumentNullException

El valor de Name es null.

ArgumentException

Se ha pasado un SqlDbType no permitido al constructor como dbType.

Ejemplos

En el ejemplo siguiente se crea un nuevo SqlMetaData objeto especificando el nombre de columna y un tipo de datos de columna de SqlDbType.Int

public static void CreateSqlMetaData2()
{
   SqlMetaData columnInfo;
   columnInfo = new SqlMetaData("Column2", SqlDbType.Int);
}

Public Shared Sub CreateSqlMetaData2()

   Dim columnInfo As SqlMetaData
   columnInfo = new SqlMetaData("ColumnName", SqlDbType.Int)

End Sub

Comentarios

Solo se permite pasar lo siguiente al constructor como : , , , , TimeStampSmallMoneyFloatDecimalSmallDateTimeSmallIntNumericIntMoney, , , TinyInt, , . XmlUniqueIdentifierDateTimeBigIntBitdbType

A continuación se muestran los valores predeterminados asignados a dbType, en función de SqlDbType (las XmlSchemaCollectionDatabasepropiedades , XmlSchemaCollectionName, XmlSchemaCollectionOwningSchemay Type se establecen en null):

SqlDbType	Longitud máxima	Precisión	Escala	Comparación de opciones
`Bit`	1	1	0	None
`BigInt`	8	19	0	None
`DateTime`	8	23	3	None
`Decimal`	9	18	0	None
`Float`	8	53	0	None
`Int`	4	10	0	None
`Money`	8	19	4	None
`Numeric`	9	18	0	None
`SmallDateTime`	4	16	0	None
`SmallInt`	2	5	0	None
`SmallMoney`	4	10	4	None
`TimeStamp`	8	0	0	None
`TinyInt`	1	3	0	None
`UniqueIdentifier`	16	0	0	None
`Xml`	Máximo (-1)	0	0	IgnoreCase, IgnoreKanaType, IgnoreWidth

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength, System::Byte precision, System::Byte scale, long localeId, System::Data::SqlTypes::SqlCompareOptions compareOptions, Type ^ userDefinedType, bool useServerDefault, bool isUniqueKey, System::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength, byte precision, byte scale, long localeId, System.Data.SqlTypes.SqlCompareOptions compareOptions, Type userDefinedType, bool useServerDefault, bool isUniqueKey, System.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * int64 * byte * byte * int64 * System.Data.SqlTypes.SqlCompareOptions * Type * bool * bool * System.Data.SqlClient.SortOrder * int -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long, precision As Byte, scale As Byte, localeId As Long, compareOptions As SqlCompareOptions, userDefinedType As Type, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

maxLength: Int64

Longitud máxima del tipo especificado.

precision: Byte

Precisión del parámetro o de la columna.

scale: Byte

Escala del parámetro o de la columna.

localeId: Int64

Identificador de configuración local del parámetro o de la columna.

compareOptions: SqlCompareOptions

Reglas de comparación del parámetro o de la columna.

userDefinedType: Type

Instancia de Type que apunta al UDT.

useServerDefault: Boolean

Especifica si esta columna debe usar el valor de servidor predeterminado.

isUniqueKey: Boolean

Especifica si la columna del parámetro con valores de tabla es única.

columnSortOrder: SortOrder

Especifica el criterio de ordenación de una columna.

sortOrdinal: Int32

Especifica el ordinal de la columna de ordenación.

Comentarios

Para obtener más información, vea Parámetros con valores de tabla.

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, System::String ^ database, System::String ^ owningSchema, System::String ^ objectName, bool useServerDefault, bool isUniqueKey, System::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, string database, string owningSchema, string objectName, bool useServerDefault, bool isUniqueKey, System.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * string * string * string * bool * bool * System.Data.SqlClient.SortOrder * int -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, database As String, owningSchema As String, objectName As String, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

database: String

Nombre de base de datos de la colección de esquemas XML de una instancia de XML con tipo.

owningSchema: String

Nombre de esquema relacional de la colección de esquemas XML de una instancia de XML con tipo.

objectName: String

Nombre de la colección de esquemas XML de una instancia de XML con tipo.

useServerDefault: Boolean

Especifica si esta columna debe usar el valor de servidor predeterminado.

isUniqueKey: Boolean

Especifica si la columna del parámetro con valores de tabla es única.

columnSortOrder: SortOrder

Especifica el criterio de ordenación de una columna.

sortOrdinal: Int32

Especifica el ordinal de la columna de ordenación.

Comentarios

Para obtener más información, vea Parámetros con valores de tabla.

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength, long locale, System::Data::SqlTypes::SqlCompareOptions compareOptions, bool useServerDefault, bool isUniqueKey, System::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength, long locale, System.Data.SqlTypes.SqlCompareOptions compareOptions, bool useServerDefault, bool isUniqueKey, System.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * int64 * int64 * System.Data.SqlTypes.SqlCompareOptions * bool * bool * System.Data.SqlClient.SortOrder * int -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long, locale As Long, compareOptions As SqlCompareOptions, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

maxLength: Int64

Longitud máxima del tipo especificado.

locale: Int64

Identificador de configuración local del parámetro o de la columna.

compareOptions: SqlCompareOptions

Reglas de comparación del parámetro o de la columna.

useServerDefault: Boolean

Especifica si esta columna debe usar el valor de servidor predeterminado.

isUniqueKey: Boolean

Especifica si la columna del parámetro con valores de tabla es única.

columnSortOrder: SortOrder

Especifica el criterio de ordenación de una columna.

sortOrdinal: Int32

Especifica el ordinal de la columna de ordenación.

Comentarios

Para obtener más información, vea Parámetros con valores de tabla.

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, Type ^ userDefinedType, System::String ^ serverTypeName, bool useServerDefault, bool isUniqueKey, System::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, Type userDefinedType, string serverTypeName, bool useServerDefault, bool isUniqueKey, System.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * Type * string * bool * bool * System.Data.SqlClient.SortOrder * int -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, userDefinedType As Type, serverTypeName As String, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

userDefinedType: Type

Instancia de Type que apunta al UDT.

serverTypeName: String

Nombre del tipo de SQL Server para userDefinedType.

useServerDefault: Boolean

Especifica si esta columna debe usar el valor de servidor predeterminado.

isUniqueKey: Boolean

Especifica si la columna del parámetro con valores de tabla es única.

columnSortOrder: SortOrder

Especifica el criterio de ordenación de una columna.

sortOrdinal: Int32

Especifica el ordinal de la columna de ordenación.

Comentarios

Para obtener más información, vea Parámetros con valores de tabla.

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, System::Byte precision, System::Byte scale, bool useServerDefault, bool isUniqueKey, System::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, byte precision, byte scale, bool useServerDefault, bool isUniqueKey, System.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * byte * byte * bool * bool * System.Data.SqlClient.SortOrder * int -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, precision As Byte, scale As Byte, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

precision: Byte

Precisión del parámetro o de la columna.

scale: Byte

Escala del parámetro o de la columna.

useServerDefault: Boolean

Especifica si esta columna debe usar el valor de servidor predeterminado.

isUniqueKey: Boolean

Especifica si la columna del parámetro con valores de tabla es única.

columnSortOrder: SortOrder

Especifica el criterio de ordenación de una columna.

sortOrdinal: Int32

Especifica el ordinal de la columna de ordenación.

Comentarios

Para obtener más información, vea Parámetros con valores de tabla.

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength, bool useServerDefault, bool isUniqueKey, System::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength, bool useServerDefault, bool isUniqueKey, System.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * int64 * bool * bool * System.Data.SqlClient.SortOrder * int -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

maxLength: Int64

Longitud máxima del tipo especificado.

useServerDefault: Boolean

Especifica si esta columna debe usar el valor de servidor predeterminado.

isUniqueKey: Boolean

Especifica si la columna del parámetro con valores de tabla es única.

columnSortOrder: SortOrder

Especifica el criterio de ordenación de una columna.

sortOrdinal: Int32

Especifica el ordinal de la columna de ordenación.

Comentarios

Para obtener más información, vea Parámetros con valores de tabla.

Se aplica a

SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength, System::Byte precision, System::Byte scale, long locale, System::Data::SqlTypes::SqlCompareOptions compareOptions, Type ^ userDefinedType);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength, byte precision, byte scale, long locale, System.Data.SqlTypes.SqlCompareOptions compareOptions, Type userDefinedType);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * int64 * byte * byte * int64 * System.Data.SqlTypes.SqlCompareOptions * Type -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long, precision As Byte, scale As Byte, locale As Long, compareOptions As SqlCompareOptions, userDefinedType As Type)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

maxLength: Int64

Longitud máxima del tipo especificado.

precision: Byte

Precisión del parámetro o de la columna.

scale: Byte

Escala del parámetro o de la columna.

locale: Int64

Identificador de configuración local del parámetro o de la columna.

compareOptions: SqlCompareOptions

Reglas de comparación del parámetro o de la columna.

userDefinedType: Type

Instancia de Type que apunta al UDT.

Excepciones

ArgumentNullException

El valor de Name es null.

ArgumentException

Se ha pasado un SqlDbType no permitido al constructor como dbType, o bien userDefinedType apunta a un tipo que no tiene el atributo SqlUserDefinedTypeAttribute declarado.

Comentarios

Solo se permite pasar lo siguiente al constructor como dbType: BigInt, , BitBitIntDateTime, TextVariantSmallMoneyXmlUniqueIdentifierTinyIntTimeStampSmallIntSmallDateTimeRealNumericMoneyImageNtextDecimalFloatInt.

A continuación se muestran los valores predeterminados asignados a dbType, en SqlDbType función de (las XmlSchemaCollectionDatabasepropiedades , XmlSchemaCollectionName, XmlSchemaCollectionOwningSchemay Type se establecen en null):

SqlDbType	Longitud máxima	Precisión	Escala	Configuración regional	Comparar opciones
`BigInt`	8	19	0	0	None
`Bit`	1	1	0	0	None
`DateTime`	8	23	3	0	None
`Decimal`	9	18	0	0	None
`Float`	8	53	0	0	None
`Image`	Máximo (-1)	0	0	0	None
`Int`	4	10	0	0	None
`Money`	8	19	4	0	None
`Ntext`	Máximo (-1)	0	0	<thread>	IgnoreCase, IgnoreKanaType, IgnoreWidth
`Real`	4	24	0	0	None
`Row`	<número de columnas>	0	0	0	None
`SmallDateTime`	4	16	0	0	None
`SmallInt`	2	5	0	0	None
`SmallMoney`	4	10	4	0	None
`Text`	Máximo (-1)	0	0	<thread>	IgnoreCase, IgnoreKanaType, IgnoreWidth
`TimeStamp`	8	0	0	0	None
`TinyInt`	1	3	0	0	None
`UniqueIdentifier`	16	0	0	0	None
`UDT`	<Longitud máxima del tipo> o -1	0	0	0	None
`Variant`	8016	0	0	0	None
`Xml`	Máximo (-1)	0	0	0	IgnoreCase, IgnoreKanaType, IgnoreWidth

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, System::String ^ database, System::String ^ owningSchema, System::String ^ objectName);

public SqlMetaData (string name, System.Data.SqlDbType dbType, string database, string owningSchema, string objectName);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * string * string * string -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, database As String, owningSchema As String, objectName As String)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

database: String

Nombre de base de datos de la colección de esquemas XML de una instancia de XML con tipo.

owningSchema: String

Nombre de esquema relacional de la colección de esquemas XML de una instancia de XML con tipo.

objectName: String

Nombre de la colección de esquemas XML de una instancia de XML con tipo.

Excepciones

ArgumentNullException

El valor de Name es null o el valor de objectName es null cuando los valores de database y de owningSchema no son null.

ArgumentException

Se ha pasado un SqlDbType no permitido al constructor como dbType.

Comentarios

Solo se permite pasar lo siguiente SqlDbType al constructor como dbType: Xml.

A continuación se muestran los valores predeterminados asignados a dbType, en función de SqlDbType:

SqlDbType	Longitud máxima	Precisión	Escala	Configuración regional	Comparar opciones
`Xml`	Máximo (-1)	0	0	0	IgnoreCase, IgnoreKanaType, IgnoreWidth

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength, long locale, System::Data::SqlTypes::SqlCompareOptions compareOptions);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength, long locale, System.Data.SqlTypes.SqlCompareOptions compareOptions);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * int64 * int64 * System.Data.SqlTypes.SqlCompareOptions -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long, locale As Long, compareOptions As SqlCompareOptions)

Parámetros

name: String

Nombre del parámetro o de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

maxLength: Int64

Longitud máxima del tipo especificado.

locale: Int64

Identificador de configuración local del parámetro o de la columna.

compareOptions: SqlCompareOptions

Reglas de comparación del parámetro o de la columna.

Excepciones

ArgumentNullException

El valor de Name es null.

ArgumentException

Se ha pasado un SqlDbType no permitido al constructor como dbType.

Comentarios

Solo se permite pasar lo siguiente al constructor como dbType: Char, NChar, Ntext, NVarChar, Text, . VarChar

Solo se permite una maxLength especificación de Max, o -1, para un dbType de Text o NText.

dbType Para un de o NvarcharVarchar , una especificación de longitud de Max, o -1, declara los metadatos como varchar(max) y nvarchar(max), respectivamente.

SqlDbType	Precisión	Escala
`Char`	0	0
`NChar`	0	0
`NText`	0	0
`NVarChar`	0	0
`Text`	0	0
`VarChar`	0	0

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, Type ^ userDefinedType, System::String ^ serverTypeName);

public SqlMetaData (string name, System.Data.SqlDbType dbType, Type userDefinedType, string serverTypeName);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * Type * string -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, userDefinedType As Type, serverTypeName As String)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

userDefinedType: Type

Instancia de Type que apunta al UDT.

serverTypeName: String

Nombre del tipo de SQL Server para userDefinedType.

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, System::Byte precision, System::Byte scale);

public SqlMetaData (string name, System.Data.SqlDbType dbType, byte precision, byte scale);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * byte * byte -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, precision As Byte, scale As Byte)

Parámetros

name: String

Nombre del parámetro o de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

precision: Byte

Precisión del parámetro o de la columna.

scale: Byte

Escala del parámetro o de la columna.

Excepciones

ArgumentNullException

El valor de Name es null.

ArgumentException

Se ha pasado un SqlDbType no permitido al constructor como dbType o el valor de scale es mayor que el valor de precision.

Comentarios

Solo se permite pasar lo siguiente SqlDbType al constructor como dbType: Decimal.

SqlDbType	Longitud máxima	Precisión	Escala	Configuración regional	Comparación de opciones
Decimal	9	18	0	0	None

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, Type ^ userDefinedType);

public SqlMetaData (string name, System.Data.SqlDbType dbType, Type userDefinedType);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * Type -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, userDefinedType As Type)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

userDefinedType: Type

Instancia de Type que apunta al UDT.

Excepciones

ArgumentNullException

El valor de Name es null.

ArgumentException

Se ha pasado un SqlDbType no permitido al constructor como dbType, o bien, userDefinedType apunta a un tipo que no tenga el atributo SqlUserDefinedTypeAttribute declarado.

Comentarios

Solo se permite pasar lo siguiente SqlDbType al constructor como dbType: UDT.

SqlDbType	Longitud máxima	Precisión	Escala	Configuración regional	Comparación de opciones
UDT	<Longitud máxima del tipo> o -1	0	0	0	None

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * int64 -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

maxLength: Int64

Longitud máxima del tipo especificado.

Excepciones

ArgumentNullException

El valor de Name es null.

ArgumentException

Se ha pasado un SqlDbType no permitido al constructor como dbType.

Ejemplos

En el ejemplo siguiente se crea un nuevo SqlMetaData objeto especificando el nombre de columna, un tipo de datos de columna de SqlDbType.NVarChary una longitud máxima de 12 caracteres.

public static void CreateSqlMetaData1()
{
   SqlMetaData columnInfo;
   columnInfo = new SqlMetaData("Column1", SqlDbType.NVarChar, 12);
}

Public Shared Sub CreateSqlMetaData1()

   Dim columnInfo As SqlMetaData
   columnInfo = new SqlMetaData("ColumnName", SqlDbType.NVarChar, 12)

End Sub

Comentarios

Solo se permite pasar lo siguiente al constructor como dbType: Binary, Char, Image, NChar, NtextNVarCharText, , VarBinary. VarChar

Solo se permite una maxLength especificación de Max, o -1 para un dbType de Text, NTexto Image.

Para un dbType de Varchar, Nvarcharo VarBinary, una especificación de longitud de Max, o -1, declara los metadatos como varchar(max), nvarchar(max) o nvarbinary(max), respectivamente.

SqlDbType	Configuración regional	Comparación de opciones
Binary	0	IgnoreCase, IgnoreKanaType, IgnoreWidth
Char	<thread>	IgnoreCase, IgnoreKanaType, IgnoreWidth
Imagen	0	None
NChar	<thread>	IgnoreCase, IgnoreKanaType, IgnoreWidth
NText	<thread>	IgnoreCase, IgnoreKanaType, IgnoreWidth
NVarChar	<thread>	IgnoreCase, IgnoreKanaType, IgnoreWidth
Texto	<thread>	IgnoreCase, IgnoreKanaType, IgnoreWidth
VarBinary		IgnoreCase, IgnoreKanaType, IgnoreWidth
VarChar	<thread>	IgnoreCase, IgnoreKanaType, IgnoreWidth

Se aplica a

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.

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, bool useServerDefault, bool isUniqueKey, System::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, bool useServerDefault, bool isUniqueKey, System.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.SqlServer.Server.SqlMetaData : string * System.Data.SqlDbType * bool * bool * System.Data.SqlClient.SortOrder * int -> Microsoft.SqlServer.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

Parámetros

name: String

El nombre de la columna.

dbType: SqlDbType

Tipo de SQL Server del parámetro o de la columna.

useServerDefault: Boolean

Especifica si esta columna debe usar el valor de servidor predeterminado.

isUniqueKey: Boolean

Especifica si la columna del parámetro con valores de tabla es única.

columnSortOrder: SortOrder

Especifica el criterio de ordenación de una columna.

sortOrdinal: Int32

Especifica el ordinal de la columna de ordenación.

Comentarios

Para obtener más información, vea Parámetros con valores de tabla.

Se aplica a

SqlMetaData Constructores

Definición

Sobrecargas

SqlMetaData(String, SqlDbType)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32)

Parámetros

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32)

Parámetros

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32)

Parámetros

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32)

Parámetros

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32)

Parámetros

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32)

Parámetros

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)

Parámetros

Excepciones

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, String, String, String)

Parámetros

Excepciones

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions)

Parámetros

Excepciones

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Type, String)

Parámetros

Se aplica a

SqlMetaData(String, SqlDbType, Byte, Byte)

Parámetros

Excepciones

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Type)

Parámetros

Excepciones

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Int64)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)

Parámetros

Comentarios

Se aplica a

Recursos adicionales