DTSConfigurationType Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica as maneiras como a configuração de um pacote pode ser salva.
public enum class DTSConfigurationType
public enum DTSConfigurationType
type DTSConfigurationType =
Public Enum DTSConfigurationType
- Herança
-
DTSConfigurationType
Campos
ConfigFile | 1 | Especifica que a configuração é armazenada em um arquivo de configuração. No Assistente de Configuração de Pacotes do SSIS, a coluna Configuração do Arquivo de Configuração é onde você especifica o local e o nome do arquivo de configuração gerado pelo assistente. |
EnvVariable | 2 | Especifica que a configuração é armazenada em uma variável de ambiente. |
IConfigFile | 5 | Especifica que a configuração é armazenada em uma variável de ambiente que contém as informações sobre o arquivo simples de configuração. |
IIniFile | 10 | Este membro é reservado para uso futuro. |
IniFile | 8 | Este membro é reservado para uso futuro. |
IParentVariable | 4 | Especifica que as informações da configuração são armazenadas em uma variável de ambiente que contém as informações sobre a variável do pacote. |
IRegEntry | 6 | Especifica que as informações da configuração são armazenadas em uma variável de ambiente que contém as informações sobre a entrada do Registro. |
ISqlServer | 9 | Especifica que o local das informações de configuração é armazenado em uma variável de ambiente que contém informações sobre o SQL Server. |
ParentVariable | 0 | Especifica que as informações de configuração são armazenadas em uma variável do pacote. |
RegEntry | 3 | Especifica que as informações da configuração são armazenadas em uma entrada do Registro. |
SqlServer | 7 | Especifica que a configuração é armazenada no banco de dados msdb SQL Server. Este campo é constante. |
Exemplos
O exemplo de código a seguir cria um pacote, habilita as configurações e habilita a exportação do arquivo de configuração. Ele adiciona uma nova Configuration à coleção de pacotes Configurations e define várias propriedades na configuração, incluindo a ConfigurationType, que usa essa enumeração. Depois de salvar e recarregar o pacote, as propriedades de configuração são exibidas.
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
Saída de exemplo:
O valor da variável var = 1
ConfigurationString é conf.xml
ConfigurationType é ConfigFile
CreationName é
Descrição é Minha descrição de configuração
A ID atribuída é {9CF65E37-0833-44CD-A99D-EBFE38FAB31B}
O nome é {9CF65E37-0833-44CD-A99D-EBFE38FAB31B}
O caminho do pacote é \Package.Variables[::var]
Comentários
O Integration Services dá suporte a várias maneiras diferentes de especificar configurações para um pacote. Para obter mais informações, consulte Criar configurações de pacote.