Share via


Configurations.Item[Object] Propriété

Définition

Retourne un objet Configuration à partir de la collection.

public:
 property Microsoft::SqlServer::Dts::Runtime::Configuration ^ default[System::Object ^] { Microsoft::SqlServer::Dts::Runtime::Configuration ^ get(System::Object ^ index); };
public Microsoft.SqlServer.Dts.Runtime.Configuration this[object index] { get; }
member this.Item(obj) : Microsoft.SqlServer.Dts.Runtime.Configuration
Default Public ReadOnly Property Item(index As Object) As Configuration

Paramètres

index
Object

Nom, description, ID ou index de l'objet Configuration à retourner.

Valeur de propriété

Objet Configuration.

Exemples

L’exemple de code suivant utilise la méthode pour voir si la Contains syntaxe de l’élément est disponible. Si true, l’exemple de code utilise la syntaxe d’élément pour p.Configurations[0].Name obtenir le nom de la configuration située à la première position de la collection, position d’index 0.

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

namespace Configurations_API  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Package p = new Package();  

            Configuration conf1 = p.Configurations.Add();  
            conf1.ConfigurationString = "Conf1 Configuration String";  
            conf1.ConfigurationType = DTSConfigurationType.EnvVariable;  
            conf1.Description = "Some description for Conf1 configuration";  
            conf1.Name = "Conf1";  
            conf1.PackagePath = "A Variable Name in configuration Conf1";  

            Configuration conf2 = p.Configurations.Add();  
            conf2.ConfigurationString = "Conf2 Configuration String";  
            conf2.ConfigurationType = DTSConfigurationType.ConfigFile;  
            conf2.Description = "Some description for Conf2 configuration";  
            conf2.Name = "Conf2";  
            conf2.PackagePath = "A Variable Name in configuration Conf2";  

            Configuration conf3 = p.Configurations.Add();  
            conf3.ConfigurationString = "Conf3 Configuration String2";  
            conf3.ConfigurationType = DTSConfigurationType.RegEntry;  
            conf3.Description = "Conf3 description for Conf3 configuration2";  
            conf3.Name = "Conf3";  
            conf3.PackagePath = "A Variable Name in configuration Conf3";  

            // Use Contains to see if item syntax is available.  
            Boolean configContains = p.Configurations.Contains("Conf3");  

            if (configContains)  
            {  
                // Use the item syntax of Configurations[x].  
                String myName = p.Configurations[0].Name;  
                Console.WriteLine("Name of configuration at position 0 is {0}", myName);  
            }  
            else  
            {  
                Console.WriteLine("Contains returned {0}", configContains);  
            }  

            Console.WriteLine();  
        }  
    }  
}  
'Error: Converting Methods, Functions and Constructors   
'Error: Converting If-Else-End If Blocks   

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

Namespace Configurations_API  
    Class Program  
        static void Main(string() args)  
        {  
            Dim p As Package =  New Package()   

            Dim conf1 As Configuration = p.Configurations.Add()   
            conf1.ConfigurationString = "Conf1 Configuration String"  
            conf1.ConfigurationType = DTSConfigurationType.EnvVariable  
            conf1.Description = "Some description for Conf1 configuration"  
            conf1.Name = "Conf1"  
            conf1.PackagePath = "A Variable Name in configuration Conf1"  

            Dim conf2 As Configuration =  p.Configurations.Add()   
            conf2.ConfigurationString = "Conf2 Configuration String"  
            conf2.ConfigurationType = DTSConfigurationType.ConfigFile  
            conf2.Description = "Some description for Conf2 configuration"  
            conf2.Name = "Conf2"  
            conf2.PackagePath = "A Variable Name in configuration Conf2"  

            Dim conf3 As Configuration =  p.Configurations.Add()   
            conf3.ConfigurationString = "Conf3 Configuration String2"  
            conf3.ConfigurationType = DTSConfigurationType.RegEnTry  
            conf3.Description = "Conf3 description for Conf3 configuration2"  
            conf3.Name = "Conf3"  
            conf3.PackagePath = "A Variable Name in configuration Conf3"  

            ' Use Contains to see if item syntax is available.  
            Dim configContains As Boolean =  p.Configurations.Contains("Conf3")   

            if (configContains)  
            {  
                ' Use the item syntax of Configurations[x].  
                Dim myName As String = p.Configurations(0).Name   
                Console.WriteLine("Name of configuration at position 0 is {0}", myName)  
            }  
            else  
            {  
                Console.WriteLine("Contains returned {0}", configContains)  
            }  

            Console.WriteLine()  
        }  
    End Class  
End Namespace  

Exemple de sortie :

Nom de la configuration à la position 0 est Conf1

Remarques

Si l’appel à la Contains méthode retourne true, vous pouvez accéder à l’élément spécifié dans la collection à l’aide de la syntaxe Configurations[index]. Toutefois, si la Contains méthode retourne false, cette propriété lève une exception. En C#, cette propriété est l'indexeur correspondant à la classe Configurations.

S’applique à