ConnectionManager.Properties Propriedade

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Obtém uma coleção de objetos de propriedade para ConnectionManager. Este é o método de acessar as propriedades da conexão específica que está sendo hospedada pelo gerenciador de conexões. Esta propriedade é somente para leitura.

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

Valor da propriedade

DtsProperties

Uma coleção DtsProperties que contém as propriedades específicas desse tipo de conexão.

Implementações

Properties

Exemplos

O exemplo de código a seguir obtém a Properties coleção do primeiro gerenciador de conexões da Connections coleção usando a sintaxe de índice de [0]. Em seguida, o exemplo grava os nomes das propriedades encontradas na Properties coleção.

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  

Saída de exemplo:

ConnectionString

CreationName

Descrição

ID

InitialCatalog

Nome

Senha

ProtectionLevel

RetainSameConnection

ServerName

Supportsdtctransactions

UserName

Comentários

Todas as classes que herdam de ConnectionManager contêm as mesmas propriedades e métodos. No entanto, cada tipo de conexão tem propriedades adicionais específicas a ele. Quando você obtém um gerenciador de conexões da coleção e itera por meio das propriedades, todas as propriedades que não são encontradas na ConnectionManager classe são propriedades específicas para essa conexão. Para definir uma propriedade exclusiva para a conexão, mas não faz parte da ConnectionManagerpropriedade encontrada RetainSameConnection em várias conexões, use a seguinte linha de código:

ConnectionManager.Properties("RetainSameConnection") = True

Para obter mais informações sobre o tipo de conexões disponíveis, consulte Conexões do SSIS (Integration Services).