Partager via


VariableDispenser.GetQualifiedName(String) Méthode

Définition

Retourne le nom complet de la variable.

public:
 System::String ^ GetQualifiedName(System::String ^ variable);
public string GetQualifiedName (string variable);
member this.GetQualifiedName : string -> string
Public Function GetQualifiedName (variable As String) As String

Paramètres

variable
String

Variable dont vous souhaitez connaître le nom complet.

Retours

Nom complet de la variable, composé du nom de la variable et de l'espace de noms auquel elle appartient.

Exemples

L’exemple de code suivant crée une VariableDispenser variable système et ajoute deux variables système à la liste verrouillée pour la lecture, et une variable système à la liste verrouillée pour l’écriture. Ensuite, il GetVariables est appelé pour verrouiller les trois variables de la collection. Le nom complet de la variable est généré à l’aide PackageNameGetQualifiedNamede .

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  

Exemple de sortie :

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

Remarques

Cette méthode retourne le nom complet de la variable, mais ne verrouille pas la variable.

Si la GetQualifiedName méthode est appelée en utilisant uniquement le nom de la variable et non la spécification de l’espace de noms, la méthode retourne la première entrée correspondante.

Si cette méthode retourne la DTS_E_AMBIGUOUSVARIABLENAME méthode, cela signifie que la référence est ambiguë et que vous devez fournir un espace de noms avec la variable dans le variable paramètre. Cette erreur se produit lorsqu’une variable portant le même nom existe dans différents espaces de noms. La spécification de l’espace de noms vous permet de localiser la variable correcte.

S’applique à