SqlMetaData Класс

Ссылка

Определение

Пространство имен:: Microsoft.SqlServer.Server

Сборка:: System.Data.SqlClient.dll

Сборка:: System.Data.dll

Пакет:: System.Data.SqlClient v4.8.5

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public ref class SqlMetaData sealed

public sealed class SqlMetaData

type SqlMetaData = class

Public NotInheritable Class SqlMetaData

Наследование: Object
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.

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