Udostępnij za pośrednictwem


SqlMetaData Klasa

Definicja

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
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ść texttypów danych , ntexti 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