DTSConfigurationType Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt an, auf welche Weise eine Konfiguration für ein Paket gespeichert werden kann.
public enum class DTSConfigurationType
public enum DTSConfigurationType
type DTSConfigurationType =
Public Enum DTSConfigurationType
- Vererbung
-
DTSConfigurationType
Felder
ConfigFile | 1 | Gibt an, dass die Konfiguration in einer Konfigurationsdatei gespeichert ist. Im SSIS-Paketkonfigurations-Assistenten geben Sie in der Spalte Konfigurationsdateiname den Speicherort und den Namen der vom Assistenten generierten Konfigurationsdatei an. |
EnvVariable | 2 | Gibt an, dass die Konfiguration in einer Umgebungsvariablen gespeichert ist. |
IConfigFile | 5 | Gibt an, dass die Konfiguration in einer Umgebungsvariablen gespeichert ist, die die Informationen zur Konfigurationsflatfile enthält. |
IIniFile | 10 | Dieses Element ist für die zukünftige Verwendung reserviert. |
IniFile | 8 | Dieses Element ist für die zukünftige Verwendung reserviert. |
IParentVariable | 4 | Gibt an, dass die Konfigurationsinformationen in einer Umgebungsvariablen gespeichert sind, die Informationen zur Paketvariablen enthält. |
IRegEntry | 6 | Gibt an, dass die Konfigurationsinformationen in einer Umgebungsvariablen gespeichert sind, die Informationen zum Registrierungseintrag enthält. |
ISqlServer | 9 | Gibt an, dass der Speicherort der Konfigurationsinformationen in einer Umgebungsvariable gespeichert wird, die Informationen zum SQL Server enthält. |
ParentVariable | 0 | Gibt an, dass die Konfigurationsinformationen in einer Paketvariablen gespeichert sind. |
RegEntry | 3 | Gibt an, dass die Konfigurationsinformationen in einem Registrierungseintrag gespeichert sind. |
SqlServer | 7 | Gibt an, dass die Konfiguration in der SQL Server msdb-Datenbank gespeichert wird. Dieses Feld ist konstant. |
Beispiele
Im folgenden Codebeispiel wird ein Paket erstellt, Konfigurationen aktiviert und der Export der Konfigurationsdatei aktiviert. Sie fügt der Paketauflistung Configurations ein neues Configuration Element hinzu, und legt mehrere Eigenschaften für die Konfiguration fest, einschließlich der ConfigurationType, die diese Enumeration verwendet. Nach dem Speichern und Laden des Pakets werden die Konfigurationseigenschaften angezeigt.
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
Beispielausgabe:
Der Wert der Variablen var = 1
ConfigurationString ist conf.xml
ConfigurationType ist ConfigFile
CreationName ist
Beschreibung ist "Meine Konfigurationsbeschreibung"
Zugewiesene ID ist {9CF65E37-0833-44CD-A99D-EBFE38FAB31B}
Name ist {9CF65E37-0833-44CD-A99D-EBFE38FAB31B}
Paketpfad ist \Package.Variables[::var]
Hinweise
Integration Services unterstützt viele verschiedene Möglichkeiten zum Angeben von Konfigurationen für ein Paket. Weitere Informationen finden Sie unter Erstellen von Paketkonfigurationen.