OleDbLiteral Énumération

Définition

Retourne des informations sur les littéraux utilisés dans les commandes de texte, les valeurs de données et les objets de base de données.

public enum class OleDbLiteral
public enum OleDbLiteral
type OleDbLiteral = 
Public Enum OleDbLiteral
Héritage
OleDbLiteral

Champs

Nom Valeur Description
Invalid 0

Valeur non valide. Mappe à DBLITERAL_INVALID.

Binary_Literal 1

Littéral binaire dans une commande de texte. Mappe à DBLITERAL_BINARY_LITERAL.

Catalog_Name 2

Nom du catalogue dans une commande de texte. Mappe à DBLITERAL_CATALOG_NAME.

Catalog_Separator 3

Caractère qui sépare le nom du catalogue du reste de l’identificateur dans une commande de texte. Mappe à DBLITERAL_CATALOG_SEPARATOR.

Char_Literal 4

Littéral de caractère dans une commande de texte. Mappe à DBLITERAL_CHAR_LITERAL.

Column_Alias 5

Alias de colonne dans une commande de texte. Mappe à DBLITERAL_COLUMN_ALIAS.

Column_Name 6

Nom de colonne utilisé dans une commande de texte ou dans une interface de définition de données. Mappe à DBLITERAL_COLUMN_NAME.

Correlation_Name 7

Nom de corrélation (alias de table) dans une commande de texte. Mappe à DBLITERAL_CORRELATION_NAME.

Cursor_Name 8

Nom du curseur dans une commande de texte. Mappe à DBLITERAL_CURSOR_NAME.

Escape_Percent_Prefix 9

Caractère utilisé dans une clause LIKE pour échapper le caractère retourné pour le littéral DBLITERAL_LIKE_PERCENT. Par exemple, si un signe de pourcentage (%) est utilisé pour faire correspondre zéro ou plusieurs caractères et qu’il s’agit d’une barre oblique inverse (\), les caractères « abc\%%» correspondent à toutes les valeurs de caractères qui commencent par « abc%». Certains dialectes SQL prennent en charge une clause (clause ESCAPE) qui peut être utilisée pour remplacer cette valeur. Mappe à DBLITERAL_ESCAPE_PERCENT_PREFIX.

Escape_Underscore_Prefix 10

Caractère utilisé dans une clause LIKE pour échapper le caractère retourné pour le littéral DBLITERAL_LIKE_UNDERSCORE. Par exemple, si un trait de soulignement (_) est utilisé pour faire correspondre exactement un caractère et qu’il s’agit d’une barre oblique inverse (\), les caractères « abc\_ _ » correspondent à toutes les valeurs de caractères qui sont de cinq caractères et commencent par « abc_ ». Certains dialectes SQL prennent en charge une clause (clause ESCAPE) qui peut être utilisée pour remplacer cette valeur. Mappe à DBLITERAL_ESCAPE_UNDERSCORE_PREFIX.

Index_Name 11

Nom d’index utilisé dans une commande de texte ou dans une interface de définition de données. Mappe à DBLITERAL_INDEX_NAME.

Like_Percent 12

Caractère utilisé dans une clause LIKE pour correspondre à zéro ou plusieurs caractères. Par exemple, s’il s’agit d’un signe de pourcentage (%), les caractères « abc%» correspondent à toutes les valeurs de caractères qui commencent par « abc ». Mappe à DBLITERAL_LIKE_PERCENT.

Like_Underscore 13

Caractère utilisé dans une clause LIKE pour correspondre exactement à un caractère. Par exemple, s’il s’agit d’un trait de soulignement (_), les caractères « abc_ » correspondent à toutes les valeurs de caractères longues et commencent par « abc ». Mappe à DBLITERAL_LIKE_UNDERSCORE.

Procedure_Name 14

Nom de procédure dans une commande de texte. Mappe à DBLITERAL_PROCEDURE_NAME.

Quote_Prefix 15

Caractère utilisé dans une commande de texte comme guillemet d’ouverture pour les identificateurs de guillemets qui contiennent des caractères spéciaux. Mappe à DBLITERAL_QUOTE_PREFIX.

Schema_Name 16

Nom de schéma dans une commande de texte. Mappe à DBLITERAL_SCHEMA_NAME.

Table_Name 17

Nom de table utilisé dans une commande de texte ou dans une interface de définition de données. Mappe à DBLITERAL_TABLE_NAME.

Text_Command 18

Commande de texte, telle qu’une instruction SQL. Mappe à DBLITERAL_TEXT_COMMAND.

User_Name 19

Nom d’utilisateur dans une commande de texte. Mappe à DBLITERAL_USER_NAME.

View_Name 20

Nom d’affichage dans une commande de texte. Mappe à DBLITERAL_VIEW_NAME.

Cube_Name 21

Nom d’un cube dans un schéma (ou le catalogue si le fournisseur ne prend pas en charge les schémas).

Dimension_Name 22

Nom de la dimension. Si une dimension fait partie de plusieurs cube, il existe une ligne pour chaque combinaison de cube/dimension.

Hierarchy_Name 23

Nom de la hiérarchie. Si la dimension ne contient pas de hiérarchie ou n’a qu’une seule hiérarchie, la colonne actuelle contient une valeur Null.

Level_Name 24

Nom du cube auquel appartient le niveau actuel.

Member_Name 25

Nom du membre.

Property_Name 26

Nom de la propriété.

Schema_Separator 27

Caractère qui sépare le nom du schéma du reste de l’identificateur dans une commande de texte. Mappe à DBLITERAL_SCHEMA_SEPARATOR.

Quote_Suffix 28

Caractère utilisé dans une commande de texte comme guillemet fermant pour les identificateurs qui contiennent des caractères spéciaux. Les fournisseurs 1.x qui utilisent le même caractère que le préfixe et le suffixe peuvent ne pas retourner cette valeur littérale et peuvent définir le membre de la structure DBLITERAL sur DBLITERAL_INVALID si demandé. Mappe à DBLITERAL_QUOTE_SUFFIX.

Escape_Percent_Suffix 29

Caractère d’échappement, le cas échéant, utilisé pour suffixe le caractère retourné pour le littéral DBLITERAL_LIKE_PERCENT. Par exemple, si un signe de pourcentage (%) est utilisé pour faire correspondre zéro ou plus de caractères et que les signes de pourcentage sont placés entre crochets ouverts et fermés, DBLITERAL_ESCAPE_PERCENT_PREFIX est « [ », DBLITERAL_ESCAPE_PERCENT_SUFFIX est « ] » et les caractères « abc[%]%» correspondent à toutes les valeurs de caractères qui commencent par « abc%». Les fournisseurs qui n’utilisent pas de caractère de suffixe pour échapper au caractère DBLITERAL_ESCAPE_PERCENT ne retournent pas cette valeur littérale et peuvent définir le membre lt de la structure DBLITERAL sur DBLITERAL_INVALID si demandé. Mappe à DBLITERAL_ESCAPE_PERCENT_SUFFIX.

Escape_Underscore_Suffix 30

Caractère utilisé dans une clause LIKE pour échapper le caractère retourné pour le littéral DBLITERAL_LIKE_UNDERSCORE. Par exemple, si un trait de soulignement (_) est utilisé pour faire correspondre exactement un caractère et qu’il s’agit d’une barre oblique inverse (\), les caractères « abc\_ _ » correspondent à toutes les valeurs de caractères qui sont de cinq caractères et commencent par « abc_ ». Certains dialectes SQL prennent en charge une clause (clause ESCAPE) qui peut être utilisée pour remplacer cette valeur. Mappe à DBLITERAL_ESCAPE_UNDERSCORE_SUFFIX.

Remarques

L’énumération OleDbLiteral retourne les catégories suivantes d’informations littérales.

Catégorie Retours
Caractère spécial ou caractères utilisés par des commandes de texte, tels que le caractère utilisé pour citer des identificateurs. Caractère ou caractères.
Valeur de données littérale, telle qu’un littéral de caractère dans une instruction SQL. Longueur maximale du littéral en caractères, liste des caractères qui ne peuvent pas être utilisés dans le littéral et liste des caractères qui ne peuvent pas être utilisés comme premier caractère du littéral.
Nom d’un objet de base de données tel qu’une colonne ou une table. Longueur maximale du nom en caractères, liste des caractères qui ne peuvent pas être utilisés dans le nom et liste des caractères qui ne peuvent pas être utilisés comme premier caractère du nom.
Colonnes de restriction multidimensionnelles. Valeurs de restriction qui retournent des informations sur les cubes, les dimensions, les hiérarchies, les niveaux et les membres disponibles à partir d’une source de données ; et sont traités comme des littéraux au lieu de modèles de recherche.

La plupart des membres de l’énumération OleDbLiteral correspondent à l’une des valeurs OLE DBLITERAL retournées dans la structure DBLITERALINFO.

Les colonnes de restriction multidimensionnelle sont des membres d’objets de schéma et sont mappées à OLE DB pour OLAP utilisée par l’interface IDBSchemaRowset.

A NotSupportedException est généré si les informations littérales spécifiées ne sont pas prises en charge et ne peuvent pas être retournées.

S’applique à