SqlMetaData Classe

Definizione

Specifica e recupera le informazioni sui metadati dai parametri e dalle colonne degli oggetti SqlDataRecord. La classe non può essere ereditata.

public ref class SqlMetaData sealed
public sealed class SqlMetaData
type SqlMetaData = class
Public NotInheritable Class SqlMetaData
Ereditarietà
SqlMetaData

Esempio

Nell'esempio seguente viene illustrata la creazione di diversi SqlMetaData oggetti, che descrivono i metadati di colonna di un record e la creazione di un oggetto SqlDataRecord. I valori di colonna dell'oggetto SqlDataRecord sono impostati e vengono SqlDataRecord inviati al programma chiamante usando 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

Costruttori

SqlMetaData(String, SqlDbType)

Inizializza una nuova istanza della classe SqlMetaData con il tipo e il nome specificati.

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

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna e il server predefinito specificati. Questo formato del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordinamento per la colonna e l'ordinale della colonna di ordinamento.

SqlMetaData(String, SqlDbType, Byte, Byte)

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, il tipo, la precisione e la scala specificati.

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

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, il tipo, la precisione, la scala e il server predefinito specificati. Questo formato del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordinamento per la colonna e l'ordinale della colonna di ordinamento.

SqlMetaData(String, SqlDbType, Int64)

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, il tipo e la lunghezza massima specificati.

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

Inizializza una nuova istanza della classe SqlMetaData con il nome, il tipo e la lunghezza massima di colonna e il server predefinito specificati. Questo formato del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordinamento per la colonna e l'ordinale della colonna di ordinamento.

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

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, il tipo, la lunghezza massima, la precisione, la scala, l'ID delle impostazioni locali, le opzioni di confronto e il tipo definito dall'utente (UDT) specificati.

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

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, il tipo, la lunghezza massima, la precisione, la scala, l'ID delle impostazioni locali, le opzioni di confronto e il tipo definito dall'utente (UDT) specificati. Questo formato del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordinamento per la colonna e l'ordinale della colonna di ordinamento.

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

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, il tipo, la lunghezza massima, le impostazioni locali e le opzioni di confronto specificati.

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

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, il tipo, la lunghezza massima, le impostazioni locali, le opzioni di confronto e il server predefinito specificati. Questo formato del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordinamento per la colonna e l'ordinale della colonna di ordinamento.

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

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, il tipo, il nome database, lo schema di appartenenza e il nome oggetto specificati.

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

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, il tipo, il nome database, lo schema di appartenenza, il nome oggetto e il server predefinito specificati. Questo formato del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordinamento per la colonna e l'ordinale della colonna di ordinamento.

SqlMetaData(String, SqlDbType, Type)

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, il tipo e il tipo definito dall'utente (UDT) specificati.

SqlMetaData(String, SqlDbType, Type, String)

Inizializza una nuova istanza della classe SqlMetaData con il nome della colonna, del tipo definito dall'utente (UDT) e del tipo SQLServer specificati.

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

Inizializza una nuova istanza della classe SqlMetaData con il nome, il tipo, il tipo definito dall'utente (SQL) e il tipo SQLServer della colonna e il server predefinito specificati. Questo formato del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordinamento per la colonna e l'ordinale della colonna di ordinamento.

Proprietà

CompareOptions

Ottiene le regole di confronto utilizzate per la colonna o il parametro.

DbType

Ottiene il tipo di dati della colonna o del parametro.

IsUniqueKey

Indica se la colonna nel parametro con valori di livello di tabella è univoca.

LocaleId

Ottiene l'ID delle impostazioni locali della colonna o del parametro.

Max

Ottiene la lunghezza dei tipi di dati text, ntext e image.

MaxLength

Ottiene la lunghezza massima della colonna o del parametro.

Name

Ottiene il nome della colonna o del parametro.

Precision

Ottiene la precisione della colonna o del parametro.

Scale

Ottiene la scala della colonna o del parametro.

SortOrder

Restituisce il criterio di ordinamento per una colonna.

SortOrdinal

Restituisce l'ordinale della colonna di ordinamento.

SqlDbType

Ottiene il tipo di dati della colonna o del parametro.

Type

Ottiene il tipo CLR (Common Language Runtime) di un tipo definito dall'utente (UDT).

TypeName

Ottiene il nome diviso in tre parti del tipo definito dall'utente (UDT) o il tipo SQL Server rappresentato dall'istanza.

UseServerDefault

Segnala se questa colonna deve utilizzare il valore server predefinito.

XmlSchemaCollectionDatabase

Ottiene il nome del database in cui si trova la raccolta di schemi per questa istanza XML.

XmlSchemaCollectionName

Ottiene il nome della raccolta di schemi per questa istanza XML.

XmlSchemaCollectionOwningSchema

Ottiene lo schema relazionale di appartenenza in cui si trova l'insieme di schemi di questa istanza XML.

Metodi

Adjust(Boolean)

Convalida il valore Boolean specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Byte)

Convalida il valore Byte specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Byte[])

Convalida la matrice di Byte specificata rispetto ai metadati e modifica il valore se necessario.

Adjust(Char)

Convalida il valore Char specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Char[])

Convalida la matrice di Char specificata rispetto ai metadati e modifica il valore se necessario.

Adjust(DateTime)

Convalida il valore DateTime specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(DateTimeOffset)

Convalida il valore DateTimeOffset specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Decimal)

Convalida il valore Decimal specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Double)

Convalida il valore Double specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Guid)

Convalida il valore Guid specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Int16)

Convalida il valore Int16 specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Int32)

Convalida il valore Int32 specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Int64)

Convalida il valore Int64 specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Object)

Convalida il valore Object specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(Single)

Convalida il valore Single specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlBinary)

Convalida il valore SqlBinary specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlBoolean)

Convalida il valore SqlBoolean specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlByte)

Convalida il valore SqlByte specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlBytes)

Convalida il valore SqlBytes specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlChars)

Convalida il valore SqlChars specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlDateTime)

Convalida il valore SqlDateTime specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlDecimal)

Convalida il valore SqlDecimal specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlDouble)

Convalida il valore SqlDouble specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlGuid)

Convalida il valore SqlGuid specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlInt16)

Convalida il valore SqlInt16 specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlInt32)

Convalida il valore SqlInt32 specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlInt64)

Convalida il valore SqlInt64 specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlMoney)

Convalida il valore SqlMoney specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlSingle)

Convalida il valore SqlSingle specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlString)

Convalida il valore SqlString specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(SqlXml)

Convalida il valore SqlXml specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(String)

Convalida il valore String specificato rispetto ai relativi metadati e modifica il valore se necessario.

Adjust(TimeSpan)

Convalida il valore TimeSpan specificato rispetto ai relativi metadati e modifica il valore se necessario.

InferFromValue(Object, String)

Deriva i metadati dall'oggetto specificato e li restituisce come istanza di SqlMetaData.

Si applica a