Partilhar via


ExtendedProperties.Item[Object] Propriedade

Definição

Obtém um objeto ExtendedProperty da coleção.

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

Parâmetros

index
Object

O nome, a descrição, a ID ou o índice do objeto ExtendedProperty a ser retornado.

Valor da propriedade

Um objeto ExtendedProperty da coleção.

Exemplos

O exemplo de código a seguir recupera um item da coleção usando dois métodos. O primeiro método usa a myExtProps[0] sintaxe para recuperar todo o objeto localizado na primeira posição da coleção e colocá-lo no myExtProp objeto. Agora você pode recuperar todas as propriedades do myExtProp objeto como de costume. O segundo método demonstra como recuperar uma propriedade específica, DataTypedo primeiro objeto da coleção.

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

namespace ExtendedProperties_Testing  
{  
    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 the application, and load the sample.  
            Application app = new Application();  
            Package pkg = app.LoadPackage(mySample, null);  

            // Get the extended properties collection from the package.  
            ExtendedProperties myExtProps = pkg.ExtendedProperties;  

            //Using the Item method syntax of [x], obtain the  
            // entire first entry, and then just the name.  
            ExtendedProperty myExtProp = myExtProps[0];  
            String dataTypeOfFirstItem = myExtProps[0].DataType.ToString();  

            //Print the name of the extended property   
           //located at position [0].  
            Console.WriteLine("The ID of the first item is: {0}", myExtProp.ID);  
            Console.WriteLine("The DataType of the first item is: {0}", dataTypeOfFirstItem);  
            Console.WriteLine();  
        }  
    }  
}  
Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  

Namespace ExtendedProperties_Testing  
    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 the application, and load the sample.  
            Dim app As Application =  New Application()   
            Dim pkg As Package =  app.LoadPackage(mySample,Nothing)   

            ' Get the extended properties collection from the package.  
            Dim myExtProps As ExtendedProperties =  pkg.ExtendedProperties   

            'Using the Item method syntax of [x], obtain the  
            ' entire first entry, and then just the name.  
            Dim myExtProp As ExtendedProperty =  myExtProps(0)   
            Dim dataTypeOfFirstItem As String =  myExtProps(0).DataType.ToString()   

            'Print the name of the extended property   
           'located at position [0].  
            Console.WriteLine("The ID of the first item is: {0}", myExtProp.ID)  
            Console.WriteLine("The DataType of the first item is: {0}", dataTypeOfFirstItem)  
            Console.WriteLine()  
        End Sub  
    End Class  
End Namespace  

Saída de exemplo:

A ID do primeiro item é: {F3B7314E-DB1E-4CCA-A856-2E617A1B3265}

O DataType do primeiro item é: String

Comentários

Se a chamada ao Contains método retornar true, você poderá acessar o elemento especificado na coleção usando a sintaxe ExtendedProperties[index]. No entanto, se o Contains método retornar false, essa propriedade gerará uma exceção. Em C#, essa propriedade é o indexador da classe ExtendedProperties.

Aplica-se a