ConnectionManager.Name プロパティ
ConnectionManager オブジェクトの名前を取得します。値の設定も可能です。
名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (Microsoft.SqlServer.ManagedDTS.dll)
構文
'宣言
Public Property Name As String
Get
Set
'使用
Dim instance As ConnectionManager
Dim value As String
value = instance.Name
instance.Name = value
public string Name { get; set; }
public:
virtual property String^ Name {
String^ get () sealed;
void set (String^ value) sealed;
}
abstract Name : string with get, set
override Name : string with get, set
final function get Name () : String
final function set Name (value : String)
プロパティ値
型: System.String
接続マネージャー オブジェクトが作成されたときに指定された名前を表す String です。
実装
説明
これは、接続マネージャーが作成されるときに指定される名前です。後で変更できます。 グラフィカル ユーザー インターフェイスでは、この名前は、[接続マネージャー] エディターまたはプロパティ一覧に [名前] プロパティとして表示されます。 接続が作成されるときに名前が割り当てられない場合は、ID に対して生成された GUID がランタイムによって割り当てられます。
使用例
次のコード例では、2 つの接続を持つ既存のパッケージを読み込みます。 パッケージ内の接続マネージャーを繰り返し処理し、Name など、さまざまなプロパティの値を出力します。
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;
namespace Connections_Collection
{
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 an application and load the sample.
Application app = new Application();
Package pkg = app.LoadPackage(mySample, null);
Connections myConns = pkg.Connections;
int connCount = myConns.Count;
Console.WriteLine("The number of connections in the package is: {0}", connCount);
// Enumerate over the collection, printing out
// the values for various properties.
foreach (ConnectionManager connMgr in myConns)
{
Console.WriteLine("ConnectionString: {0}", connMgr.ConnectionString);
Console.WriteLine("CreationName: {0}", connMgr.CreationName);
Console.WriteLine("DelayValidation: {0}", connMgr.DelayValidation);
Console.WriteLine("Description: {0}", connMgr.Description);
Console.WriteLine("HostType: {0}", connMgr.HostType);
Console.WriteLine("ID: {0}", connMgr.ID);
Console.WriteLine("InnerObject: {0}", connMgr.InnerObject);
Console.WriteLine("Name: {0}", connMgr.Name);
Console.WriteLine("ProtectionLevel: {0}", connMgr.ProtectionLevel);
Console.WriteLine("SupportsDTCTransactions: {0}", connMgr.SupportsDTCTransactions);
}
Console.WriteLine("");
}
}
}
Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
Namespace Connections_Collection
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 an application and load the sample.
Dim app As Application = New Application()
Dim pkg As Package = app.LoadPackage(mySample,Nothing)
Dim myConns As Connections = pkg.Connections
Dim connCount As Integer = myConns.Count
Console.WriteLine("The number of connections in the package is: {0}", connCount)
' Enumerate over the collection, printing out
' the values for various properties.
Dim connMgr As ConnectionManager
For Each connMgr In myConns
Console.WriteLine("ConnectionString: {0}", connMgr.ConnectionString)
Console.WriteLine("CreationName: {0}", connMgr.CreationName)
Console.WriteLine("DelayValidation: {0}", connMgr.DelayValidation)
Console.WriteLine("Description: {0}", connMgr.Description)
Console.WriteLine("HostType: {0}", connMgr.HostType)
Console.WriteLine("ID: {0}", connMgr.ID)
Console.WriteLine("InnerObject: {0}", connMgr.InnerObject)
Console.WriteLine("Name: {0}", connMgr.Name)
Console.WriteLine("ProtectionLevel: {0}", connMgr.ProtectionLevel)
Console.WriteLine("SupportsDTCTransactions: {0}", connMgr.SupportsDTCTransactions)
Next
Console.WriteLine("")
End Sub
End Class
End Namespace
サンプルの出力 :
The number of connections in the package is: 2
ConnectionString: Data Source=localhost;Initial Catalog=AdventureWorks;Provider=SQLOLEDB.1;Integrated Security=SSPI;Persist Security Info=False;Auto Translate=False;
CreationName: OLEDB
DelayValidation: False
Description:
HostType: ConnectionManager
ID: {3427BFE1-F10C-4B7E-8E70-E8D9DC7DDBA3}
InnerObject: System.__ComObject
Name: localhost.AdventureWorks
ProtectionLevel: EncryptSensitiveWithUserKey
SupportsDTCTransactions: true
ConnectionString: C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\results.txt
CreationName: FLATFILE
DelayValidation: False
Description:
HostType: ConnectionManager
ID: {48B66F8D-7DFE-4D85-91C7-0999655484B2}
InnerObject: System.__ComObject
Name: Transaction Summary by Product1
ProtectionLevel: EncryptSensitiveWithUserKey
SupportsDTCTransactions: False