Configurations.Item[Object] Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.