Configuration Classe

Définition

Espace de noms:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

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.

Représente une classe de configuration qui contient des informations sur la configuration d’un paquet. Cette classe ne peut pas être héritée.

public ref class Configuration sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject, Microsoft::SqlServer::Dts::Runtime::IDTSName, Microsoft::SqlServer::Dts::Runtime::IDTSPersist

public sealed class Configuration : Microsoft.SqlServer.Dts.Runtime.DtsObject, Microsoft.SqlServer.Dts.Runtime.IDTSName, Microsoft.SqlServer.Dts.Runtime.IDTSPersist

type Configuration = class
    inherit DtsObject
    interface IDTSPersist
    interface IDTSName

Public NotInheritable Class Configuration
Inherits DtsObject
Implements IDTSName, IDTSPersist

Héritage: Object

DtsObject
Configuration

Implémente: IDTSName IDTSPersist

Remarques

Les configurations sont utiles lors du déploiement de paquets sur de nombreux serveurs différents, et facilitent le déplacement des paquets du développement vers l’environnement de production.

Vous pouvez utiliser des variables pour mettre à jour les paquets de manière dynamique, ce qui vous permet de personnaliser la fonctionnalité des paquets et d’adapter les paquets aux environnements dans lesquels ils s’exécutent. Pour mettre à jour les propriétés du package à l’exécution en utilisant des variables, mapper les variables aux propriétés des objets du package, créer des configurations pour les variables, déployer les configurations avec le package, puis mettre à jour les valeurs des variables dans le fichier de configuration pour les adapter au nouvel environnement. À l’exécution, le package utilise automatiquement les valeurs mises à jour. Cette flexibilité est utile lorsque les paquets déployés se connectent à différents serveurs, exécutent différentes instructions SQL ou exécutent différents paquets enfants. Pour plus d’informations, voir Créer des configurations de paquets et utiliser des variables dans les paquets.

Propriétés

Nom	Description
ConfigurationString	Obtient ou définit l’emplacement de la configuration.
ConfigurationType	Obtient ou définit une valeur de la DTSConfigurationType qui décrit le type de fichier dans lequel l’information de configuration est stockée.
CreationName	Retourne la chaîne utilisée par le moteur d’exécution pour créer une instance de l’objet Configuration et ajouter cet objet à la Configurations collection. Cette propriété est en lecture seule.
Description	Obtient ou définit la description de la configuration. Cette propriété est en lecture seule.
ID	Retourne l’ID attribué à la configuration. Cette propriété est en lecture seule.
Name	Gests ou sets le nom donné à cette configuration.
PackagePath	Obtient ou définit le chemin du package auquel la configuration s’applique.

Méthodes

Nom	Description
Equals(Object)	Détermine si deux instances d’objet sont égales. (Hérité de DtsObject)
GetHashCode()	Retourne le code de hachage pour cette instance. (Hérité de DtsObject)
LoadFromXML(XmlNode, IDTSEvents)	Cette méthode n’est pas appelable par votre code d’application. Pour charger un colis enregistré en tant que .xml, utilisez la LoadPackage(String, IDTSEvents) méthode.
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Cette méthode n’est pas appelable par votre code d’application. Pour enregistrer un paquet en tant que .xml, utilisez la SaveToXml(String, Package, IDTSEvents) méthode.

S’applique à