ConnectionManager.Properties Eigenschaft

Definition

Ruft eine Auflistung von Eigenschaftenobjekten für ConnectionManager ab. Diese Vorgehensweise wird für den Zugriff auf die Eigenschaften der spezifischen Verbindung verwendet, die vom Verbindungs-Manager gehostet wird. Diese Eigenschaft ist schreibgeschützt.

public:
 property Microsoft::SqlServer::Dts::Runtime::DtsProperties ^ Properties { Microsoft::SqlServer::Dts::Runtime::DtsProperties ^ get(); };
public Microsoft.SqlServer.Dts.Runtime.DtsProperties Properties { get; }
member this.Properties : Microsoft.SqlServer.Dts.Runtime.DtsProperties
Public ReadOnly Property Properties As DtsProperties

Eigenschaftswert

Eine DtsProperties-Auflistung, die die für den Verbindungstyp spezifischen Eigenschaften enthält.

Implementiert

Beispiele

Im folgenden Codebeispiel wird die Properties Auflistung aus dem ersten Verbindungs-Manager in der Connections Auflistung mithilfe der Indexsyntax von [0]. Im Beispiel werden dann die Namen der Eigenschaften geschrieben, die in der Properties Auflistung gefunden wurden.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  

namespace ConnMgr_Properties_Collection  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            // The package is one of the SSIS Samples.  
            string mySample = @"C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx";  

            // Create an application and load the sample.  
            Application app = new Application();  
            Package pkg = app.LoadPackage(mySample, null);  
            Connections myConns = pkg.Connections;  

            // Get the Properties collection from the connection  
            // manager and iterate through the properties,   
            // printing the property names.  
            ConnectionManager myConnMgr = myConns[0];  
            DtsProperties connProperties = myConnMgr.Properties;  

            foreach (DtsProperty connProp in connProperties)  
                Console.WriteLine(connProp.Name);  
        }  
    }  
}  
Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  

Namespace ConnMgr_Properties_Collection  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            ' The package is one of the SSIS Samples.  
            Dim mySample As String =  "C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx"   

            ' Create an application and load the sample.  
            Dim app As Application =  New Application()   
            Dim pkg As Package =  app.LoadPackage(mySample,Nothing)   
            Dim myConns As Connections =  pkg.Connections   

            ' Get the Properties collection from the connection  
            ' manager and iterate through the properties,   
            ' printing the property names.  
            Dim myConnMgr As ConnectionManager =  myConns(0)   
            Dim connProperties As DtsProperties =  myConnMgr.Properties   

            Dim connProp As DtsProperty  
            For Each connProp In connProperties  
                Console.WriteLine(connProp.Name)  
            Next  
        End Sub  
    End Class  
End Namespace  

Beispielausgabe:

ConnectionString

CreationName

Beschreibung

id

InitialCatalog

Name

Kennwort

ProtectionLevel

RetainSameConnection

ServerName

SupportsDTCTransactions

UserName

Hinweise

Alle Klassen, die von ConnectionManager erben, enthalten die gleichen Eigenschaften und Methoden. Die einzelnen Verbindungstypen verfügen jedoch über zusätzliche Eigenschaften, die spezifisch für den jeweiligen Verbindungstyp sind. Wenn Sie einen Verbindungs-Manager aus der Auflistung abrufen und die Eigenschaften durchlaufen, sind alle Eigenschaften, die nicht in der ConnectionManager Klasse gefunden werden, Eigenschaften, die für diese Verbindung spezifisch sind. Um eine Eigenschaft festzulegen, die für die Verbindung eindeutig ist, aber nicht Teil ConnectionManagerder Eigenschaft, die RetainSameConnection auf mehreren Verbindungen gefunden wurde, verwenden Sie die folgende Codezeile:

ConnectionManager.Properties("RetainSameConnection") = True

Weitere Informationen zum verfügbaren Verbindungstyp finden Sie unter Integration Services (SSIS)-Verbindungen.

Gilt für: