ExtendedProperties.Item[Object] Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un objeto ExtendedProperty de la colección.
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
El nombre, la descripción, el identificador o el índice del objeto ExtendedProperty que se va a devolver.
Valor de propiedad
Un objeto ExtendedProperty de la colección.
Ejemplos
El ejemplo de código siguiente recupera un elemento de la colección mediante dos métodos. El primer método usa la myExtProps[0]
sintaxis para recuperar todo el objeto ubicado en la primera posición de la colección y colocarlo en el myExtProp
objeto . Ahora puede recuperar todas las propiedades del myExtProp
objeto como de costumbre. El segundo método muestra cómo recuperar una propiedad específica, DataType, del primer objeto de la colección.
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
Salida del ejemplo:
El identificador del primer elemento es: {F3B7314E-DB1E-4CCA-A856-2E617A1B3265}
El tipo de datos del primer elemento es: String
Comentarios
Si la llamada al Contains método devuelve true
, puede tener acceso al elemento especificado de la colección mediante la sintaxis ExtendedProperties[index]
. Sin embargo, si el Contains método devuelve false
, esta propiedad produce una excepción. En C#, esta propiedad es el indizador para la clase ExtendedProperties.