DtsEventHandlers.Item Property

DtsEventHandler オブジェクトをコレクションから返します。

名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (microsoft.sqlserver.manageddts.dll 内)

構文

'宣言
Public ReadOnly Default Property Item ( _
    index As Object _
) As DtsEventHandler

public DtsEventHandler this [
    Object index
] { get; }

public:
property DtsEventHandler^ default [Object^] {
    DtsEventHandler^ get (Object^ index);
}

/** @property */
public DtsEventHandler get_Item (Object index)

パラメータ

• index
  コレクションから返される DtsEventHandler オブジェクトの名前、ID、またはインデックスです。

プロパティ値

DtsEventHandler オブジェクトです。

解説

Contains メソッドの呼び出しが true を返す場合、DtsEventHandlers[index] 構文を使用することにより、コレクション内の指定した要素にアクセスできます。Contains メソッドが false を返す場合、このプロパティは例外をスローします。C# の場合、このプロパティは DtsEventHandlers クラスのインデクサとなります。

使用例

次のコード例では、DtsEventHandlers コレクションを取得し、Contains を使用して、項目構文 [x] がコレクションで使用できるかどうかを調べます。

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

namespace Microsoft.SqlServer.SSIS.Samples
{
    class Program
    {
        static void Main(string[] args)
        {
            Package pkg = new Package();

            // Set up a DtsEventHandler for the OnError event of the package.
            DtsEventHandler dtsEHOE = (DtsEventHandler)pkg.EventHandlers.Add("OnError");
            DtsEventHandler dtsEHW = (DtsEventHandler)pkg.EventHandlers.Add("OnWarning");

            // Create the DtsEventHandlers collection.
            DtsEventHandlers dtsEHColls = pkg.EventHandlers;

            // Use the Contains method to see if the item[x] syntax can be used.
            Boolean dtsContains = dtsEHColls.Contains(0);
            Console.WriteLine("Item syntax can be used?  {0}", dtsContains);

            //Using the Item method syntax of [x], obtain the first entry and a name.
            DtsEventHandler dtsEHFirstEntry = dtsEHColls[0];
            String nameOfFirstItem = dtsEHColls[0].Name;

            //Print the name of the log provider object located at position [0].
            Console.WriteLine("The ID of the first event handler is: {0}", dtsEHFirstEntry.ID);
            Console.WriteLine("The Name of the first event handler is: {0}", nameOfFirstItem);
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
 
Namespace Microsoft.SqlServer.SSIS.Samples
    Class Program
        Shared  Sub Main(ByVal args() As String)
            Dim pkg As Package =  New Package() 
 
            ' Set up a DtsEventHandler for the OnError event of the package.
            Dim dtsEHOE As DtsEventHandler = CType(pkg.EventHandlers.Add("OnError"), DtsEventHandler)
            Dim dtsEHW As DtsEventHandler = CType(pkg.EventHandlers.Add("OnWarning"), DtsEventHandler)
 
            ' Create the DtsEventHandlers collection.
            Dim dtsEHColls As DtsEventHandlers =  pkg.EventHandlers 
 
            ' Use the Contains method to see if the item[x] syntax can be used.
            Dim dtsContains As Boolean =  dtsEHColls.Contains(0) 
            Console.WriteLine("Item syntax can be used?  {0}", dtsContains)
 
            'Using the Item method syntax of [x], obtain the first entry and a name.
            Dim dtsEHFirstEnTry As DtsEventHandler =  dtsEHColls(0) 
            Dim nameOfFirstItem As String =  dtsEHColls(0).Name 
 
            'Print the name of the log provider object located at position [0].
            Console.WriteLine("The ID of the first event handler is: {0}", dtsEHFirstEnTry.ID)
            Console.WriteLine("The Name of the first event handler is: {0}", nameOfFirstItem)
        End Sub
    End Class
End Namespace

サンプルの出力 :

Item syntax can be used?True

The ID of the first event handler is: {4B9E438E-BA17-4A51-8235-3072AFF92F99}

The Name of the first event handler is: OnError

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

DtsEventHandlers Class
DtsEventHandlers Members
Microsoft.SqlServer.Dts.Runtime Namespace