ScriptTransfer yöntemi
Bu özellik Microsoft SQL Server'ın ilerideki bir sürümünde kaldırılacaktır. Yeni geliştirme işlerinde bu özelliği kullanmaktan kaçının ve bu özelliği kullanmakta olan uygulamalarda değişiklik yapmayı planlayın.
The ScriptTransfer method generates a Transact-SQL command batch that creates database objects contained in the Transfer object indicated.
Sözdizimi
object
.ScriptTransfer(
Transfer
, [ ScriptFileMode ] , [ ScriptFile ] )asString
Bölümleri
nesne
Bir nesneye uygulanan listesinde değerlendirir ifade.Transfer
Transfer veritabanı nesne ve veri kopyalama tanımlayan nesne.ScriptFileMode
İsteğe bağlı.Ayarlarda belirtildiği gibi komut dosyası kullanan kullanan kullanan dosyası varsayılan davranışını geçersiz kılar uzun tamsayı.KomutDosyası
İsteğe bağlı.Bir işletim sistemini belirten bir dize yol veya ek bir hedef olarak dosya oluşturulan Transact-sql için ayarlarda belirtildiği gibi script(s).
Prototip (c/C++)
HRESULT ScriptTransfer(
LPSQLDMOTRANSFER TransferSpec,
SQLDMO_XFRSCRIPTMODE_TYPE ScriptFileMode = SQLDMOXfrFile_Default,
SQLDMO_LPCSTR ScriptFilePath = NULL,
SQLDMO_LPBSTR ScriptText = NULL);
Not
sql Distributed Management Objects (sql-dmo) dizeleri her zaman ole bstr döndürülür.c/C++ uygulama dize bir başvuru alır.Uygulama başvurusu kullanarak serbest bırakmanız gerekir SysFreeString.
Ayarları
Ayar ScriptFileMode bağımsız değişkeni etkiler yorumunu KomutDosyası bağımsız değişkeni.Ayarlarken ScriptFileMode, ayarlama, bu değerleri kullanın KomutDosyası açıklandığı gibi.
Sabit |
Değer |
Açıklama |
---|---|---|
SQLDMOXfrFile_Default |
1 |
SQLDMOXfrFile_SummaryFiles. |
SQLDMOXfrFile_SingleFile |
2 |
Toplu iş komutunu, bir dosyaya yazılır.Dosya adı kullanarak belirtmek KomutDosyası bağımsız değişkeni.Dosya adında yol dahil edilmemesi durumunda, istemci bilgisayar ortam değişkeni temp tarafından belirtilen dizinindeki dosya oluşturulur. |
SQLDMOXfrFile_/SingleFilePerObject |
4 |
Toplu iş komutunu yazılır birden çok dosya için her sql Server bileşeni için bir dosya transfer.Kullanarak bir yol belirtmek KomutDosyası bağımsız değişkeni.Bir yol belirtilmezse, istemci bilgisayar ortam değişkeni temp tarafından belirtilen dizinindeki dosyalar oluşturulur. |
SQLDMOXfrFile_/SingleSummaryFile |
8 |
Toplu iş komutunu, bir dosyaya yazılır.Komutunu toplu iş içeriği nesne türüne göre düzenlenir.Dosya adı kullanarak belirtmek KomutDosyası bağımsız değişkeni.Dosya adında yol dahil edilmemesi durumunda, istemci bilgisayar ortam değişkeni temp tarafından belirtilen dizinindeki dosya oluşturulur. |
SQLDMOXfrFile_/SummaryFiles |
1 |
Toplu iş komutunu yazılır birden çok dosya için her nesne türü için bir dosya transfer.Örneğin, bir dosya için kullanıcı tanımlı veri türleri ve tablolar için ayrı bir dosya oluşturur.Kullanarak bir yol belirtmek KomutDosyası bağımsız değişkeni.Bir yol belirtilmezse, istemci bilgisayar ortam değişkeni temp tarafından belirtilen dizinindeki dosyalar oluşturulur. |
Döndürür
Transact-sql komutu toplu iş iş olarak bir dize.
Açıklamalar
Use the ScriptTransfer method to capture the database object creation statements (schema transfer) specified by a Transferobject.Oluşturulan komutunu toplu iş dosyaları, veritabanı şeması, zamanlanmış bir aktarma gibi başka bir işlemde kullanılabilir.
ScriptTransfer yöntem kullanmak için
Oluşturma bir Transfer nesne.
Nesne kullanarak doldurmak AddObject veya AddObjectByName yöntem.
İsterseniz, küme ScriptType ve Script2Type özellikleri komut içeriğini kontrol için oluşturulan dosyalar toplu iş iş.
Call ScriptTransfer yöntem gösteren Transfer isteğe bağlı olarak oluşturulan, adım 1 ' nesnesi gösteren çıkış konumunu veya bir tek çıktı dosyası.
Not
sql-dmo nesne komut dosyası kullanan yöntemleri örneği sql Server sürüm 7.0 ile tam uyumlu.Ancak, veritabanı uyumluluk düzey Transact-sql komutu toplu iş iş içeriğini etkiler.
komut dosyası kullanan kullanan kullanan dosyası bir veritabanı uyumluluk düzey 7. 0'dan veya tüm nesneleri komut dosyası kullanan kullanan kullanan dosyası kullanan, oluşturulan Transact-sql komutu toplu iş iş yalnızca o düzeye göre ayrılmış anahtar sözcükleri içerir.
Transact-sql komutu sözdizimi ile her zaman bir örnek , sql Server 7.0.Sağlanan yerlerde, bazı sözdizimi örnek sql Server 7. 0'ı kaldırmak için SQLDMOScript2_NoFG gibi isteğe bağlı komut dosyası kullanan kullanan kullanan dosyası değişkenleri kullanabilirsiniz.