SqlMetaData Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает и извлекает метаданные из параметров и столбцов объектов SqlDataRecord. Этот класс не наследуется.
public ref class SqlMetaData sealedpublic sealed class SqlMetaDatatype SqlMetaData = classPublic 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 |
Получает длину типов данных |
| 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. |