DTSConfigurationType Перечисление

Определение

Пространство имен:

Microsoft.SqlServer.Dts.Runtime

Сборка:

Microsoft.SqlServer.ManagedDTS.dll

Указывает способы сохранения конфигурации пакета.

public enum class DTSConfigurationType

public enum DTSConfigurationType

type DTSConfigurationType = 

Public Enum DTSConfigurationType

Наследование

Enum

DTSConfigurationType

Поля

Имя	Значение	Описание
ParentVariable	0	Указывает, что конфигурационная информация хранится в переменной пакета.
ConfigFile	1	Указывает, что конфигурация хранится в конфигурационном файле. В мастере конфигурации пакета SSIS столбец «Имя файла конфигурации» — это место, где вы указываете местоположение и название конфигурационного файла, который генерирует мастер.
EnvVariable	2	Указывает, что конфигурация хранится в переменной среды.
RegEntry	3	Указывает, что конфигурационная информация хранится в записи реестра.
IParentVariable	4	Указывает, что конфигурационная информация хранится в переменной среды, содержащей информацию о переменной пакета.
IConfigFile	5	Задаёт, что конфигурация хранится в переменной среды, содержащей информацию о конфигурационном плоском файле.
IRegEntry	6	Указывает, что конфигурационная информация хранится в переменной среды, содержащей информацию о записи реестра.
SqlServer	7	Указывает, что конфигурация хранится в базе данных msdb SQL Server. Это поле является константой.
IniFile	8	Этот элемент зарезервирован для дальнейшего использования.
ISqlServer	9	Указывает, что местоположение конфигурационной информации хранится в переменной среды, содержащей информацию о SQL Server .
IIniFile	10	Этот элемент зарезервирован для дальнейшего использования.

Примеры

Следующий пример кода создаёт пакет, позволяет настроить и экспортировать конфигурационный файл. Он добавляет новый Configuration элемент в коллекцию пакетов Configurations и задаёт несколько свойств конфигурации, включая ConfigurationType, который использует это перечисление. После сохранения и загрузки пакета отображаются свойства конфигурации.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask;  

namespace configuration_API  
{  
    class Program  
    {      
        static void Main(string[] args)  
        {  
        // Create a package and set two properties.  
            Package pkg = new Package();  
            pkg.EnableConfigurations = true;  
            pkg.ExportConfigurationFile(@"C:\conf.xml");  

            // Create a variable object and add it to the   
            // package Variables collection.  
            Variable varPkg = pkg.Variables.Add("var", false, "", 100);  
            varPkg.Value = 1;  
            string packagePathToVariable = varPkg.GetPackagePath();  

            // Create a configuration object and add it to the   
           // package configuration collection.  
            Configuration config = pkg.Configurations.Add();  

           // Set properties on the configuration object.  
            config.ConfigurationString = "conf.xml";  
            config.Description = "My configuration description";  
            config.ConfigurationType = DTSConfigurationType.ConfigFile;  
            config.PackagePath = packagePathToVariable;  

            // Save the package and its configuration.  
            Application app = new Application();  
            app.SaveToXml(@"c:\pkg.xml", pkg, null);  

            // Reload the package.  
            Package p1 = app.LoadPackage(@"c:\pkg.xml", null);  

            // Review the configuration information.  
            Configurations configs_After = pkg.Configurations;  
            foreach(Configuration confAfter in configs_After)  
            {  
                Console.WriteLine("ConfigurationString is {0}", confAfter.ConfigurationString);  
                Console.WriteLine("ConfigurationType is {0}", confAfter.ConfigurationType);  
                Console.WriteLine("CreationName is {0}", confAfter.CreationName);  
                Console.WriteLine("Description is {0}", confAfter.Description);  
                Console.WriteLine("Assigned ID is {0}", confAfter.ID);  
                Console.WriteLine("Name is {0}", confAfter.Name);  
            }  
        }  
    }  
}  

Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  
Imports Microsoft.SqlServer.Dts.Tasks.BulkInsertTask  

Namespace configuration_API  
    Class Program      
        Shared  Sub Main(ByVal args() As String)  
        ' Create a package and set two properties.  
            Dim pkg As Package =  New Package()   
            pkg.EnableConfigurations = True  
            pkg.ExportConfigurationFile("C:\conf.xml")  

            ' Create a variable object and add it to the   
            ' package Variables collection.  
            Dim varPkg As Variable =  pkg.Variables.Add("var",False,"",100)   
            varPkg.Value = 1  
            Dim packagePathToVariable As String =  varPkg.GetPackagePath()   

            ' Create a configuration object and add it to the   
           ' package configuration collection.  
            Dim config As Configuration =  pkg.Configurations.Add()   

           ' Set properties on the configuration object.  
            config.ConfigurationString = "conf.xml"  
            config.Description = "My configuration description"  
            config.ConfigurationType = DTSConfigurationType.ConfigFile  
            config.PackagePath = packagePathToVariable  

            ' Save the package and its configuration.  
            Dim app As Application =  New Application()   
            app.SaveToXml("c:\pkg.xml", pkg, Nothing)  

            ' Reload the package.  
            Dim p1 As Package =  app.LoadPackage("c:\pkg.xml",Nothing)   

            ' Review the configuration information.  
            Dim configs_After As Configurations =  pkg.Configurations   
            Dim confAfter As Configuration  
            For Each confAfter In configs_After  
                Console.WriteLine("ConfigurationString is {0}", confAfter.ConfigurationString)  
                Console.WriteLine("ConfigurationType is {0}", confAfter.ConfigurationType)  
                Console.WriteLine("CreationName is {0}", confAfter.CreationName)  
                Console.WriteLine("Description is {0}", confAfter.Description)  
                Console.WriteLine("Assigned ID is {0}", confAfter.ID)  
                Console.WriteLine("Name is {0}", confAfter.Name)  
            Next  
        End Sub  
    End Class  
End Namespace  

Пример вывода:

Значение переменной var = 1

ConfigurationString — conf.xml

ConfigurationType — ConfigFile

CreationName —

Описание — это моё описание конфигурации

Назначенный идентификатор: {9CF65E37-0833-44CD-A99D-EBFE38FAB31B}

Имя: {9CF65E37-0833-44CD-A99D-EBFE38FAB31B}

Путь пакета — это \Package.Variables[::var]

Комментарии

Integration Services поддерживает множество различных способов задания конфигураций для пакета. Дополнительные сведения см. в разделе Создание конфигурации пакетов.