VariableDispenser.GetQualifiedName(String) Metodo

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

Parametri

Valori restituiti

Il nome qualificato della variabile, che include il nome della variabile e lo spazio nominale a cui appartiene.

Esempio

Il seguente esempio di codice crea una VariableDispenser e aggiunge due variabili di sistema alla lista che è bloccata per la lettura, e una variabile di sistema alla lista che è bloccata per la scrittura. Poi si chiama il GetVariables blocco di tutte e tre le variabili della collezione. Il nome pienamente qualificato della PackageName variabile viene prodotto usando 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  

Output di esempio:

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

Commenti

Questo metodo restituisce il nome completo della variabile, ma non blocca la variabile.

Se il GetQualifiedName metodo viene chiamato usando solo il nome della variabile e non specificando il namespace, il metodo restituisce la prima voce corrispondente.

Se questo metodo restituisce il DTS_E_AMBIGUOUSVARIABLENAME metodo, significa che il riferimento è ambiguo e devi fornire uno spazio dei nomi insieme alla variabile nel variable parametro. Questo errore si verifica quando una variabile con lo stesso nome esiste in spazi di nomi diversi. Specificare il namespace ti permette di individuare la variabile corretta.