SqlMetaData Klasa

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient.Server

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v7.1.0

Określa informacje o metadanych kolumny używanej SqlDataRecord przez obiekt. 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 generowanie strumienia rekordów SqlDataRecord . Te SqlDataRecord rekordy można przesyłać strumieniowo do SQL Server jako parametru wartości tabeli, przypisując wartość zwracaną metody do Value właściwości.

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;
}

Uwagi

SqlMetaDatawystąpienia są zwykle tworzone raz i używane ponownie do konstruowania wielu SqlDataRecord obiektów, które są przesyłane strumieniowo do SQL Server jako parametru wartości tabeli. Aby uzyskać więcej informacji, zobacz parametryTable-Valued.

Konstruktory

Nazwisko	Opis
SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)	Inicjuje nowe wystąpienie SqlMetaData 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, 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, Byte, Byte)	Inicjuje nowe wystąpienie SqlMetaData klasy o określonej nazwie kolumny, typie, precyzji i skali.
SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32)	Inicjuje nowe wystąpienie SqlMetaData 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, Boolean, Boolean, SortOrder, Int32)	Inicjuje nowe wystąpienie SqlMetaData klasy o określonej nazwie kolumny, typie, maksymalnej długości, precyzji, skali, identyfikatorze ustawień regionalnych, opcjach porównania i typie 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, Byte, Byte, Int64, SqlCompareOptions, Type)	Inicjuje nowe wystąpienie SqlMetaData klasy o określonej nazwie kolumny, typie, maksymalnej długości, precyzji, skali, identyfikatorze ustawień regionalnych, opcjach porównania i typie zdefiniowanym przez użytkownika (UDT).
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, Int64, Int64, SqlCompareOptions)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą kolumny, typem, maksymalną długością, ustawieniami regionalnymi i opcjami porównania.
SqlMetaData(String, SqlDbType, Int64)	Inicjuje nowe wystąpienie SqlMetaData klasy o określonej nazwie kolumny, typie i maksymalnej długości.
SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą kolumny, nazwą bazy danych, właścicielem schematu, nazwy obiektu i serwera domyślnego. 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 właścicielem i nazwą obiektu.
SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą kolumny, typem, typem zdefiniowanym przez użytkownika, typem SQL Server i domyślnym typem 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, Type, String)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą kolumny, typem zdefiniowanym przez użytkownika (UDT) i typem SQL Server.
SqlMetaData(String, SqlDbType, Type)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą kolumny, typem i typem zdefiniowanym przez użytkownika (UDT).
SqlMetaData(String, SqlDbType)	Inicjuje nowe wystąpienie SqlMetaData klasy z określoną nazwą i typem kolumny.

Właściwości

Nazwisko	Opis
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 table-valued jest unikatowa.
LocaleId	Pobiera identyfikator ustawień regionalnych kolumny lub parametru.
Max	Pobiera długość typów danych TEXT, 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ć domyślnej wartości 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

Nazwisko	Opis
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[])	Weryfikuje określoną tablicę Byte wartości względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Char)	Weryfikuje określoną Char wartość względem metadanych i dostosowuje wartość w razie potrzeby.
Adjust(Char[])	Weryfikuje określoną tablicę Char wartości względem metadanych i dostosowuje wartość w razie potrzeby.
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.