DTSConfigurationType Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica las maneras de guardar una configuración para un paquete.
public enum class DTSConfigurationType
public enum DTSConfigurationType
type DTSConfigurationType =
Public Enum DTSConfigurationType
- Herencia
-
DTSConfigurationType
Campos
ConfigFile | 1 | Especifica que la configuración se almacena en un archivo de configuración. En el Asistente para la configuración de paquetes SSIS, la columna Nombre del archivo de configuración es donde se especifica la ubicación y el nombre del archivo de configuración que el asistente genera. |
EnvVariable | 2 | Especifica que la configuración se almacena en una variable de entorno. |
IConfigFile | 5 | Especifica que la configuración se almacena en una variable de entorno que contiene la información sobre el archivo plano de configuración. |
IIniFile | 10 | Este miembro se reserva para uso futuro. |
IniFile | 8 | Este miembro se reserva para uso futuro. |
IParentVariable | 4 | Especifica que la información de configuración se almacena en una variable de entorno que contiene la información sobre la variable del paquete. |
IRegEntry | 6 | Especifica que la información de configuración se almacena en una variable de entorno que contiene la información sobre la entrada del Registro. |
ISqlServer | 9 | Especifica que la ubicación de la información de configuración se almacena en una variable de entorno que contiene información sobre el SQL Server . |
ParentVariable | 0 | Especifica que la información de configuración se almacena en una variable de paquete. |
RegEntry | 3 | Especifica que la información de configuración se almacena en una entrada del Registro. |
SqlServer | 7 | Especifica que la configuración se almacena en la base de datos msdb de SQL Server. Este campo es constante. |
Ejemplos
En el ejemplo de código siguiente se crea un paquete, se habilitan las configuraciones y se habilita la exportación del archivo de configuración. Agrega un nuevo Configuration elemento a la colección de paquetes Configurations y establece varias propiedades en la configuración, incluido , ConfigurationTypeque usa esta enumeración. Después de guardar y volver a cargar el paquete, se muestran las propiedades de configuración.
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
Salida del ejemplo:
Valor de variable var = 1
ConfigurationString es conf.xml
ConfigurationType es ConfigFile
CreationName es
Descripción es Mi descripción de configuración
El identificador asignado es {9CF65E37-0833-44CD-A99D-EBFE38FAB31B}
El nombre es {9CF65E37-0833-44CD-A99D-EBFE38FAB31B}
La ruta de acceso del paquete es \Package.Variables[::var]
Comentarios
Integration Services admite muchas maneras diferentes de especificar configuraciones para un paquete. Para obtener más información, vea Crear configuraciones de paquetes.