VariableDispenser.GetQualifiedName メソッド
変数の修飾名を返します。
名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (Microsoft.SqlServer.ManagedDTS.dll)
構文
'宣言
Public Function GetQualifiedName ( _
variable As String _
) As String
'使用
Dim instance As VariableDispenser
Dim variable As String
Dim returnValue As String
returnValue = instance.GetQualifiedName(variable)
public string GetQualifiedName(
string variable
)
public:
String^ GetQualifiedName(
String^ variable
)
member GetQualifiedName :
variable:string -> string
public function GetQualifiedName(
variable : String
) : String
パラメーター
- variable
型: System.String
調べる対象となる完全修飾名を持つ変数です。
戻り値
型: System.String
変数の修飾名です。これは、変数名およびこの変数名が属する名前空間で構成されます。
説明
このメソッドは、変数の完全な名前を返しますが、変数をロックしません。
この GetQualifiedName メソッドが名前空間を指定しないで変数の名前のみを使用して呼び出される場合、このメソッドは最初に一致するエントリを返します。
このメソッドが DTS_E_AMBIGUOUSVARIABLENAME メソッドを返した場合は、参照があいまいであることを示し、variable パラメーターで変数と一緒に名前空間を指定する必要があります。 このエラーは、同じ名前の変数が異なる名前空間内に存在する場合に発生します。 名前空間を使用すると、適切な変数を指定できます。
使用例
次のコード例では、VariableDispenser を作成し、読み込み用にロックされる一覧に 2 つのシステム変数を追加し、書き込み用にロックされる一覧に 1 つのシステム変数を追加します。 次に、GetVariables が呼び出され、このコレクション内の 3 つのすべての変数がロックされます。 PackageName 変数の完全修飾名は、GetQualifiedName を使用して出力されます。
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;
namespace Microsoft.SqlServer.SSIS.Sample
{
class Program
{
static void Main(string[] args)
{
Package pkg = new Package();
Variables vars = null;
VariableDispenser variableDispenser = pkg.VariableDispenser;
variableDispenser.LockForRead("System::PackageName");
variableDispenser.LockForRead("System::OfflineMode");
variableDispenser.GetVariables(ref vars);
// Verify that the variable is locked before unlocking.
Console.WriteLine("Variables are locked? {0}", vars.Locked);
foreach (Variable myVar in vars)
{
Console.WriteLine("Name {0}", myVar.Name);
Console.WriteLine("Description {0}", myVar.Description);
Console.WriteLine();
}
// Use Contains to determine whether indexing can be used.
Boolean pkgName = variableDispenser.Contains("PackageName");
String qName = variableDispenser.GetQualifiedName("PackageName");
Console.WriteLine("Contains is valid? {0}", pkgName);
Console.WriteLine("Fully qualified name is: {0}", qName);
vars.Unlock();
Console.WriteLine("Variables are locked? {0}", vars.Locked);
}
}
}
Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
Namespace Microsoft.SqlServer.SSIS.Sample
Class Program
Shared Sub Main(ByVal args() As String)
Dim pkg As Package = New Package()
Dim vars As Variables = Nothing
Dim variableDispenser As VariableDispenser = pkg.VariableDispenser
variableDispenser.LockForRead("System::PackageName")
variableDispenser.LockForRead("System::OfflineMode")
variableDispenser.GetVariables( vars)
' Verify that the variable is locked before unlocking.
Console.WriteLine("Variables are locked? {0}", vars.Locked)
Dim myVar As Variable
For Each myVar In vars
Console.WriteLine("Name {0}", myVar.Name)
Console.WriteLine("Description {0}", myVar.Description)
Console.WriteLine()
Next
' Use Contains to determine whether indexing can be used.
Dim pkgName As Boolean = variableDispenser.Contains("PackageName")
Dim qName As String = variableDispenser.GetQualifiedName("PackageName")
Console.WriteLine("Contains is valid? {0}", pkgName)
Console.WriteLine("Fully qualified name is: {0}", qName)
vars.Unlock()
Console.WriteLine("Variables are locked? {0}", vars.Locked)
End Sub
End Class
End Namespace
サンプル出力:
Variables are locked? True
Name OfflineMode
Description The offline mode currently set for the package
Name PackageName
Description The package name
Contains is valid? True
Fully qualified name is: System::PackageName
Variables are locked? False