Partage via


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

Binary_Literal 1

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

Catalog_Name 2

Nom de catalogue dans une commande de texte. Correspond à DBLITERAL_CATALOG_NAME.

Catalog_Separator 3

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

Char_Literal 4

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

Column_Alias 5

Alias de colonne dans une commande de texte. Correspond à 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. Correspond à DBLITERAL_COLUMN_NAME.

Correlation_Name 7

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

Cube_Name 21

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

Cursor_Name 8

Nom de curseur dans une commande de texte. Correspond à DBLITERAL_CURSOR_NAME.

Dimension_Name 22

Nom de la dimension. Si une dimension appartient à plusieurs cubes, il existe une ligne pour chaque combinaison cube/dimension.

Escape_Percent_Prefix 9

Caractère utilisé dans une clause LIKE pour créer une séquence d'échappement pour 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 (la clause ESCAPE) qui peut être utilisée pour substituer cette valeur. Correspond à DBLITERAL_ESCAPE_PERCENT_PREFIX.

Escape_Percent_Suffix 29

Caractère d'échappement éventuellement utilisé pour ajouter comme suffixe le caractère retourné pour le littéral DBLITERAL_LIKE_PERCENT. Par exemple, si un signe pour cent (%) est utilisé pour désigner zéro ou plusieurs caractères et si ces signes pour cent sont convertis en séquence d'échappement en les mettant entre crochets ouvrants et fermants, DBLITERAL_ESCAPE_PERCENT_PREFIX est « [ », DBLITERAL_ESCAPE_PERCENT_SUFFIX est « ] » et les caractères « abc[%]% » correspondent à toutes les valeurs de caractères commençant par « abc% ». Les fournisseurs qui n'utilisent pas de caractère de suffixe pour créer une séquence d'échappement pour le caractère DBLITERAL_ESCAPE_PERCENT ne retournent pas cette valeur littérale et peuvent éventuellement affecter la valeur DBLITERAL_INVALID au membre lt de la structure DBLITERAL, si cela est demandé. Correspond à DBLITERAL_ESCAPE_PERCENT_SUFFIX.

Escape_Underscore_Prefix 10

Caractère utilisé dans une clause LIKE pour créer une séquence d'échappement pour 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 de cinq caractères et commencent par « abc_ ». Certains dialectes SQL prennent en charge une clause (la clause ESCAPE) qui peut être utilisée pour substituer cette valeur. Correspond à DBLITERAL_ESCAPE_UNDERSCORE_PREFIX.

Escape_Underscore_Suffix 30

Caractère utilisé dans une clause LIKE pour créer une séquence d'échappement pour 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 de cinq caractères et commencent par « abc_ ». Certains dialectes SQL prennent en charge une clause (la clause ESCAPE) qui peut être utilisée pour substituer cette valeur. Correspond à DBLITERAL_ESCAPE_UNDERSCORE_SUFFIX.

Hierarchy_Name 23

Nom de la hiérarchie. Si la dimension ne contient pas de hiérarchie ou n'en possède qu'une seule, la colonne en cours contient une valeur null.

Index_Name 11

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

Invalid 0

Valeur non valide. Correspond à DBLITERAL_INVALID.

Level_Name 24

Nom du cube auquel appartient le niveau actuel.

Like_Percent 12

Caractère utilisé dans une clause LIKE pour correspondre à zéro caractère ou davantage. Par exemple, s'il s'agit d'un signe pour cent (%), les caractères « abc% » correspondent à toutes les valeurs de caractères commençant par « abc ». Correspond à 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 qui sont de quatre caractères et commencent par « abc ». Correspond à DBLITERAL_LIKE_UNDERSCORE.

Member_Name 25

Nom du membre.

Procedure_Name 14

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

Property_Name 26

Nom de la propriété.

Quote_Prefix 15

Caractère utilisé dans une commande de texte en tant que guillemet ouvrant pour les identificateurs qui contiennent des caractères spéciaux. Correspond à DBLITERAL_QUOTE_PREFIX.

Quote_Suffix 28

Caractère utilisé dans une commande de texte en tant que 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 éventuellement affecter la valeur DBLITERAL_INVALID au membre de la structure DBLITERAL, si cela leur est demandé. Correspond à DBLITERAL_QUOTE_SUFFIX.

Schema_Name 16

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

Schema_Separator 27

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

Table_Name 17

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

Text_Command 18

Commande de texte, telle qu'une instruction SQL. Correspond à DBLITERAL_TEXT_COMMAND.

User_Name 19

Nom d'utilisateur dans une commande de texte. Correspond à DBLITERAL_USER_NAME.

View_Name 20

Nom de vue dans une commande de texte. Correspond à DBLITERAL_VIEW_NAME.

Remarques

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

Category Retours
Caractère spécial ou caractères utilisés par les commandes de texte, tels que le caractère utilisé pour citer les 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 multidimensionnelle. 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 sont mappés à l’une des valeurs OLE DB DB DBLITERAL retournées dans la structure DBLITERALINFO.

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

Un 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 à