SqlMetaData Klasa

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.SqlServer.Server

Zestaw:: System.Data.SqlClient.dll

Zestaw:: System.Data.dll

Pakiet:: System.Data.SqlClient v4.8.5

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Określa i pobiera informacje o metadanych z parametrów i kolumn SqlDataRecord obiektów. Klasa ta nie może być dziedziczona.

public ref class SqlMetaData sealed

public sealed class SqlMetaData

type SqlMetaData = class

Public NotInheritable Class SqlMetaData

Dziedziczenie: Object
SqlMetaData

Przykłady

W poniższym przykładzie pokazano tworzenie kilku SqlMetaData obiektów, które opisują metadane kolumny rekordu oraz tworzenie obiektu SqlDataRecord. Wartości SqlDataRecord kolumny są ustawione, a element SqlDataRecord jest wysyłany do programu wywołującego SqlContext przy użyciu klasy .

[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

Konstruktory

SqlMetaData(String, SqlDbType)	Inicjuje SqlMetaData nowe wystąpienie klasy o określonej nazwie i typie kolumny.
SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)	Inicjuje SqlMetaData nowe wystąpienie klasy z określoną nazwą kolumny i serwerem domyślnym. Ta forma konstruktora obsługuje parametry wartości tabeli, umożliwiając określenie, czy kolumna jest unikatowa w parametrze wartości tabeli, kolejności sortowania kolumny i porządkowości kolumny sortowania.
SqlMetaData(String, SqlDbType, Byte, Byte)	Inicjuje SqlMetaData nowe wystąpienie klasy z określoną nazwą kolumny, typem, precyzją i skalowaniem.
SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą kolumny, typem, precyzją, skalowaniem i domyślnym serwerem. Ta forma konstruktora obsługuje parametry wartości tabeli, umożliwiając określenie, czy kolumna jest unikatowa w parametrze wartości tabeli, kolejności sortowania kolumny i porządkowości kolumny sortowania.
SqlMetaData(String, SqlDbType, Int64)	Inicjuje SqlMetaData nowe wystąpienie klasy o określonej nazwie kolumny, typie i maksymalnej długości.
SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32)	Inicjuje SqlMetaData nowe wystąpienie klasy z określoną nazwą kolumny, typem, maksymalną długością i domyślnym serwerem. Ta forma konstruktora obsługuje parametry wartości tabeli, umożliwiając określenie, czy kolumna jest unikatowa w parametrze wartości tabeli, kolejności sortowania kolumny i porządkowości kolumny sortowania.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą kolumny, typem, maksymalną długością, dokładnością, skalowaniem, identyfikatorem ustawień regionalnych, opcjami porównania i typem zdefiniowanym przez użytkownika (UDT).
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą kolumny, typem, maksymalną długością, dokładnością, skalowaniem, identyfikatorem ustawień regionalnych, opcjami porównania i typem zdefiniowanym przez użytkownika (UDT). Ta forma konstruktora obsługuje parametry wartości tabeli, umożliwiając określenie, czy kolumna jest unikatowa w parametrze wartości tabeli, kolejności sortowania kolumny i porządkowości kolumny sortowania.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions)	Inicjuje SqlMetaData nowe wystąpienie klasy z określoną nazwą kolumny, typem, maksymalną długością, ustawieniami regionalnymi i opcjami porównania.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą kolumny, typem, maksymalną długością, ustawieniami regionalnymi, opcjami porównania i wartością domyślną serwera. Ta forma konstruktora obsługuje parametry wartości tabeli, umożliwiając określenie, czy kolumna jest unikatowa w parametrze wartości tabeli, kolejności sortowania kolumny i porządkowości kolumny sortowania.
SqlMetaData(String, SqlDbType, String, String, String)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą kolumny, typem, nazwą bazy danych, schematem posiadania i nazwą obiektu.
SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32)	Inicjuje SqlMetaData nowe wystąpienie klasy o określonej nazwie kolumny, nazwie bazy danych, schemacie, nazwie obiektu i serwerze domyślnym. Ta forma konstruktora obsługuje parametry wartości tabeli, umożliwiając określenie, czy kolumna jest unikatowa w parametrze wartości tabeli, kolejności sortowania kolumny i porządkowości kolumny sortowania.
SqlMetaData(String, SqlDbType, Type)	Inicjuje SqlMetaData nowe wystąpienie klasy z określoną nazwą kolumny, typem i typem zdefiniowanym przez użytkownika (UDT).
SqlMetaData(String, SqlDbType, Type, String)	Inicjuje SqlMetaData nowe wystąpienie klasy z określoną nazwą kolumny, typem zdefiniowanym przez użytkownika (UDT) i typem SQLServer.
SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32)	Inicjuje SqlMetaData nowe wystąpienie klasy z określoną nazwą kolumny, typem, typem zdefiniowanym przez użytkownika, typem SQL Server i wartością domyślną serwera. Ta forma konstruktora obsługuje parametry wartości tabeli, umożliwiając określenie, czy kolumna jest unikatowa w parametrze wartości tabeli, kolejności sortowania kolumny i porządkowości kolumny sortowania.

Właściwości

CompareOptions	Pobiera reguły porównania używane dla kolumny lub parametru.
DbType	Pobiera typ danych kolumny lub parametru.
IsUniqueKey	Wskazuje, czy kolumna w parametrze z wartością tabeli jest unikatowa.
LocaleId	Pobiera identyfikator ustawień regionalnych kolumny lub parametru.
Max	Pobiera długość `text`typów danych , `ntext`i `image` .
MaxLength	Pobiera maksymalną długość kolumny lub parametru.
Name	Pobiera nazwę kolumny lub parametru.
Precision	Pobiera dokładność kolumny lub parametru.
Scale	Pobiera skalę kolumny lub parametru.
SortOrder	Zwraca kolejność sortowania dla kolumny.
SortOrdinal	Zwraca porządkową kolumnę sortowania.
SqlDbType	Pobiera typ danych kolumny lub parametru.
Type	Pobiera typ środowiska uruchomieniowego języka wspólnego (CLR) typu zdefiniowanego przez użytkownika (UDT).
TypeName	Pobiera trzyczęściową nazwę typu zdefiniowanego przez użytkownika (UDT) lub typ SQL Server reprezentowany przez wystąpienie.
UseServerDefault	Zgłasza, czy ta kolumna powinna używać wartości domyślnej serwera.
XmlSchemaCollectionDatabase	Pobiera nazwę bazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML.
XmlSchemaCollectionName	Pobiera nazwę kolekcji schematów dla tego wystąpienia XML.
XmlSchemaCollectionOwningSchema	Pobiera schemat relacyjny, w którym znajduje się kolekcja schematów dla tego wystąpienia XML.

Metody

Adjust(Boolean)	Weryfikuje określoną Boolean wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Byte)	Weryfikuje określoną Byte wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Byte[])	Sprawdza poprawność określonej tablicy Byte wartości względem metadanych i w razie potrzeby dostosowuje wartość.
Adjust(Char)	Weryfikuje określoną Char wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Char[])	Sprawdza poprawność określonej tablicy Char wartości względem metadanych i w razie potrzeby dostosowuje wartość.
Adjust(DateTime)	Weryfikuje określoną DateTime wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(DateTimeOffset)	Weryfikuje określoną DateTimeOffset wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Decimal)	Weryfikuje określoną Decimal wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Double)	Weryfikuje określoną Double wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Guid)	Weryfikuje określoną Guid wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Int16)	Weryfikuje określoną Int16 wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Int32)	Weryfikuje określoną Int32 wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Int64)	Weryfikuje określoną Int64 wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Object)	Weryfikuje określoną Object wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Single)	Weryfikuje określoną Single wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlBinary)	Weryfikuje określoną SqlBinary wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlBoolean)	Weryfikuje określoną SqlBoolean wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlByte)	Weryfikuje określoną SqlByte wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlBytes)	Weryfikuje określoną SqlBytes wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlChars)	Weryfikuje określoną SqlChars wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlDateTime)	Weryfikuje określoną SqlDateTime wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlDecimal)	Weryfikuje określoną SqlDecimal wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlDouble)	Weryfikuje określoną SqlDouble wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlGuid)	Weryfikuje określoną SqlGuid wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlInt16)	Weryfikuje określoną SqlInt16 wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlInt32)	Weryfikuje określoną SqlInt32 wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlInt64)	Weryfikuje określoną SqlInt64 wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlMoney)	Weryfikuje określoną SqlMoney wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlSingle)	Weryfikuje określoną SqlSingle wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlString)	Weryfikuje określoną SqlString wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(SqlXml)	Weryfikuje określoną SqlXml wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(String)	Weryfikuje określoną String wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(TimeSpan)	Weryfikuje określoną TimeSpan wartość względem metadanych i dostosowuje wartość w razie potrzeby.
InferFromValue(Object, String)	Wywnioskuje metadane z określonego obiektu i zwraca je jako SqlMetaData wystąpienie.

Dotyczy