OleDbLiteral Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает сведения о литералах, используемых в текстовых командах, значениях данных и объектах баз данных.
public enum class OleDbLiteralpublic enum OleDbLiteraltype OleDbLiteral = Public Enum OleDbLiteral- Наследование
Поля
| Binary_Literal | 1 | Двоичный литерал в текстовой команде. Отображается в DBLITERAL_BINARY_LITERAL. |
| Catalog_Name | 2 | Имя каталога в текстовой команде. Отображается в DBLITERAL_CATALOG_NAME. |
| Catalog_Separator | 3 | Знак, отделяющий имя каталога от остальной части идентификатора в текстовой команде. Отображается в DBLITERAL_CATALOG_SEPARATOR. |
| Char_Literal | 4 | Символьный литерал в текстовой команде. Отображается в DBLITERAL_CHAR_LITERAL. |
| Column_Alias | 5 | Псевдоним столбца в текстовой команде. Отображается в DBLITERAL_COLUMN_ALIAS. |
| Column_Name | 6 | Имя столбца, используемое в текстовой команде или в интерфейсе определения данных. Отображается в DBLITERAL_COLUMN_NAME. |
| Correlation_Name | 7 | Имя корреляции (псевдоним таблицы) в текстовой команде. Отображается в DBLITERAL_CORRELATION_NAME. |
| Cube_Name | 21 | Имя куба в составе схемы (или каталога, если поставщик не поддерживает схемы). |
| Cursor_Name | 8 | Имя курсора в текстовой команде. Отображается в DBLITERAL_CURSOR_NAME. |
| Dimension_Name | 22 | Имя размерности. Если данная размерность входит в состав нескольких кубов, здесь указывается одна строка для каждого сочетания "куб-размерность". |
| Escape_Percent_Prefix | 9 | Знак, используемый в выражении LIKE в качестве подстановочного знака для символа, возвращаемого для литерала DBLITERAL_LIKE_PERCENT. Например, если знак процента (%) используется для сопоставления нуля или более символов и это обратная косая черта (\), символы "abc\%" соответствуют всем значениям символов, которые начинаются с "abc%". В некоторых диалектах SQL предусмотрено специальное выражение (ESCAPE-выражение), с помощью которого можно переопределить это значение. Отображается в DBLITERAL_ESCAPE_PERCENT_PREFIX. |
| Escape_Percent_Suffix | 29 | Escape-символ (если есть), используемый в качестве суффикса для символа, возвращаемого для литерала DBLITERAL_LIKE_PERCENT. Например, если знак процента (%) служит для обозначения нескольких символов (возможно, нулевого их числа), а знаки процента вставляются в текст заключенными в квадратные скобки, значение DBLITERAL_ESCAPE_PERCENT_PREFIX равно "[", DBLITERAL_ESCAPE_PERCENT_SUFFIX равно "]", а последовательность знаков "abc[%]%" соответствует всем символьным значениям, начинающимся с "abc%". Поставщики, не использующие суффикс для вставки знака DBLITERAL_ESCAPE_PERCENT, не возвращают значение этого литерала и при запросе могут установить значение элемента lt структуры DBLITERAL равным DBLITERAL_INVALID. Отображается в DBLITERAL_ESCAPE_PERCENT_SUFFIX. |
| Escape_Underscore_Prefix | 10 | Знак, используемый в выражении LIKE в качестве подстановочного знака для символа, возвращаемого для литерала DBLITERAL_LIKE_UNDERSCORE. Например, если символ подчеркивания (_) используется для сопоставления ровно одного символа и является обратной косой чертой (\), символы "abc\_ _" соответствуют всем значениям символов длиной в пять символов и начинаются с "abc_". В некоторых диалектах SQL предусмотрено специальное выражение (ESCAPE-выражение), с помощью которого можно переопределить это значение. Отображается в DBLITERAL_ESCAPE_UNDERSCORE_PREFIX. |
| Escape_Underscore_Suffix | 30 | Знак, используемый в выражении LIKE в качестве подстановочного знака для символа, возвращаемого для литерала DBLITERAL_LIKE_UNDERSCORE. Например, если символ подчеркивания (_) используется для сопоставления ровно одного символа и является обратной косой чертой (\), символы "abc\_ _" соответствуют всем значениям символов длиной в пять символов и начинаются с "abc_". В некоторых диалектах SQL предусмотрено специальное выражение (ESCAPE-выражение), с помощью которого можно переопределить это значение. Отображается в DBLITERAL_ESCAPE_UNDERSCORE_SUFFIX. |
| Hierarchy_Name | 23 | Имя иерархии. Если размерность не содержит иерархий или содержит только одну иерархию, в текущем столбце стоит значение null. |
| Index_Name | 11 | Имя индекса, используемое в текстовой команде или в интерфейсе определения данных. Отображается в DBLITERAL_INDEX_NAME. |
| Invalid | 0 | Недопустимое значение. Отображается в DBLITERAL_INVALID. |
| Level_Name | 24 | Имя куба, к которому относится текущий уровень. |
| Like_Percent | 12 | Знак, используемый в выражении LIKE для соответствия нескольким знакам или отсутствию знаков. Например, если это знак процента (%), то последовательность знаков "abc%" соответствует всем символьным значениям, начинающимся с "abc". Отображается в DBLITERAL_LIKE_PERCENT. |
| Like_Underscore | 13 | Знак, используемый в выражении LIKE для соответствия только одному знаку. Например, если это символ подчеркивания (_), символы "abc_" соответствуют всем значениям символов длиной в четыре символа и начинаются с "abc". Отображается в DBLITERAL_LIKE_UNDERSCORE. |
| Member_Name | 25 | Имя элемента. |
| Procedure_Name | 14 | Имя процедуры в текстовой команде. Отображается в DBLITERAL_PROCEDURE_NAME. |
| Property_Name | 26 | Имя свойства. |
| Quote_Prefix | 15 | Знак, используемый в текстовой команде в качестве открывающей кавычки для заключения в кавычки идентификаторов, содержащих специальные знаки. Отображается в DBLITERAL_QUOTE_PREFIX. |
| Quote_Suffix | 28 | Знак, используемый в текстовой команде в качестве закрывающей кавычки для заключения в кавычки идентификаторов, содержащих специальные знаки. Поставщики 1.x, использующие один и тот же знак в качестве префикса и суффикса, могут не возвращать это значение литерала и при запросе могут установить значение элемента структуры DBLITERAL равным DBLITERAL_INVALID. Отображается в DBLITERAL_QUOTE_SUFFIX. |
| Schema_Name | 16 | Имя схемы в текстовой команде. Отображается в DBLITERAL_SCHEMA_NAME. |
| Schema_Separator | 27 | Знак, отделяющий имя схемы от остальной части идентификатора в текстовой команде. Отображается в DBLITERAL_SCHEMA_SEPARATOR. |
| Table_Name | 17 | Имя таблицы, используемое в текстовой команде или в интерфейсе определения данных. Отображается в DBLITERAL_TABLE_NAME. |
| Text_Command | 18 | Текстовая команда, например оператор SQL. Отображается в DBLITERAL_TEXT_COMMAND. |
| User_Name | 19 | Имя пользователя в текстовой команде. Отображается в DBLITERAL_USER_NAME. |
| View_Name | 20 | Имя представления в текстовой команде. Отображается в DBLITERAL_VIEW_NAME. |
Комментарии
Перечисление OleDbLiteral возвращает следующие категории литеральных сведений.
| Категория | Возвращаемое значение |
|---|---|
| Специальный символ или символы, используемые текстовыми командами, например символ, используемый для кавычек идентификаторов. | Символ или символы. |
| Литеральное значение данных, например символьный литерал в инструкции SQL. | Максимальная длина литерала в символах, список символов, которые не могут использоваться в литерале, и список символов, которые нельзя использовать в качестве первого символа литерала. |
| Имя объекта базы данных, например столбца или таблицы. | Максимальная длина имени в символах, список символов, которые не могут использоваться в имени, и список символов, которые нельзя использовать в качестве первого символа имени. |
| Столбцы многомерных ограничений. | Значения ограничений, возвращающие сведения о кубах, измерениях, иерархиях, уровнях и членах, доступных из источника данных; и обрабатываются как литералы, а не как шаблоны поиска. |
Большинство элементов перечисления OleDbLiteral сопоставляются с одним из значений OLE DB DB, возвращаемых в структуре DBLITERALINFO.
Столбцы многомерных ограничений являются элементами объектов схемы и сопоставляются с OLE DB для OLAP, используемого интерфейсом IDBSchemaRowset.
Создается NotSupportedException , если указанные литеральные сведения не поддерживаются и не могут быть возвращены.
