Freigeben über


SqlMetaData Klasse

Definition

Gibt Metadateninformationen von Parametern und Spalten von SqlDataRecord-Objekten an und ruft diese ab. Diese Klasse kann nicht vererbt werden.

public ref class SqlMetaData sealed
public sealed class SqlMetaData
type SqlMetaData = class
Public NotInheritable Class SqlMetaData
Vererbung
SqlMetaData

Beispiele

Das folgende Beispiel zeigt die Erstellung mehrerer SqlMetaData -Objekte, die die Spaltenmetadaten eines Datensatzes beschreiben, und die Erstellung eines SqlDataRecord. Die Spaltenwerte des SqlDataRecord werden festgelegt, und das SqlDataRecord wird mithilfe der -Klasse an das SqlContext aufrufende Programm gesendet.

[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

Konstruktoren

SqlMetaData(String, SqlDbType)

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens und Typs.

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

Initialisiert eine neue Instanz der SqlMetaData-Klasse mit dem angegebenen Spaltennamen und dem Standardserver. Diese Form des Konstruktors unterstützt Tabellenwertparameter, indem er ermöglicht, anzugeben, ob die Spalte im Tabellenwertparameter eindeutig ist, sowie die Sortierreihenfolge für die Spalte und die Ordnungszahl der Sortierspalte anzugeben.

SqlMetaData(String, SqlDbType, Byte, Byte)

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs sowie der angegebenen Genauigkeit und Skalierung.

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

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs, der angegebenen Genauigkeit sowie der angegebenen Skalierung und der Standardeinstellung für den Server. Diese Form des Konstruktors unterstützt Tabellenwertparameter, indem er ermöglicht, anzugeben, ob die Spalte im Tabellenwertparameter eindeutig ist, sowie die Sortierreihenfolge für die Spalte und die Ordnungszahl der Sortierspalte anzugeben.

SqlMetaData(String, SqlDbType, Int64)

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs und der angegebenen maximalen Länge.

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

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs, der angegebenen maximalen Länge und der Standardeinstellung für den Server. Diese Form des Konstruktors unterstützt Tabellenwertparameter, indem er ermöglicht, anzugeben, ob die Spalte im Tabellenwertparameter eindeutig ist, sowie die Sortierreihenfolge für die Spalte und die Ordnungszahl der Sortierspalte anzugeben.

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

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs, der angegebenen maximalen Länge, der angegebenen Genauigkeit, Skalierung und Gebietsschema-ID, der angegebenen Vergleichsoptionen und des angegebenen benutzerdefinierten Typs (UDT).

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

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs, der angegebenen maximalen Länge, der angegebenen Genauigkeit, Skalierung und Gebietsschema-ID, der angegebenen Vergleichsoptionen und des angegebenen benutzerdefinierten Typs (UDT). Diese Form des Konstruktors unterstützt Tabellenwertparameter, indem er ermöglicht, anzugeben, ob die Spalte im Tabellenwertparameter eindeutig ist, sowie die Sortierreihenfolge für die Spalte und die Ordnungszahl der Sortierspalte anzugeben.

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

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs, der angegebenen maximalen Länge, des angegebenen Gebietsschemas und der angegebenen Vergleichsoptionen.

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

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs, der angegebenen maximalen Länge, des angegebenen Gebietsschemas sowie der angegebenen Vergleichsoptionen und der Standardeinstellung für den Server. Diese Form des Konstruktors unterstützt Tabellenwertparameter, indem er ermöglicht, anzugeben, ob die Spalte im Tabellenwertparameter eindeutig ist, sowie die Sortierreihenfolge für die Spalte und die Ordnungszahl der Sortierspalte anzugeben.

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

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs, des angegebenen Datenbanknamens, des angegebenen Besitzerschemas und des angegebenen Objektnamens.

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

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Datenbanknamens, des angegebenen Besitzerschemas sowie des angegebenen Objektnamens und der Standardeinstellung für den Server. Diese Form des Konstruktors unterstützt Tabellenwertparameter, indem er ermöglicht, anzugeben, ob die Spalte im Tabellenwertparameter eindeutig ist, sowie die Sortierreihenfolge für die Spalte und die Ordnungszahl der Sortierspalte anzugeben.

SqlMetaData(String, SqlDbType, Type)

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs und des angegebenen benutzerdefinierten Typs (UDT).

SqlMetaData(String, SqlDbType, Type, String)

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen benutzerdefinierten Typs (UDT) und des angegebenen SQLServer-Typs.

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

Initialisiert eine neue Instanz der SqlMetaData-Klasse unter Verwendung des angegebenen Spaltennamens, des angegebenen Typs, des angegebenen benutzerdefinierten Typs sowie des angegebenen SQLServer-Typs und der Standardeinstellung für den Server. Diese Form des Konstruktors unterstützt Tabellenwertparameter, indem er ermöglicht, anzugeben, ob die Spalte im Tabellenwertparameter eindeutig ist, sowie die Sortierreihenfolge für die Spalte und die Ordnungszahl der Sortierspalte anzugeben.

Eigenschaften

CompareOptions

Ruft die für die Spalte oder den Parameter verwendeten Vergleichsregeln ab.

DbType

Ruft den Datentyp der Spalte oder des Parameters ab.

IsUniqueKey

Gibt an, ob die Spalte im Tabellenwertparameter eindeutig ist.

LocaleId

Ruft die Gebietsschema-ID der Spalte oder des Parameters ab.

Max

Ruft die Länge von text-Datentypen, ntext-Datentypen und image-Datentypen ab.

MaxLength

Ruft die maximale Länge der Spalte oder des Parameters ab.

Name

Ruft den Namen der Spalte oder des Parameters ab.

Precision

Ruft die Genauigkeit der Spalte oder des Parameters ab.

Scale

Ruft die Skalierung der Spalte oder des Parameters ab.

SortOrder

Gibt die Sortierreihenfolge für eine Spalte zurück.

SortOrdinal

Gibt die Ordnungszahl der Sortierspalte zurück.

SqlDbType

Ruft den Datentyp der Spalte oder des Parameters ab.

Type

Ruft den CLR (Common Language Runtime)-Typ eines benutzerdefinierten Typs (UDT) ab.

TypeName

Ruft den dreiteiligen Namen des benutzerdefinierten Typs (UDT) oder des SQL Server-Typs an, der durch die Instanz dargestellt wird.

UseServerDefault

Gibt an, ob diese Spalte den Standardserverwert verwenden soll.

XmlSchemaCollectionDatabase

Ruft den Namen der Datenbank ab, in der sich die Schemaauflistung für diese XML-Instanz befindet.

XmlSchemaCollectionName

Ruft den Namen der Schemaauflistung für diese XML-Instanz ab.

XmlSchemaCollectionOwningSchema

Ruft das besitzende relationale Schema ab, in dem sich die Schemaauflistung für diese XML-Instanz befindet.

Methoden

Adjust(Boolean)

Überprüft den angegebenen Boolean-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Byte)

Überprüft den angegebenen Byte-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Byte[])

Überprüft das angegebene Array von Byte-Werten anhand der Metadaten und passt den Wert ggf. an.

Adjust(Char)

Überprüft den angegebenen Char-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Char[])

Überprüft das angegebene Array von Char-Werten anhand der Metadaten und passt den Wert ggf. an.

Adjust(DateTime)

Überprüft den angegebenen DateTime-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(DateTimeOffset)

Überprüft den angegebenen DateTimeOffset-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Decimal)

Überprüft den angegebenen Decimal-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Double)

Überprüft den angegebenen Double-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Guid)

Überprüft den angegebenen Guid-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Int16)

Überprüft den angegebenen Int16-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Int32)

Überprüft den angegebenen Int32-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Int64)

Überprüft den angegebenen Int64-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Object)

Überprüft den angegebenen Object-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(Single)

Überprüft den angegebenen Single-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlBinary)

Überprüft den angegebenen SqlBinary-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlBoolean)

Überprüft den angegebenen SqlBoolean-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlByte)

Überprüft den angegebenen SqlByte-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlBytes)

Überprüft den angegebenen SqlBytes-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlChars)

Überprüft den angegebenen SqlChars-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlDateTime)

Überprüft den angegebenen SqlDateTime-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlDecimal)

Überprüft den angegebenen SqlDecimal-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlDouble)

Überprüft den angegebenen SqlDouble-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlGuid)

Überprüft den angegebenen SqlGuid-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlInt16)

Überprüft den angegebenen SqlInt16-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlInt32)

Überprüft den angegebenen SqlInt32-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlInt64)

Überprüft den angegebenen SqlInt64-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlMoney)

Überprüft den angegebenen SqlMoney-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlSingle)

Überprüft den angegebenen SqlSingle-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlString)

Überprüft den angegebenen SqlString-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(SqlXml)

Überprüft den angegebenen SqlXml-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(String)

Überprüft den angegebenen String-Wert anhand der Metadaten und passt ihn ggf. an.

Adjust(TimeSpan)

Überprüft den angegebenen TimeSpan-Wert anhand der Metadaten und passt ihn ggf. an.

InferFromValue(Object, String)

Leitet die Metadaten aus dem angegebenen Objekt ab und gibt sie als SqlMetaData-Instanz zurück.

Gilt für: