SqlMetaData Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt Metadateninformationen von Parametern und Spalten von SqlDataRecord-Objekten an und ruft diese ab. Diese Klasse kann nicht vererbt werden.
public ref class SqlMetaData sealedpublic sealed class SqlMetaDatatype SqlMetaData = classPublic 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 |
| 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. |