DTSConfigurationType Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie de quelle manière la configuration d'un package peut être enregistrée.
public enum class DTSConfigurationType
public enum DTSConfigurationType
type DTSConfigurationType =
Public Enum DTSConfigurationType
- Héritage
-
DTSConfigurationType
Champs
ConfigFile | 1 | Spécifie que la configuration est stockée dans un fichier de configuration. La colonne Nom du fichier de configuration dans l'Assistant Configuration de package SSIS est l'endroit où vous spécifiez l'emplacement et le nom du fichier de configuration généré par l'Assistant. |
EnvVariable | 2 | Spécifie que la configuration est stockée dans une variable d'environnement. |
IConfigFile | 5 | Spécifie que la configuration est stockée dans une variable d'environnement qui contient des informations sur le fichier plat de configuration. |
IIniFile | 10 | Ce membre est réservé pour un usage ultérieur. |
IniFile | 8 | Ce membre est réservé pour un usage ultérieur. |
IParentVariable | 4 | Spécifie que les informations de configuration sont stockées dans une variable d'environnement qui contient des informations sur la variable de package. |
IRegEntry | 6 | Spécifie que les informations de configuration sont stockées dans une variable d'environnement qui contient des informations sur l'entrée de Registre. |
ISqlServer | 9 | Spécifie que l’emplacement des informations de configuration est stocké dans une variable d’environnement qui contient des informations sur le SQL Server. |
ParentVariable | 0 | Spécifie que les informations de configuration sont stockées dans une variable de package. |
RegEntry | 3 | Spécifie que les informations de configuration sont stockées dans une entrée de Registre. |
SqlServer | 7 | Spécifie que la configuration est stockée dans la base de données msdb SQL Server. Ce champ est constant. |
Exemples
L’exemple de code suivant crée un package, active les configurations et active l’exportation du fichier de configuration. Il ajoute un nouveau Configuration à la collection de packages Configurations et définit plusieurs propriétés sur la configuration, y compris le ConfigurationType, qui utilise cette énumération. Après avoir enregistré et rechargé le package, les propriétés de configuration sont affichées.
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
Exemple de sortie :
Valeur de variable var = 1
ConfigurationString est conf.xml
ConfigurationType est ConfigFile
CreationName est
Description : Description de ma configuration
L’ID attribué est {9CF65E37-0833-44CD-A99D-EBFE38FAB31B}
Le nom est {9CF65E37-0833-44CD-A99D-EBFE38FAB31B}
Le chemin d’accès au package est \Package.Variables[::var]
Remarques
Integration Services prend en charge de nombreuses façons différentes de spécifier des configurations pour un package. Pour plus d’informations, consultez Créer des configurations de package.