ConnectionManager.Name Propriété

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

[Microsoft.SqlServer.Dts.Runtime.Localization.LocalizablePropertyDescription(typeof(Microsoft.SqlServer.Dts.Runtime.Localized), "NameDesc")]
public string Name { get; set; }

[<Microsoft.SqlServer.Dts.Runtime.Localization.LocalizablePropertyDescription(typeof(Microsoft.SqlServer.Dts.Runtime.Localized), "NameDesc")>]
member this.Name : string with get, set

Public Property Name As String

Valeur de propriété

Une chaîne contenant le nom que vous avez donné à l’objet gestionnaire de connexion lors de sa création.

Implémente

Attributs

LocalizablePropertyDescriptionAttribute

Exemples

L’exemple de code suivant charge un package existant qui possède deux connexions. Il itère à travers les gestionnaires de connexions du package et affiche les valeurs des différentes propriétés, y compris le Namefichier .

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

namespace Connections_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;  
            int connCount = myConns.Count;  
            Console.WriteLine("The number of connections in the package is: {0}", connCount);  

            // Enumerate over the collection, printing out  
            // the values for various properties.  
            foreach (ConnectionManager connMgr in myConns)  
            {  
                Console.WriteLine("ConnectionString:        {0}", connMgr.ConnectionString);  
                Console.WriteLine("CreationName:            {0}", connMgr.CreationName);  
                Console.WriteLine("DelayValidation:         {0}", connMgr.DelayValidation);  
                Console.WriteLine("Description:             {0}", connMgr.Description);  
                Console.WriteLine("HostType:                {0}", connMgr.HostType);  
                Console.WriteLine("ID:                      {0}", connMgr.ID);  
                Console.WriteLine("InnerObject:             {0}", connMgr.InnerObject);  
                Console.WriteLine("Name:                    {0}", connMgr.Name);  
                Console.WriteLine("ProtectionLevel:         {0}", connMgr.ProtectionLevel);  
                Console.WriteLine("SupportsDTCTransactions: {0}", connMgr.SupportsDTCTransactions);  
            }  
            Console.WriteLine("");  
        }  
    }  
}  

Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  

Namespace Connections_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   
            Dim connCount As Integer =  myConns.Count   
            Console.WriteLine("The number of connections in the package is: {0}", connCount)  

            ' Enumerate over the collection, printing out  
            ' the values for various properties.  
            Dim connMgr As ConnectionManager  
            For Each connMgr In myConns  
                Console.WriteLine("ConnectionString:        {0}", connMgr.ConnectionString)  
                Console.WriteLine("CreationName:            {0}", connMgr.CreationName)  
                Console.WriteLine("DelayValidation:         {0}", connMgr.DelayValidation)  
                Console.WriteLine("Description:             {0}", connMgr.Description)  
                Console.WriteLine("HostType:                {0}", connMgr.HostType)  
                Console.WriteLine("ID:                      {0}", connMgr.ID)  
                Console.WriteLine("InnerObject:             {0}", connMgr.InnerObject)  
                Console.WriteLine("Name:                    {0}", connMgr.Name)  
                Console.WriteLine("ProtectionLevel:         {0}", connMgr.ProtectionLevel)  
                Console.WriteLine("SupportsDTCTransactions: {0}", connMgr.SupportsDTCTransactions)  
            Next  

            Console.WriteLine("")  
        End Sub  
    End Class  
End Namespace  

Exemple de sortie :

Le nombre de connexions dans le paquet est : 2

ConnectionString : Data Source=localhost ; Catalogue initial = AdventureWorks ; Provider=SQLOLEDB.1 ; Sécurité intégrée = SSPI ; Persister Informations de sécurité = Faux ; Traduction automatique = Faux ;

CréationNom : OLEDB

Validation du retard : Faux

Description :

HostType : ConnectionManager

ID : {3427BFE1-F10C-4B7E-8E70-E8D9DC7DDBA3}

InnerObject : System.__ComObject

Nom : localhost. AdventureWorks

ProtectionNiveau : EncrypterSensibleAvecUserKey

SupportsDTCTransactions : Vrai

Connexion : C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\results.txt

CréationNom : FLATFILE

Validation du retard : Faux

Description :

HostType : ConnectionManager

ID : {48B66F8D-7DFE-4D85-91C7-0999655484B2}

InnerObject : System.__ComObject

Nom : Résumé de la transaction par Produit1

ProtectionNiveau : EncrypterSensibleAvecUserKey

SupportsDTCTransactions : Faux

Remarques

C’est le nom donné au gestionnaire de connexion lors de sa création, qui peut être modifié ultérieurement. Dans l’interface graphique, le nom apparaît dans l’éditeur Gestionnaire des connexions ou la liste des propriétés sous la forme de propriété Nom. Si un nom n’est pas attribué lors de la création de la connexion, l’exécution attribue le GUID généré pour le IDfichier .