Freigeben über


ExtendedProperties.Item[Object] Eigenschaft

Definition

Ruft ein ExtendedProperty-Objekt aus der Auflistung ab.

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

Parameter

index
Object

Der Name oder Index bzw. die Beschreibung oder ID des ExtendedProperty-Objekts, das zurückgegeben werden soll.

Eigenschaftswert

Ein ExtendedProperty-Objekt aus der Auflistung.

Beispiele

Im folgenden Codebeispiel wird ein Element aus der Auflistung mit zwei Methoden abgerufen. Die erste Methode verwendet die Syntax, um das myExtProps[0] gesamte Objekt abzurufen, das sich an der ersten Position der Auflistung befindet und ihn im myExtProp Objekt platziert. Sie können jetzt alle Eigenschaften aus dem myExtProp Objekt wie gewohnt abrufen. Die zweite Methode veranschaulicht, wie eine bestimmte Eigenschaft DataType, aus dem ersten Objekt in der Auflistung abgerufen wird.

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  

Beispielausgabe:

Die ID des ersten Elements lautet: {F3B7314E-DB1E-4CCA-A856-2E617A1B3265}

Der DataType des ersten Elements lautet: String

Hinweise

Wenn der Aufruf der Methode zurückgegeben wirdtrue, können Sie mithilfe der Syntax ExtendedProperties[index]auf das angegebene Element in der Contains Auflistung zugreifen. Wenn die Contains Methode jedoch zurückgibt false, löst diese Eigenschaft eine Ausnahme aus. In C# ist diese Eigenschaft der Indexer für die ExtendedProperties-Klasse.

Gilt für: