ExtendedProperties.Item[Object] Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.