Makale
05/07/2010

SQLColAttribute

Kullanabileceğiniz SQLColAttribute özniteliği bir sonuç almak için küme sütun için hazırlanmış veya çalıştırılmış bir ODBC deyimleri.Arama SQLColAttribute Hazır Deyimler üzerinde için bir gidiş dönüş neden olur.SQL Server. The SQL Server Native istemci ODBC driver receives result küme sütun data as part of deyim execution, so calling SQLColAttribute after the completion of SQLExecute or SQLExecDirect does not involve a server roundtrip.

Not

ODBC sütun tanıtıcısı öznitelikleri tüm kullanılabilir değil SQL Server Sonuç olarak ayarlar.

Alan tanıtıcısı	Açıklama
sql_column_table_name	FOR BROWSE yan tümce içeren yürütülen bir SELECT deyimi veya sunucu imleçler üreten deyimlerinden alınan sonuç kümeleri üzerinde kullanılabilir.
sql_desc_base_column_name	FOR BROWSE yan tümce içeren yürütülen bir SELECT deyimi veya sunucu imleçler üreten deyimlerinden alınan sonuç kümeleri üzerinde kullanılabilir.
sql_desc_base_table_name	FOR BROWSE yan tümce içeren yürütülen bir SELECT deyimi veya sunucu imleçler üreten deyimlerinden alınan sonuç kümeleri üzerinde kullanılabilir.
sql_desc_catalog_name	Veritabanı adı.FOR BROWSE yan tümce içeren yürütülen bir SELECT deyimi veya sunucu imleçler üreten deyimlerinden alınan sonuç kümeleri üzerinde kullanılabilir.
sql_desc_label	Tüm sonuç kümeleri üzerinde kullanılabilir.SQL_DESC_NAME değerine aynı değerdir alan. Alan, yalnızca bir sütun bir ifadenin sonucunu ve ifade bir etiket ataması içeren uzunluğu sıfır olur.
sql_desc_name	Tüm sonuç kümeleri üzerinde kullanılabilir.Değer SQL_DESC_LABEL alanının değeri için aynıdır. Alan, yalnızca bir sütun bir ifadenin sonucunu ve ifade bir etiket ataması içeren uzunluğu sıfır olur.
sql_desc_schema_name	Sahip adı'nı tıklatın.FOR BROWSE yan tümce içeren yürütülen bir SELECT deyimi veya sunucu imleçler üreten deyimlerinden alınan sonuç kümeleri üzerinde kullanılabilir. Yalnızca sahibinin adı SELECT deyimindeki sütun için belirtilmişse kullanılabilir.
sql_desc_table_name	FOR BROWSE yan tümce içeren yürütülen bir SELECT deyimi veya sunucu imleçler üreten deyimlerinden alınan sonuç kümeleri üzerinde kullanılabilir.
sql_desc_unnamed	Tüm sütunların sütun, bir etiket Atama ifadesinin bir parçası olarak içeren ifade sonucunu olmadıkça ayarlamak sonuç SQL_NAMED.Tüm ODBC sütun tanıtıcısı öznitelikleri, SQL_DESC_UNNAMED SQL_UNNAMED döndürdüğünde, sütun için sıfır uzunlukta dizeler içerir.

SQL Server Sunucu yükünü azaltmak için yerel istemci ODBC sürücüsü küme FMTONLY deyim kullanır, SQLColAttribute hazırlıklı ancak unexecuted raporlardan denir.

Büyük bir değer türleri için SQLColAttribute aşağıdaki değerleri döndürür:

Alan tanıtıcısı	Değiştir'in açıklaması
sql_desc_display_size	Verileri görüntülemek için gereken karakter sınırını budur sütun.Büyük bir değer türü sütunlarındaki için döndürülen SQL_SS_LENGTH_UNLIMITED değerdir.
sql_desc_length	Gerçek sütunun uzunluğunu sonucu verir küme.Büyük bir değer türü sütunlarındaki için döndürülen SQL_SS_LENGTH_UNLIMITED değerdir.
sql_desc_octet_length	Bir büyük bir değer türü maksimum uzunluğunu döndürür sütun.SQL_SS_LENGTH_UNLIMITED sınırsız büyüklükte belirtmek için kullanılır.
sql_desc_precision	Büyük bir değer türü sütunlarındaki SQL_SS_LENGTH_UNLIMITED değerini döndürür.
sql_desc_type	Büyük bir değer tipleri için SQL_VARCHAR ve SQL_WVARCHAR SQL_VARBINARY döndürür.
sql_desc_type_name	"Varchar", "varbinary", "nvarchar" için büyük bir değer türlerini döndürür.

Tüm sürümleri için yalnızca ilk sonuç sütunu öznitelikleri raporlanır küme birden çok sonuç küme s oluşturulduğunda bir hazırlanmış SQL deyimleri toplu iş iş işlemi tarafından.

Aşağıdaki sütun özniteliklerini uzantıları tarafından açık olan SQL Server Yerel istemci ODBC sürücüsü. The SQL Server Native istemci ODBC driver returns all values in the NumericAttrPtr parameter.Değerler, WORD bir dizi bir işaretçi SQL_CA_SS_COMPUTE_BYLIST dışında (uzun imzalanmış) SDWORD verilir.

Alan tanıtıcısı	Döndürülen değer
sql_ca_ss_column_hidden *	Başvurulan sütun FOR BROWSE içeren bir Transact-SQL deyim desteklemek için oluşturulan gizli bir birincil anahtarının parçası ise TRUE.
sql_ca_ss_column_id	Geçerli Transact-SQL deyim içinde bir COMPUTE yan tümce sonuç sütun sıralı konumunu.
sql_ca_ss_column_key *	TRUE başvurulan sütun, satır için bir birincil anahtar bir parçasıdır ve FOR BROWSE Transact-SQL deyim içerir.
sql_ca_ss_column_op	Işleç toplamak değeri sorumlu bir COMPUTE yan tümce sütun belirten tamsayı.Tanımları tamsayı değerler sqlncli.h ' dir.
sql_ca_ss_column_order	Bir ODBC veya Transact-SQL deyim 's ORDER BY yan tümce içinde sütun sıra konumu.
sql_ca_ss_column_size	En fazla uzunluğu (bayt cinsinden veri değeri alanından alınan bağlamak için gereken sütun SQL_C_BINARY değişkenine.
sql_ca_ss_column_sstype	SQL Server'da depolanan verilerin yerel veri türü sütun.Türü değerlerinin tanımları sqlncli.h ' dir.
sql_ca_ss_column_utype	SQL Server sütun's kullanıcı tanımlı veri türü temel veri türü.Türü değerlerinin tanımları sqlncli.h ' dir.
sql_ca_ss_column_varylen	TRUE ise, sütunun veri uzunluğu, YANLıŞ yoksa değişebilir.
sql_ca_ss_compute_bylist	Işaretçi bir dizi WORD BY tümceciğini bir COMPUTE yan tümce içinde kullanılan sütunları belirtme (işaretsiz kısa).COMPUTE yan tümce bir BY tümceciğini belirtmezse, bir boş işaretçi döndürülür. Dizinin ilk öğe sayısı listesinde sütun içerir.Sütun sıra sayılarını ek öğelerdir.
sql_ca_ss_compute_id	computeid bir COMPUTE yan tümce, geçerli Transact-SQL SELECT sonucu olan bir satır deyim.
sql_ca_ss_num_computes	Geçerli Transact-SQL SELECT deyiminde belirtilen bir COMPUTE yan tümceleri sayısı.
sql_ca_ss_num_orders	Bir ODBC veya Transact-SQL deyim 's ORDER BY yan tümcesinde belirlenen sütun sayısı.

* Kullanılabilir deyim öznitelik SQL_SOPT_SS_HIDDEN_COLUMNS ise küme SQL_HC_ON için.

SQL Server 2005 sırasıyla, XML şema koleksiyon adı ve şema adı katalog adını belirtmek için ek bilgi sağlamak için sürücüye özgü tanımlayıcısı alanları kullanılmaya başlandı.Bu özellikler, alfasayısal olmayan karakterler içeriyorsa, tırnak işareti veya çıkış karakteri gerektirmez.Aşağıdaki tabloda, bu yeni tanımlayıcısı alanları listeler:

Sütun adı	Tür	Açıklama
sql_ca_ss_xml_schemacollection_catalog_name	CharacterAttributePtr	XML şema koleksiyon adı tanımlandığı kataloğun adı.Katalog adı bulunamıyor, daha sonra bu değişkeni, boş bir dize içerir. Bu bilgiler, bir okuma-yazma alan olan IRD, SQL_DESC_SS_XML_SCHEMACOLLECTION_CATALOG_NAME kayıt alanından döndürülür.
sql_ca_ss_xml_schemacollection_schema_nam e	CharacterAttributePtr	XML şema koleksiyon adı tanımlandığı şema adı.Şema adı bulunamıyor, daha sonra bu değişkeni, boş bir dize içerir. Bu bilgiler, bir okuma-yazma alan olan IRD, SQL_DESC_SS_XML_SCHEMACOLLECTION_SCHEMA_NAME kayıt alanından döndürülür.
sql_ca_ss_xml_schemacollection_name	CharacterAttributePtr	Bir XML şema koleksiyon adı.Sonra adı bulunamazsa, bu değişken, boş bir dize içerir. Bu bilgiler, bir okuma-yazma alan olan IRD, SQL_DESC_SS_XML_SCHEMACOLLECTION_NAME kayıt alanından döndürülür.

sql_ca_ss_xml_schemacollection_catalog_name

CharacterAttributePtr

XML şema koleksiyon adı tanımlandığı kataloğun adı.Katalog adı bulunamıyor, daha sonra bu değişkeni, boş bir dize içerir.

Bu bilgiler, bir okuma-yazma alan olan IRD, SQL_DESC_SS_XML_SCHEMACOLLECTION_CATALOG_NAME kayıt alanından döndürülür.

sql_ca_ss_xml_schemacollection_schema_nam e

CharacterAttributePtr

XML şema koleksiyon adı tanımlandığı şema adı.Şema adı bulunamıyor, daha sonra bu değişkeni, boş bir dize içerir.

Bu bilgiler, bir okuma-yazma alan olan IRD, SQL_DESC_SS_XML_SCHEMACOLLECTION_SCHEMA_NAME kayıt alanından döndürülür.

sql_ca_ss_xml_schemacollection_name

CharacterAttributePtr

Bir XML şema koleksiyon adı.Sonra adı bulunamazsa, bu değişken, boş bir dize içerir.

Bu bilgiler, bir okuma-yazma alan olan IRD, SQL_DESC_SS_XML_SCHEMACOLLECTION_NAME kayıt alanından döndürülür.

Ayrıca, SQL Server 2005 ek bilgi için herhangi bir sonuç kümesi (UDT) kullanıcı tanımlı tür sütun veya saklı yordam veya parametreli hale getirilmiş bir sorguya UDT parametre sağlamak için yeni sürücüye özgü tanımlayıcısı alanları kullanılmaya başlandı. Bu özellikler, alfasayısal olmayan karakterler içeriyorsa, tırnak işareti veya çıkış karakteri gerektirmez.Aşağıdaki tabloda, bu yeni tanımlayıcısı alanları listeler:

Sütun adı	Tür	Açıklama
sql_ca_ss_udt_catalog_name	CharacterAttributePtr	UDT içeren bir katalog adı.
sql_ca_ss_udt_schema_name	CharacterAttributePtr	UDT içeren şemanın adı.
sql_ca_ss_udt_type_name	CharacterAttributePtr	UDT adıdır.
sql_ca_ss_udt_assembly_type_name	CharacterAttributePtr	UDT derleme nitelikli adı.

Varolan tanımlayıcısı alan tanıtıcısı SQL_DESC_TYPE_NAME the UDT adını belirtmek için kullanılır.UDT türü sütun SQL_DESC_TYPE SQL_SS_UDT alanıdır.

Gelişmiş tarih ve saat özellikleri SQLColAttribute desteği

Tarih/saat türleri için döndürülen değerler için "Bilgi döndürdü, IRD alanlar" bölümüne bakın... Parametre ve sonucu meta veriler.

Daha fazla bilgi için bkz:Geliştirmeler'nı (ODBC) tarih/saat.

Büyük bir CLR UDTs SQLColAttribute desteği

SQLColAttribute büyük CLR kullanıcı tanımlı türler (UDTs) destekler.Daha fazla bilgi için bkz:Büyük CLR kullanıcı tanımlı türler (ODBC).