SqlMetaData Classe

Definizione

Spazio dei nomi:: Microsoft.Data.SqlClient.Server

Assembly:: Microsoft.Data.SqlClient.dll

Pacchetto:: Microsoft.Data.SqlClient v1.0.19269.1

Pacchetto:: Microsoft.Data.SqlClient v1.1.4

Pacchetto:: Microsoft.Data.SqlClient v2.0.1

Pacchetto:: Microsoft.Data.SqlClient v2.1.4

Pacchetto:: Microsoft.Data.SqlClient v3.0.1

Pacchetto:: Microsoft.Data.SqlClient v3.1.0

Pacchetto:: Microsoft.Data.SqlClient v4.0.1

Pacchetto:: Microsoft.Data.SqlClient v4.1.0

Pacchetto:: Microsoft.Data.SqlClient v5.0.0

Pacchetto:: Microsoft.Data.SqlClient v5.1.0

Pacchetto:: Microsoft.Data.SqlClient v5.2.0

Pacchetto:: Microsoft.Data.SqlClient v6.0.2

Pacchetto:: Microsoft.Data.SqlClient v6.1.3

Pacchetto:: Microsoft.Data.SqlClient v7.0.3

Pacchetto:: Microsoft.Data.SqlClient v7.1.0

Origine:: SqlMetaData.cs

Origine:: SqlMetaData.cs

Origine:: SqlMetaData.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Specifica le informazioni sui metadati di una colonna utilizzata da un SqlDataRecord oggetto . La classe non può essere ereditata.

public ref class SqlMetaData sealed

public sealed class SqlMetaData

type SqlMetaData = class

Public NotInheritable Class SqlMetaData

Ereditarietà: Object
SqlMetaData

Esempio

Nell'esempio seguente viene illustrata la creazione di diversi SqlMetaData oggetti, che descrivono i metadati della colonna di un record e la generazione di un flusso di SqlDataRecord record. Questi SqlDataRecord record possono essere trasmessi a SQL Server come parametro con valori di tabella assegnando il valore restituito del metodo alla Value proprietà .

using System;
using System.Collections.Generic;
using System.Data;
using Microsoft.Data.SqlClient.Server;

public static IEnumerable<SqlDataRecord> ReturnNewRecords()
{
    // 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 fields of the first record and stream it to SQL Server.
    record.SetString(0, "Hello World!");
    record.SetInt32(1, 42);
    record.SetDateTime(2, DateTime.Now);
    yield return record;

    // Set the fields of the second record and stream it to SQL Server.
    record.SetInt32(1, 0);
    yield return record;
}

Commenti

SqlMetaDataLe istanze vengono in genere compilate una volta e riutilizzate per costruire molti SqlDataRecord oggetti trasmessi a SQL Server come parametro con valori di tabella. Per altre informazioni, vedere ParametriTable-Valued.

Costruttori

Nome	Descrizione
SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)	Inizializza una nuova istanza della SqlMetaData classe con il nome di colonna specificato e il server predefinito. Questa versione del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordine di ordinamento della colonna e la posizione ordinale della colonna di ordinamento.
SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32)	Inizializza una nuova istanza della SqlMetaData classe con il nome di colonna, il tipo, la precisione, la scala e il valore predefinito del server specificati. Questa versione del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordine di ordinamento della colonna e la posizione ordinale della colonna di ordinamento.
SqlMetaData(String, SqlDbType, Byte, Byte)	Inizializza una nuova istanza della SqlMetaData classe con il nome di colonna, il tipo, la precisione e la scala specificati.
SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32)	Inizializza una nuova istanza della SqlMetaData classe con il nome di colonna, il tipo, la lunghezza massima e l'impostazione predefinita del server specificati. Questa versione del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordine di ordinamento della colonna e la posizione ordinale della colonna di ordinamento.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32)	Inizializza una nuova istanza della SqlMetaData classe con il nome di 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 specificati. Questa versione del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordine di ordinamento della colonna e la posizione ordinale della colonna di ordinamento.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)	Inizializza una nuova istanza della SqlMetaData classe con il nome di 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 specificati.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32)	Inizializza una nuova istanza della SqlMetaData classe con il nome della colonna, il tipo, la lunghezza massima, le impostazioni locali, le opzioni di confronto e il valore predefinito del server specificati. Questa versione del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordine di ordinamento della colonna e la posizione ordinale della colonna di ordinamento.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions)	Inizializza una nuova istanza della SqlMetaData classe con il nome della colonna, il tipo, la lunghezza massima, le impostazioni locali e le opzioni di confronto specificati.
SqlMetaData(String, SqlDbType, Int64)	Inizializza una nuova istanza della SqlMetaData classe con il nome di colonna, il tipo e la lunghezza massima specificati.
SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32)	Inizializza una nuova istanza della SqlMetaData classe con il nome di colonna, il nome del database, lo schema proprietario, il nome dell'oggetto e il server predefinito specificati. Questa versione del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordine di ordinamento della colonna e la posizione ordinale della colonna di ordinamento.
SqlMetaData(String, SqlDbType, String, String, String)	Inizializza una nuova istanza della SqlMetaData classe con il nome di colonna, il tipo, il nome del database, lo schema proprietario e il nome dell'oggetto specificati.
SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32)	Inizializza una nuova istanza della SqlMetaData classe con il nome di colonna, il tipo, il tipo definito dall'utente, il tipo SQL Server e l'impostazione predefinita del server specificati. Questa versione del costruttore supporta i parametri con valori di tabella consentendo di specificare se la colonna è univoca nel parametro con valori di tabella, l'ordine di ordinamento della colonna e la posizione ordinale della colonna di ordinamento.
SqlMetaData(String, SqlDbType, Type, String)	Inizializza una nuova istanza della SqlMetaData classe con il nome di colonna, il tipo definito dall'utente (UDT) e il tipo di SQL Server specificati.
SqlMetaData(String, SqlDbType, Type)	Inizializza una nuova istanza della SqlMetaData classe con il nome di colonna, il tipo e il tipo definito dall'utente specificati.
SqlMetaData(String, SqlDbType)	Inizializza una nuova istanza della SqlMetaData classe con il nome e il tipo di colonna specificati.

Proprietà

Nome	Descrizione
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 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 l'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 tipo definito dall'utente (UDT).
TypeName	Ottiene il nome in tre parti del tipo definito dall'utente o del tipo SQL Server rappresentato dall'istanza.
UseServerDefault	Indica se questa colonna deve utilizzare il valore del 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 proprietario in cui si trova la raccolta di schemi per questa istanza XML.

Metodi

Nome	Descrizione
Adjust(Boolean)	Convalida il valore specificato Boolean rispetto ai metadati e regola il valore, se necessario.
Adjust(Byte)	Convalida il valore specificato Byte rispetto ai metadati e regola il valore, se necessario.
Adjust(Byte[])	Convalida la matrice di Byte valori specificata rispetto ai metadati e regola il valore, se necessario.
Adjust(Char)	Convalida il valore specificato Char rispetto ai metadati e regola il valore, se necessario.
Adjust(Char[])	Convalida la matrice di Char valori specificata rispetto ai metadati e regola il valore, se necessario.
Adjust(DateTime)	Convalida il valore specificato DateTime rispetto ai metadati e regola il valore, se necessario.
Adjust(DateTimeOffset)	Convalida il valore specificato DateTimeOffset rispetto ai metadati e regola il valore, se necessario.
Adjust(Decimal)	Convalida il valore specificato Decimal rispetto ai metadati e regola il valore, se necessario.
Adjust(Double)	Convalida il valore specificato Double rispetto ai metadati e regola il valore, se necessario.
Adjust(Guid)	Convalida il valore specificato Guid rispetto ai metadati e regola il valore, se necessario.
Adjust(Int16)	Convalida il valore specificato Int16 rispetto ai metadati e regola il valore, se necessario.
Adjust(Int32)	Convalida il valore specificato Int32 rispetto ai metadati e regola il valore, se necessario.
Adjust(Int64)	Convalida il valore specificato Int64 rispetto ai metadati e regola il valore, se necessario.
Adjust(Object)	Convalida il valore specificato Object rispetto ai metadati e regola il valore, se necessario.
Adjust(Single)	Convalida il valore specificato Single rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlBinary)	Convalida il valore specificato SqlBinary rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlBoolean)	Convalida il valore specificato SqlBoolean rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlByte)	Convalida il valore specificato SqlByte rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlBytes)	Convalida il valore specificato SqlBytes rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlChars)	Convalida il valore specificato SqlChars rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlDateTime)	Convalida il valore specificato SqlDateTime rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlDecimal)	Convalida il valore specificato SqlDecimal rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlDouble)	Convalida il valore specificato SqlDouble rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlGuid)	Convalida il valore specificato SqlGuid rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlInt16)	Convalida il valore specificato SqlInt16 rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlInt32)	Convalida il valore specificato SqlInt32 rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlInt64)	Convalida il valore specificato SqlInt64 rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlMoney)	Convalida il valore specificato SqlMoney rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlSingle)	Convalida il valore specificato SqlSingle rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlString)	Convalida il valore specificato SqlString rispetto ai metadati e regola il valore, se necessario.
Adjust(SqlXml)	Convalida il valore specificato SqlXml rispetto ai metadati e regola il valore, se necessario.
Adjust(String)	Convalida il valore specificato String rispetto ai metadati e regola il valore, se necessario.
Adjust(TimeSpan)	Convalida il valore specificato TimeSpan rispetto ai metadati e regola il valore, se necessario.
InferFromValue(Object, String)	Deduce i metadati dall'oggetto specificato e lo restituisce come SqlMetaData istanza.

Si applica a