次の方法で共有


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

関連項目

参照

VariableDispenser クラス

Microsoft.SqlServer.Dts.Runtime 名前空間