Поделиться через


SqlMetaData Класс

Определение

Задает и извлекает метаданные из параметров и столбцов объектов SqlDataRecord. Этот класс не наследуется.

public ref class SqlMetaData sealed
public sealed class SqlMetaData
type SqlMetaData = class
Public NotInheritable Class SqlMetaData
Наследование
SqlMetaData

Примеры

В следующем примере показано создание нескольких SqlMetaData объектов , описывающих метаданные столбца записи, и создание SqlDataRecord. Значения столбцов SqlDataRecord объекта задаются, а SqlDataRecord объект отправляется вызывающей программе SqlContext с помощью класса .

[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

Конструкторы

SqlMetaData(String, SqlDbType)

Инициализирует новый экземпляр класса SqlMetaData заданными именем столбца и типом.

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

Инициализирует новый экземпляр класса SqlMetaData с использованием заданных значений имени столбца и сервера по умолчанию. Данная форма конструктора поддерживает параметры с табличными значениями, разрешая указывать признак уникальности столбца в параметре с табличным значением, порядок сортировки для столбца и порядковый номер столбца сортировки.

SqlMetaData(String, SqlDbType, Byte, Byte)

Инициализирует новый экземпляр класса SqlMetaData с указанным именем столбца, типом, точностью и масштабом.

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

Инициализирует новый экземпляр класса SqlMetaData с использованием заданных значений имени столбца, типа, точности, масштаба и сервера по умолчанию. Данная форма конструктора поддерживает параметры с табличными значениями, разрешая указывать признак уникальности столбца в параметре с табличным значением, порядок сортировки для столбца и порядковый номер столбца сортировки.

SqlMetaData(String, SqlDbType, Int64)

Инициализирует новый экземпляр класса SqlMetaData заданными именем столбца, типом и максимальной длиной.

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

Инициализирует новый экземпляр класса SqlMetaData с использованием заданных значений имени столбца, максимальной длины и сервера по умолчанию. Данная форма конструктора поддерживает параметры с табличными значениями, разрешая указывать признак уникальности столбца в параметре с табличным значением, порядок сортировки для столбца и порядковый номер столбца сортировки.

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

Инициализирует новый экземпляр класса SqlMetaData заданным именем столбца, типом, максимальной длиной, точностью, масштабом, кодом языка, параметрами сравнения и пользовательским типом (UDT).

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

Инициализирует новый экземпляр класса SqlMetaData заданным именем столбца, типом, максимальной длиной, точностью, масштабом, кодом языка, параметрами сравнения и пользовательским типом (UDT). Данная форма конструктора поддерживает параметры с табличными значениями, разрешая указывать признак уникальности столбца в параметре с табличным значением, порядок сортировки для столбца и порядковый номер столбца сортировки.

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

Инициализирует новый экземпляр класса SqlMetaData с использованием заданных значений имени столбца, типа, максимальной длины, языка и параметров сравнения.

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

Инициализирует новый экземпляр класса SqlMetaData с использованием заданных значений имени столбца, типа, максимальной длины, языка, параметров сравнения и сервера по умолчанию. Данная форма конструктора поддерживает параметры с табличными значениями, разрешая указывать признак уникальности столбца в параметре с табличным значением, порядок сортировки для столбца и порядковый номер столбца сортировки.

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

Инициализирует новый экземпляр класса SqlMetaData с использованием заданных значений имени столбца, типа, имени базы данных, схемы-владельца и имени объекта.

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

Инициализирует новый экземпляр класса SqlMetaData с использованием заданных значений имени столбца, имени базы данных, схемы-владельца, имени объекта и сервера по умолчанию. Данная форма конструктора поддерживает параметры с табличными значениями, разрешая указывать признак уникальности столбца в параметре с табличным значением, порядок сортировки для столбца и порядковый номер столбца сортировки.

SqlMetaData(String, SqlDbType, Type)

Инициализирует новый экземпляр класса SqlMetaData с заданными именем столбца, типом и пользовательским типом (UDT).

SqlMetaData(String, SqlDbType, Type, String)

Инициализирует новый экземпляр класса SqlMetaData с использованием заданных значений имени столбца, пользовательского типа (UDT) и типа SQLServer.

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

Инициализирует новый экземпляр класса SqlMetaData с использованием заданных значений имени столбца, типа, пользовательского типа, типа SQL Server и сервера по умолчанию. Данная форма конструктора поддерживает параметры с табличными значениями, разрешая указывать признак уникальности столбца в параметре с табличным значением, порядок сортировки для столбца и порядковый номер столбца сортировки.

Свойства

CompareOptions

Получает правила сравнения, используемые для столбца или параметра.

DbType

Получает тип данных столбца или параметра.

IsUniqueKey

Указывает, уникален ли столбец в параметре с табличным значением.

LocaleId

Получает код языка параметра или столбца.

Max

Получает длину типов данных text, ntext и image.

MaxLength

Получает максимальную длину столбца или параметра.

Name

Получает имя столбца или параметра.

Precision

Получает точность значения столбца или параметра.

Scale

Получает масштаб значения столбца или параметра.

SortOrder

Возвращает порядок сортировки для столбца.

SortOrdinal

Возвращает порядковый номер столбца сортировки.

SqlDbType

Получает тип данных столбца или параметра.

Type

Получает тип данных CLR для пользовательского типа.

TypeName

Получает состоящее из трех частей имя пользовательского типа (UDT) или типа SQL Server, представленного экземпляром.

UseServerDefault

Указывает, должен ли данный столбец использовать значение сервера по умолчанию.

XmlSchemaCollectionDatabase

Возвращает имя базы данных, в которой находится коллекция схем для данного экземпляра XML.

XmlSchemaCollectionName

Возвращает имя коллекции схем для данного экземпляра XML.

XmlSchemaCollectionOwningSchema

Получает имя реляционной схемы-владельца, в которой находится коллекция схем для данного экземпляра XML.

Методы

Adjust(Boolean)

Проверяет указанное значение типа Boolean на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Byte)

Проверяет указанное значение типа Byte на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Byte[])

Проверяет указанный массив значений типа Byte на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Char)

Проверяет указанное значение типа Char на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Char[])

Проверяет указанный массив значений типа Char на соответствие метаданным и корректирует его, если это необходимо.

Adjust(DateTime)

Проверяет указанное значение типа DateTime на соответствие метаданным и корректирует его, если это необходимо.

Adjust(DateTimeOffset)

Проверяет указанное значение типа DateTimeOffset на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Decimal)

Проверяет указанное значение типа Decimal на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Double)

Проверяет указанное значение типа Double на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Guid)

Проверяет указанное значение типа Guid на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Int16)

Проверяет указанное значение типа Int16 на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Int32)

Проверяет указанное значение типа Int32 на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Int64)

Проверяет указанное значение типа Int64 на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Object)

Проверяет указанное значение типа Object на соответствие метаданным и корректирует его, если это необходимо.

Adjust(Single)

Проверяет указанное значение типа Single на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlBinary)

Проверяет указанное значение типа SqlBinary на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlBoolean)

Проверяет указанное значение типа SqlBoolean на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlByte)

Проверяет указанное значение типа SqlByte на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlBytes)

Проверяет указанное значение типа SqlBytes на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlChars)

Проверяет указанное значение типа SqlChars на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlDateTime)

Проверяет указанное значение типа SqlDateTime на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlDecimal)

Проверяет указанное значение типа SqlDecimal на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlDouble)

Проверяет указанное значение типа SqlDouble на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlGuid)

Проверяет указанное значение типа SqlGuid на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlInt16)

Проверяет указанное значение типа SqlInt16 на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlInt32)

Проверяет указанное значение типа SqlInt32 на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlInt64)

Проверяет указанное значение типа SqlInt64 на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlMoney)

Проверяет указанное значение типа SqlMoney на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlSingle)

Проверяет указанное значение типа SqlSingle на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlString)

Проверяет указанное значение типа SqlString на соответствие метаданным и корректирует его, если это необходимо.

Adjust(SqlXml)

Проверяет указанное значение типа SqlXml на соответствие метаданным и корректирует его, если это необходимо.

Adjust(String)

Проверяет указанное значение типа String на соответствие метаданным и корректирует его, если это необходимо.

Adjust(TimeSpan)

Проверяет указанное значение типа TimeSpan на соответствие метаданным и корректирует его, если это необходимо.

InferFromValue(Object, String)

Определяет метаданные на основе указанного объекта и возвращает их в виде экземпляра SqlMetaData.

Применяется к