Kullanıcı tanımlı türler kullanma

SQL Server 2005kullanıcı tanımlı türler (UDTs) tanıttı. UDTs genişletmek sql türü sistemi nesneler ve özel veri yapılarını tanıyarak bir SQL Serververitabanı. UDTs birden çok veri türlerini içerebilir ve davranışlar, bunları tek bir oluşan geleneksel diğer veri türlerinden ayırt olabilir SQL Serversistem veri türü. UDTs herhangi biri tarafından desteklenen tüm dilleri kullanılarak tanımlanır.Doğrulanabilir kod üreten net ortak dil çalışma zamanı (clr). Bu içeren Microsoft Visual C#® ve Visual Basic® .NET. Veri alanları ve özellikleri maruz bir.net sınıf veya yapı ve davranış yöntemleri sınıf veya yapı tarafından tanımlanır.

udt sütun tanımı tablonun, bir değişken olarak kullanılabilir bir Transact-SQLtoplu, ya da bir bağımsız değişken olarak bir Transact-SQLişlev veya saklı yordam. UDTs hakkında daha fazla bilgi için bkz: Working with CLR User-defined Types.

SQL Server Native Client OLE DB Sağlayıcısı

SQL ServerYerel istemci ole db sağlayıcısı destekler gibi ikili türleri ile UDTs nesneleri yönetmenizi sağlar meta veri bilgileri UDTs. udt sütunlar dbtype_udt maruz ve onların metaveri çekirdek ole db arabirim üzerinden IColumnRowsetve yeni ISSCommandWithParameters arabirimi.

[!NOT]

IRowsetFind::FindNextRow yöntemi udt veri türü ile çalışmaz. db_e_badcompareop döndürülen udt bir arama sütunu türü olarak kullanılır.

Veri bağlamaları ve Coercions

Aşağıdaki tablo bağlama ve zorlama kullanarak listelenen veri türleri ile oluşan açıklar bir SQL Serverudt. udt sütunlar üzerinden maruz SQL Serveryerel istemci ole db sağlayıcısı olarak dbtype_udt. Kendi tanımlı türleri olarak nesneleri yönetebilirsiniz uygun şema satır kümeleri meta veri alabilirsiniz.

1dbtype_udt ile belirtilenden başka bir sunucu yazarsanız, ICommandWithParameters::SetParameterInfo ve erişimcisi türü dbtype_udt, deyimi yürütüldüğünde bir hata oluşur (db_e_errorsoccurred; parametre dbstatus_e_badaccessor durumudur). Aksi takdirde veriler sunucuya gönderilir, ancak sunucu udt parametre veri türü için hiçbir örtük dönüştürme olduğunu belirten bir hata iletisi döndürür.

2Bu konunun kapsamı dışındadır.

3 Onaltılık dize ikili veri veri dönüştürme oluşur.

4 İkili veri hex dizesi veri dönüştürme oluşur.

5Doğrulama oluşabilir erişeni zaman oluşturmak veya getirme anda db_e_errorsoccurred, durumu DBBINDSTATUS_UNSUPPORTEDCONVERSION için ayarlanmış bağlama hatadır.

6by_ref-var olmak kullanılmış.

dbtype_null ve dbtype_empty giriş parametreleri için çıkış parametreleri veya sonuçları ancak bağlanabilir. Giriş parametreleri için bağlandığında, durum DBSTATUS_S_ISNULL veya dbstatus_s_default olarak ayarlanmalıdır.

dbtype_udt dbtype_empty ve dbtype_null da dönüştürülebilir, ancak dbtype_null ve dbtype_empty dbtype_udt için dönüştürülemiyor. Bu dbtype_bytes ile tutarlıdır.

[!NOT]

Yeni arabirimi UDTs ile ilgili parametreleri olarak kullanılan ISSCommandWithParameters, hangi miras alır ICommandWithParameters. Uygulamalar bu arabirimin en az ssprop_param_udt_name udt parametreleri için dbpropset_sqlserverparameter özellik ayarlamak için kullanmanız gerekir. Eğer bu yapılmazsa, ICommand::Execute db_e_errorsoccurred dönecektir. Bu arabirimi ve özellik kümesi bu konunun ilerisinde açıklanmıştır.

Eğer bir kullanıcı tanımlı türü tüm verileri tutabilecek kadar büyük olmayan bir sütuna eklenen ICommand::Execute db_e_errorsoccurred durumuyla s_ok döndürür.

ole db Çekirdek Hizmetleri tarafından sağlanan veri dönüşümleri (IDataConvert) dbtype_udt için geçerli değildir. Diğer bir bağlama desteklenmez.

ole db satır kümesi eklemeler ve değişiklikler

SQL ServerYerel istemci yeni değerler ekler veya birçok çekirdek ole db şema satır kümeleri değiştirir.

procedure_parameters şeması satır kümesi

Aşağıdaki eklemeler procedure_parameters şema satır kümesi için yapılmıştır.

SQL_ASSEMBLIES şeması satır kümesi

SQL ServerYerel istemci ole db sağlayıcısı sunar tescilli UDTs açıklayan yeni bir sağlayıcı belirli şema satırkümesi. Derleme sunucusu, dbtype_wstr belirtilebilir ancak kümesi içinde mevcut değil. Belirtilmezse, satır kümesi geçerli sunucu için varsayılan olacaktır. SQL_ASSEMBLIES şeması satır kümesi aşağıdaki tabloda tanımlanır.

SQL_ASSEMBLIES_ bağımlılıklar şeması satır kümesi

SQL ServerYerel istemci ole db sağlayıcısı için belirli bir sunucunun derleme bağımlılıkları tanımlayan yeni bir sağlayıcıya özel şema satır kümesi sunar. assembly_server olarak bir dbtype_wstr arayan tarafından belirtilmiş olabilir ama kümesi içinde mevcut değildir. Belirtilmezse, satır kümesi geçerli sunucu için varsayılan olacaktır. SQL_ASSEMBLY_DEPENDENCIES şeması satır kümesi aşağıdaki tabloda tanımlanır.

sql_user_types şeması satır kümesi

SQL ServerYerel istemci ole db sağlayıcısı sunar yeni şema satır kümesi, sql_user_types, ne zaman açıklayan kayıtlı UDTs için belirtilen sunucu ekledi. udt_server dbtype_wstr çağıran tarafından belirtilmesi gerekir ama kümesi içinde mevcut değildir. sql_user_types şeması satır kümesi aşağıdaki tabloda tanımlanır.

SÜTUNSAY şema satır kümesi

SÜTUNSAY şema satır kümesi eklemeler aşağıdaki sütunları içerir.

ole db özellik eklemeleri ve değişiklikler ayarlayın

SQL ServerYerel istemci yeni değerler ekler veya birçok çekirdek ole db özellik kümeleri değiştirir.

dbpropset_sqlserverparameter özellik kümesi

ole db üzerinden UDTs desteklemek için SQL Serveryerel istemci için aşağıdaki değerleri içeren yeni dbpropset_sqlserverparameter özellik kümesi uygular.

ssprop_param_udt_name zorunludur. ssprop_param_udt_catalogname ve ssprop_param_udt_schemaname isteğe bağlıdır. Özellikleri yanlış belirtilmezse, DB_E_ERRORSINCOMMAND döndürülür. Hem ssprop_param_udt_catalogname hem de ssprop_param_udt_schemaname belirtilmezse, sonra udt aynı veritabanı ve şema tablo olarak tanımlanmalıdır. udt tanım tablo olarak aynı şema değil (ancak aynı veritabanında), sonra ssprop_param_udt_schemaname belirtilmelidir. udt tanım farklı bir veritabanında ise, o zaman hem ssprop_param_udt_catalogname hem de ssprop_param_udt_schemaname belirtilmelidir.

dbpropset_sqlservercolumn özellik kümesi

Tabloların oluşturulmasını desteklemek için oluşturma ITableDefinition arabirimi, SQL Serveryerel istemci dbpropset_sqlservercolumn özellik kümesi aşağıdaki üç yeni sütun ekler.

[!NOT]

UDTs PROVIDER_TYPES şema satır kümesi içinde görünür. Tüm sütunlar, okuma ve yazma erişimi.

ado, Açıklama sütununda karşılık gelen bir giriş kullanarak bu özellikleri için başvuruda bulunacak.

ssprop_col_udtname zorunludur. ssprop_col_udt_catalogname ve ssprop_col_udt_schemaname isteğe bağlıdır. Özellikleri yanlış belirtilmezse, DB_E_ERRORSINCOMMANDdöndürdü.

Ne ssprop_col_udt_catalogname, ne de ssprop_col_udt_schemaname belirtilirse, udt aynı veritabanı ve şema tablo olarak tanımlanmalıdır.

udt tanım tablo olarak aynı şema değil (ancak aynı veritabanında), ssprop_col_udt_schemaname belirtilmelidir.

udt tanım farklı bir veritabanında ise, ssprop_col_udt_catalogname ve ssprop_col_udt_schemaname belirtilmelidir.

ole db arabirim eklemeleri ve değişiklikler

SQL ServerYerel istemci yeni değerler ekler veya birçok arabirimleri ole db Çekirdek değiştirir.

ISSCommandWithParameters arabirimi

ole db üzerinden UDTs desteklemek için SQL Serveryerel istemci uygular dahil ek değişiklikler bir dizi ISSCommandWithParameters arabirimi. Bu yeni arabirimi çekirdek ole db arabirim devralan ICommandWithParameters. Üç yöntem devralınan ek olarak ICommandWithParameters; GetParameterInfo, MapParameterNames, ve SetParameterInfo; ISSCommandWithParameters sağlayan GetParameterProperties ve SetParameterProperties sunucusu belirli veri türlerini işlemesi için kullanılan yöntem.

[!NOT]

ISSCommandWithParameters arabirimi de yapar yeni ssparamprops kullanan yapısı.

IColumnsRowset arabirimi

Ek olarak ISSCommandWithParameters arabirimi, SQL Serveryerel istemci de arama dan döndürülen satır kümesi için yeni değerler ekler IColumnsRowset::GetColumnRowset yöntemi aşağıdaki gibi.

dbcolumn_type yukarıda belirtilen eklenen udt meta bakarak dbtype_udt için ayarlandığında sunucu udt sütun diğer ikili türlerinden ayırt edebilirsiniz. Bu verilerin kısmen tam sunucu türü udt ise. Non-udt sunucu türleri için bu sütunlar her zaman null döndürülür.

SQL Server yerel istemci odbc sürücüsü

İçinde bazı değişiklikler yapılmış SQL ServerUDTs desteklemek için yerel istemci odbc sürücüsü. SQL ServerYerel istemci odbc sürücüsü eşlemelerini SQL Serverudt sql_ss_udt sürücüye özgü sql veri tanımlayıcı yazın. udt sütunlar sql_ss_udt çıkmış. Sizin udt sütun açıkça başka bir türe bir sql deyimi kullanarak eşleştirirseniz ToString ya ToXMLString yöntemleri UDT veya üzerinden cast ve convert işlevi, sonuç kümesinde sütun türünü yansıtan gerçek türü sütun için dönüştürüldü

SQLColAttribute, SQLDescribeParam, SQLGetDescField

Ek bilgi için ya da sonuç kümesinin udt sütun veya udt parametresi üzerinden alınacak saklı yordam/parametreli sorgu sağlamak için dört yeni sürücüye özgü tanımlayıcısı alanları eklenmiştir SQLColAttribute, SQLDescribeParam, ve SQLGetDescField fonksiyonlar.

Eklenen dört yeni tanımlayıcısı alanları, sql_ca_ss_udt_catalog_name, sql_ca_ss_udt_schema_name, sql_ca_ss_udt_type_name ve sql_ca_ss_udt_assembly_type_name vardır.

SQLColumns SQLProcedureColumns

Ayrıca üç yeni sürücüyü belirli sütunları sonuç kümesini dan dönen eklenir SQLColumns ve SQLProcedureColumns bir udt sonuç ya da ilgili ek bilgi sağlamak için işlevler kümesi sütun veya udt parametre. Bu üç yeni sütun, ss_udt_catalog_name, ss_udt_schema_name ve ss_udt_assembly_type_name vardır.

Desteklenen dönüştürmeleri

c veri türleri için sql dönüştürürken sql_c_wchar, SQL_C_BINARY ve sql_c_char tüm sql_ss_udt için dönüştürülebilir. Ancak, ikili veri sql_c_wchar ve sql_c_char sql veri türleri dönüştürürken bir onaltılık dize dönüştürülür unutmayın.

c sql veri türleri dönüştürürken sql_c_wchar, SQL_C_BINARY ve sql_c_char tüm sql_ss_udt için dönüştürülebilir. Ancak ikili veri sql_c_wchar ve sql_c_char sql veri türleri dönüştürürken bir onaltılık dize dönüştürülür unutmayın.

Ayrıca bkz.

Başvuru

ISSCommandWithParameters (ole db)

Diğer Kaynaklar

SQL Server yerel istemci özellikleri