VariableDispenser.GetQualifiedName(String) Metode

Referensi

Definisi

Ruang nama:: Microsoft.SqlServer.Dts.Runtime

Rakitan:: Microsoft.SqlServer.ManagedDTS.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengembalikan nama variabel yang memenuhi syarat.

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

Parameter

variable: String

Variabel yang namanya sepenuhnya memenuhi syarat yang ingin Anda ketahui.

Mengembalikan

String

Nama variabel yang memenuhi syarat, yang mencakup nama variabel dan namespace layanan miliknya.

Contoh

Contoh kode berikut membuat VariableDispenser dan menambahkan dua variabel sistem ke daftar yang dikunci untuk dibaca, dan satu variabel sistem ke daftar yang dikunci untuk ditulis. Kemudian dipanggil GetVariables untuk mengunci ketiga variabel dalam koleksi. Nama variabel yang PackageName sepenuhnya memenuhi syarat adalah output dengan menggunakan 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

Contoh Output:

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

Keterangan

Metode ini mengembalikan nama lengkap variabel, tetapi tidak mengunci variabel.

Jika metode dipanggil GetQualifiedName hanya dengan menggunakan nama variabel dan tidak menentukan namespace layanan, metode mengembalikan entri pertama yang cocok.

Jika metode ini mengembalikan DTS_E_AMBIGUOUSVARIABLENAME metode , itu berarti bahwa referensinya ambigu, dan Anda harus menyediakan namespace bersama dengan variabel dalam variable parameter . Kesalahan ini terjadi ketika variabel dengan nama yang sama ada di namespace layanan yang berbeda. Menentukan namespace memungkinkan Anda menemukan variabel yang benar.

Berlaku untuk

Bagikan melalui