AddInToken.QualificationData Vlastnost

Definice

Obor názvů:

System.AddIn.Hosting

Sestavení:

System.AddIn.dll

Získá slovník dat o segmentech v kanálu přidruženém k aktuálnímu tokenu.

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))

Hodnota vlastnosti

IDictionary<AddInSegmentType,IDictionary<String,String>>

Slovník, jehož klíče jsou segmenty kanálu a jejichž hodnoty jsou slovníky dvojic názvů a hodnot, které představují data kvalifikace pro každý segment.

Příklady

Následující příklad ukazuje, jak prozkoumat údaje o kvalifikaci doplňku.

// 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

Poznámky

Tato vlastnost slouží k získání dat použitých u segmentů kanálu s atributem QualificationDataAttribute . Tato data můžete použít k identifikaci a práci s typy, které tvoří vaše kanály.

Tato vlastnost vrátí slovník slovníků. Horní slovník má vždy šest klíčů. Každý klíč je AddInSegmentType hodnota pro segment v kanálu. Každá hodnota je obecný IDictionary<TKey,TValue> řetězec s řetězcovými klíči, které obsahují data kvalifikace segmentu.

Klíče a hodnoty těchto vnitřních slovníků jsou názvy a hodnoty zadané v QualificationDataAttribute atributech pro segmenty. Pokud v segmentu nebyla použita žádná data kvalifikace, je jeho slovník prázdný.

Note

Model doplňku nepoužívá data kvalifikace, která se použijí v zobrazení hostitele doplňku. V důsledku toho je slovník AddInSegmentType.HostViewOfAddIn vždy prázdný.

Případně můžete získat údaje o kvalifikaci tak, že vytvoříte výčet, AddInToken jako by šlo o QualificationDataItem kolekci struktur, pomocí foreach příkazu v jazyce C#. Podívejte se na příklad uvedený pro QualificationDataItem strukturu.