OleDbLiteral Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.