AddInToken.QualificationData Properti

Definisi

Ruang nama:

System.AddIn.Hosting

Rakitan:

System.AddIn.dll

Mendapatkan kamus data tentang segmen dalam alur yang terkait dengan token saat ini.

public:
 property System::Collections::Generic::IDictionary<System::AddIn::Hosting::AddInSegmentType, System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^> ^ QualificationData { System::Collections::Generic::IDictionary<System::AddIn::Hosting::AddInSegmentType, System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^> ^ get(); };

public System.Collections.Generic.IDictionary<System.AddIn.Hosting.AddInSegmentType,System.Collections.Generic.IDictionary<string,string>> QualificationData { get; }

member this.QualificationData : System.Collections.Generic.IDictionary<System.AddIn.Hosting.AddInSegmentType, System.Collections.Generic.IDictionary<string, string>>

Public ReadOnly Property QualificationData As IDictionary(Of AddInSegmentType, IDictionary(Of String, String))

Nilai Properti

IDictionary<AddInSegmentType,IDictionary<String,String>>

Kamus yang kuncinya adalah segmen alur dan yang nilainya adalah kamus pasangan nama/nilai yang mewakili data kualifikasi untuk setiap segmen.

Contoh

Contoh berikut menunjukkan cara memeriksa data kualifikasi add-in.

// Use qualification data to control
// how an add-in should be activated.

if (selectedToken.QualificationData[AddInSegmentType.AddIn]["Isolation"].Equals("NewProcess"))
{
    // Create an external process.
    AddInProcess external = new AddInProcess();

    // Activate an add-in in the new process
    // with the full trust security level.
    Calculator CalcAddIn5 =
        selectedToken.Activate<Calculator>(external,
        AddInSecurityLevel.FullTrust);
    Console.WriteLine("Add-in activated per qualification data.");
}
else
{
    Console.WriteLine("This add-in is not designated to be activated in a new process.");
}

' Use qualification data to control
' how an add-in should be activated.

If selectedToken.QualificationData(AddInSegmentType.AddIn)("Isolation").Equals("NewProcess") Then
    ' Create an external process.
    Dim external As AddInProcess = New AddInProcess

    ' Activate an add-in in an automatically generated
    ' application domain with a full trust security level.
    Dim CalcAddin5 As Calculator = _
        selectedToken.Activate(Of Calculator)(external, _
            AddInSecurityLevel.FullTrust)
    Console.WriteLine("Add-in activated per qualification data.")
Else
    Console.WriteLine("This add-in is not designated to be activated in a new process.")
End If

Keterangan

Gunakan properti ini untuk mendapatkan data yang telah diterapkan ke segmen alur dengan QualificationDataAttribute atribut . Anda dapat menggunakan data ini untuk mengidentifikasi dan bekerja dengan jenis yang menyusun alur Anda.

Properti ini mengembalikan kamus kamus. Kamus teratas selalu memiliki enam kunci. Setiap kunci adalah AddInSegmentType nilai untuk segmen dalam alur. Setiap nilai adalah generik IDictionary<TKey,TValue> string dengan kunci string yang berisi data kualifikasi segmen.

Kunci dan nilai kamus dalam ini adalah nama dan nilai yang ditentukan dalam QualificationDataAttribute atribut untuk segmen. Jika tidak ada data kualifikasi yang diterapkan ke segmen, kamusnya kosong.

Catatan

Model add-in tidak menggunakan data kualifikasi yang diterapkan ke tampilan host add-in. Akibatnya, kamus untuk AddInSegmentType.HostViewOfAddIn selalu kosong.

Atau, Anda dapat memperoleh data kualifikasi dengan menghitung AddInToken seolah-olah itu adalah kumpulan QualificationDataItem struktur, menggunakan foreach pernyataan (For Each di Visual Basic, for each di Visual C++). Lihat contoh yang disediakan untuk QualificationDataItem struktur.