SQLColAttribute
Można użyć SQLColAttribute pobrać atrybut zestaw wyników kolumna dla przygotowanych albo wykonywany instrukcji ODBC.Wywołanie SQLColAttribute na przygotowanych instrukcji powoduje, że obie strony w celu SQL Server. The SQL Server Native klient ODBC driver receives zestaw wyników kolumna data as part of instrukcja execution, so calling SQLColAttribute after the completion of SQLExecute or SQLExecDirect does not involve a server roundtrip.
Uwaga
Nie są dostępne na wszystkich atrybutów identyfikatora kolumna ODBC SQL Server zestawy wyników.
Identyfikator pole |
Description |
|---|---|
SQL_COLUMN_TABLE_NAME |
Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE. |
SQL_DESC_BASE_COLUMN_NAME |
Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE. |
SQL_DESC_BASE_TABLE_NAME |
Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE. |
SQL_DESC_CATALOG_NAME |
Nazwa bazy danych.Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE. |
SQL_DESC_LABEL |
Dostępna dla wszystkich zestawów wyników.Wartość jest taka sama, jak wartość pole SQL_DESC_NAME. To pole ma zerową długość tylko wtedy, gdy kolumna ma być wynikiem wyrażenia i wyrażenie nie zawiera przypisania etykiety. |
SQL_DESC_NAME |
Dostępna dla wszystkich zestawów wyników.Wartość jest taka sama, jak wartość pole SQL_DESC_LABEL. To pole ma zerową długość tylko wtedy, gdy kolumna ma być wynikiem wyrażenia i wyrażenie nie zawiera przypisania etykiety. |
SQL_DESC_SCHEMA_NAME |
Nazwa właściciela.Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE. Opcja dostępna tylko wtedy, gdy nazwa właściciela jest określona dla kolumna w instrukcja SELECT. |
SQL_DESC_TABLE_NAME |
Dostępne zestawy wyników pobierane z instrukcji, które generują kursory serwera lub wykonanych instrukcji SELECT zawierająca klauzulę FOR BROWSE. |
SQL_DESC_UNNAMED |
SQL_NAMED dla wszystkich kolumn w zestaw wyników, chyba że kolumna jest wynik wyrażenie, która nie zawiera przypisania etykietę jako część wyrażenie.Gdy SQL_DESC_UNNAMED zwraca SQL_UNNAMED, wszystkie atrybuty identyfikatora kolumna ODBC zawierają zera ciągi znaków o długości kolumna. |
SQL Server Macierzysty sterownik ODBC klient używa instrukcja zestaw FMTONLY zmniejszyć obciążenie serwera podczas SQLColAttribute jest wywoływana dla gotowe, ale unexecuted instrukcja.
W przypadku typów duża wartość SQLColAttribute będzie zwracać następujące wartości:
Identyfikator pole |
Opis zmiany |
|---|---|
SQL_DESC_DISPLAY_SIZE |
Jest to maksymalna liczba znaków, wymaganych do wyświetlania danych z kolumna.W przypadku kolumn typu dużą wartość wartość zwracana jest SQL_SS_LENGTH_UNLIMITED. |
SQL_DESC_LENGTH |
Zwraca wartość rzeczywistej długości kolumna zestaw wyników.W przypadku kolumn typu dużą wartość wartość zwracana jest SQL_SS_LENGTH_UNLIMITED. |
SQL_DESC_OCTET_LENGTH |
Zwraca maksymalną długość kolumna typu dużą wartość.SQL_SS_LENGTH_UNLIMITED służy do wskazywania nieograniczony rozmiar. |
SQL_DESC_PRECISION |
Zwraca wartość SQL_SS_LENGTH_UNLIMITED dla kolumn typu dużą wartość. |
SQL_DESC_TYPE |
Zwraca SQL_VARCHAR i SQL_WVARCHAR SQL_VARBINARY typów dużych wartości. |
SQL_DESC_TYPE_NAME |
Zwraca "varchar", "varbinarnym", "nvarchar" dla typów dużych wartości. |
Atrybuty kolumna są raportowane dla wszystkich wersji jedynie pierwszego wyniku ustawić, gdy wiele zestawów wyników są generowane przez partia przygotowanych instrukcji SQL.
Następujące atrybuty kolumna są udostępniane przez rozszerzenia SQL Server Macierzysty sterownik ODBC klient. The SQL Server Native klient ODBC driver returns all values in the NumericAttrPtr parameter.Wartości są zwracane w postaci SDWORD (podpisane długi) z wyjątkiem SQL_CA_SS_COMPUTE_BYLIST, która jest wskaźnik na tablicy WORD.
Identyfikator pole |
Wartość zwracana |
|---|---|
SQL_CA_SS_COLUMN_HIDDEN * |
Ma wartość TRUE, jeśli kolumna, do którego odwołuje się jest częścią ukryte klucz podstawowy, utworzonej w celu obsługi instrukcja języka Transact-SQL SELECT z zawierające FOR BROWSE. |
SQL_CA_SS_COLUMN_ID |
Pozycja porządkowa kolumna COMPUTE klauzula wyników w bieżącym instrukcję SELECT języka Transact-SQL. |
SQL_CA_SS_COLUMN_KEY * |
Ma wartość TRUE, jeśli kolumna, do którego odwołuje się jest częścią klucz podstawowy dla wiersza, a instrukcja języka Transact-SQL SELECT zawiera FOR BROWSE. |
SQL_CA_SS_COLUMN_OP |
Liczba całkowita, określająca agregacja operator odpowiedzialny za wartość kolumna klauzula COMPUTE.Definicje wartości całkowitych są sqlncli.h. |
SQL_CA_SS_COLUMN_ORDER |
Pozycja porządkowa kolumna w klauzula ORDER BY instrukcja ODBC lub języka Transact-SQL SELECT. |
SQL_CA_SS_COLUMN_SIZE |
Maksymalna długość w bajtach, wymagane do powiązania pobierania z kolumna do zmiennej SQL_C_BINARY wartości danych. |
SQL_CA_SS_COLUMN_SSTYPE |
Typ macierzysty danych dane przechowywane kolumna programu SQL Server.Definicje wartości typu są sqlncli.h. |
SQL_CA_SS_COLUMN_UTYPE |
podstawowy typ danych typów danych zdefiniowanych przez użytkownika kolumna's programu SQL Server.Definicje wartości typu są sqlncli.h. |
SQL_CA_SS_COLUMN_VARYLEN |
Ma wartość TRUE, jeśli dane mogą być różne długości FAŁSZ inaczej. |
SQL_CA_SS_COMPUTE_BYLIST |
Wskaźnik do tabeli programu WORD (bez znaku krótkiej) określający kolumny używane we frazie BY klauzula COMPUTE.Jeśli klauzula COMPUTE nie określono frazę BY, zwracana jest wskaźnik o wartości NULL. Pierwszy element tablicy zawiera liczbę, BY kolumn listy.Liczebniki porządkowe kolumna są dodatkowe elementy. |
SQL_CA_SS_COMPUTE_ID |
computeid wiersza, która jest wynikiem klauzula COMPUTE w bieżącej instrukcja SELECT języka Transact-SQL. |
SQL_CA_SS_NUM_COMPUTES |
Liczba określona w bieżącej instrukcja SELECT języka Transact-SQL klauzul COMPUTE. |
SQL_CA_SS_NUM_ORDERS |
Liczba kolumn określonych w klauzula ORDER BY instrukcja ODBC lub języka Transact-SQL SELECT. |
* Dostępny, jeśli ustawiono atrybut instrukcja SQL_SOPT_SS_HIDDEN_COLUMNS SQL_HC_ON.
SQL Server 2005 wprowadzony deskryptora specyficzne dla sterownika pola, które zawierają dodatkowe informacje, które odpowiednio oznaczają nazwę kolekcja schematu XML, nazwę schematu i nazwę katalogu.Właściwości te nie wymagają cudzysłowu lub znak anulowania, gdy występują znaki inne niż alfanumeryczne.W poniższej tabela przedstawiono te nowe pola deskryptora:
Nazwa kolumna |
Typ |
Description |
|---|---|---|
SQL_CA_SS_XML_SCHEMACOLLECTION_CATALOG_NAME |
CharacterAttributePtr |
Nazwę katalogu, w którym jest zdefiniowana nazwę kolekcja schematu XML.Jeśli nie można odnaleźć nazwy katalogu, ta zmienna zawiera pusty ciąg. W tym wypadku informacje są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_CATALOG_NAME IRD, które jest pole w trybie do odczytu i zapisu. |
SQL_CA_SS_XML_SCHEMACOLLECTION_SCHEMA_NAM E |
CharacterAttributePtr |
Nazwa schematu zdefiniowano nazwę kolekcja schematu XML.Jeśli nie można odnaleźć nazwy schematu, ta zmienna zawiera pusty ciąg. W tym wypadku informacje są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_SCHEMA_NAME IRD, które jest pole w trybie do odczytu i zapisu. |
SQL_CA_SS_XML_SCHEMACOLLECTION_NAME |
CharacterAttributePtr |
Nazwa zbioru schematu XML.Jeśli nie można odnaleźć nazwy, ta zmienna zawiera pusty ciąg. W tym wypadku informacje są zwracane z pole rekordu SQL_DESC_SS_XML_SCHEMACOLLECTION_NAME IRD, które jest pole w trybie do odczytu i zapisu. |
Ponadto SQL Server 2005 wprowadzono nowe pola deskryptora specyficzne dla sterownika jest zapewnienie dodatkowych informacji dla jednej kolumna typ zdefiniowany przez użytkownika (UDT) zestaw wyników lub parametrów UDT procedur przechowywanych lub sparametryzowanych kwerend. Właściwości te nie wymagają cudzysłowu lub znak anulowania, gdy występują znaki inne niż alfanumeryczne.W poniższej tabela przedstawiono te nowe pola deskryptora:
Nazwa kolumna |
Typ |
Description |
|---|---|---|
SQL_CA_SS_UDT_CATALOG_NAME |
CharacterAttributePtr |
Nazwa katalogu zawierającego UDT. |
SQL_CA_SS_UDT_SCHEMA_NAME |
CharacterAttributePtr |
Nazwa schematu, zawierającą UDT. |
SQL_CA_SS_UDT_TYPE_NAME |
CharacterAttributePtr |
Nazwa UDT. |
SQL_CA_SS_UDT_ASSEMBLY_TYPE_NAME |
CharacterAttributePtr |
Nazwa kwalifikowana wirtualny plik dziennika z UDT. |
Istniejący identyfikator pole deskryptora SQL_DESC_TYPE_NAME służy do wskazywania nazwy UDT.pole SQL_DESC_TYPE dla kolumna typu UDT jest SQL_SS_UDT.
Obsługa SQLColAttribute Data rozszerzony i czas funkcje
Wartości zwracane dla typu Data/Godzina można znaleźć w sekcji "Informacje o zwrot w IRD pola" w Parametr i wynik metadane.
Aby uzyskać więcej informacji zobaczData / czas ulepszenia (ODBC).
Obsługa SQLColAttribute duże UDTs CLR
SQLColAttribute obsługuje dużą CLR typów zdefiniowanych przez użytkownika (UDTs).Aby uzyskać więcej informacji zobaczDuże CLR typy zdefiniowane przez użytkownika (ODBC).
Obsługa SQLColAttribute odstępem kolumny
SQLColAttribute pole nowego deskryptora wiersza implementacji (IRD) kwerendy, SQL_CA_SS_IS_COLUMN_SET, aby określić, czy kolumna jest column_set Kolumna.
Aby uzyskać więcej informacji zobaczObsługa rozrzedzenia kolumny (ODBC).
See Also