次の方法で共有

  • [アーティクル]

ConfigString プロパティ

特定のログ プロバイダーの接続と構成情報を取得します。値の設定も可能です。

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

構文

'宣言
Public Property ConfigString As String
    Get
    Set
'使用
Dim instance As LogProvider
Dim value As String

value = instance.ConfigString

instance.ConfigString = value

public string ConfigString { get; set; }

public:
property String^ ConfigString {
    String^ get ();
    void set (String^ value);
}

member ConfigString : string with get, set

function get ConfigString () : String
function set ConfigString (value : String)

プロパティ値

型: System. . :: . .String
保存または読み込みの対象となる構成の状態を表す String です。

説明

構成文字列には、プロバイダーに固有な接続および構成情報が含まれます。それぞれのプロバイダーには、そのプロバイダーに特有の構成設定があります。これらのプロパティは、ConfigString プロパティを使用して設定します。

次の表に、使用可能なログ プロバイダー、説明、および ConfigString 情報を示します。

プロバイダー

説明

ConfigString プロパティ

SQL Server Profiler

SQL Server Profiler でキャプチャおよび表示される SQL トレースを生成します。このプロバイダーで使用されるファイル名の既定の拡張子は、.trc です。

構成は必要ありません。

SQL Server

イベント ログ エントリを SQL Server データベースの sysssislog テーブルに書き込みます。

SQL Server プロバイダーの場合は、データベースへの接続と対象データベースの名前を指定する必要があります。

テキスト ファイル

イベント ログ エントリをコンマ区切り (CSV) 形式で ASCII テキスト ファイルに書き込みます。このプロバイダーで使用されるファイル名の既定の拡張子は、.log です。

ファイル接続マネージャーの名前です。

Windows イベント ログ

ローカル コンピューター上のアプリケーション ログの標準 Windows イベント ログにログを記録します。

構成は必要ありません。

XML ファイル

イベント ログ エントリを XML 形式ファイルに書き込みます。このプロバイダーの既定のファイル名拡張子は .xml です。

XML 接続マネージャーの名前です。

使用例

次のコード例では、ログ記録が有効になっているパッケージを読み込みます。パッケージを読み込んだ後に、LogProviders コレクションが作成され、コレクション内の各ログ プロバイダーが列挙されて、ConfigString などの各プロパティの値が出力されます。

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

namespace LogProvider_Properties_Test
{
    class Program
    {
        static void Main(string[] args)
        {
            // The package is one of the SSIS samples,
            // modified to log information to the "SSIS
            // log provider for Text files".
            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 LogProviders collection from the package.
            LogProviders logProvs = pkg.LogProviders;
            foreach (LogProvider logProv in logProvs)
            {
                Console.WriteLine("ConfigString:   {0}", logProv.ConfigString);
                Console.WriteLine("CreationName    {0}", logProv.CreationName);
                Console.WriteLine("DelayValidation {0}", logProv.DelayValidation);
                Console.WriteLine("Description     {0}", logProv.Description);
                Console.WriteLine("HostType        {0}", logProv.HostType);
                Console.WriteLine("ID              {0}", logProv.ID);
                Console.WriteLine("InnerObject     {0}", logProv.InnerObject);
                Console.WriteLine("Name            {0}", logProv.Name);
             }
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
Imports Microsoft.SqlServer.Dts.Tasks.DMQueryTask
 
Namespace LogProvider_Properties_Test
    Class Program
        Shared  Sub Main(ByVal args() As String)
            ' The package is one of the SSIS samples,
            ' modified to log information to the "SSIS
            ' log provider for Text files".
            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 LogProviders collection from the package.
            Dim logProvs As LogProviders =  pkg.LogProviders 
            Dim logProv As LogProvider
            For Each logProv In logProvs
                Console.WriteLine("ConfigString:   {0}", logProv.ConfigString)
                Console.WriteLine("CreationName    {0}", logProv.CreationName)
                Console.WriteLine("DelayValidation {0}", logProv.DelayValidation)
                Console.WriteLine("Description     {0}", logProv.Description)
                Console.WriteLine("HostType        {0}", logProv.HostType)
                Console.WriteLine("ID              {0}", logProv.ID)
                Console.WriteLine("InnerObject     {0}", logProv.InnerObject)
                Console.WriteLine("Name            {0}", logProv.Name)
            Next
        End Sub
    End Class
End Namespace

サンプルの出力 :

ConfigString:

CreationName DTS.LogProviderTextFile.2

DelayValidation False

Description Writes log entries for events to a CSV file

HostType LogProvider

ID {1E107E39-DB79-4F02-B8A7-61D88F2DEF63}

InnerObject System.__ComObject

Name SSIS log provider for Text files