AddInToken.QualificationData Vlastnost

Reference

Definice

Obor názvů:: System.AddIn.Hosting

Sestavení:: System.AddIn.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 jehož hodnoty jsou slovníky dvojic název/hodnota, které představují kvalifikační data pro každý segment.

Příklady

Následující příklad ukazuje, jak prozkoumat data 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, která byla použita na segmenty 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ý obsahuje kvalifikační data segmentu.

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

Poznámka

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

Data kvalifikace můžete získat také tak, že pomocí příkazu (For Eachv jazyce Visual Basic, for each v jazyce Visual C++) vyčíslíte AddInToken objekt, jako by šlo o kolekci QualificationDataItem strukturforeach. Podívejte se na příklad uvedený pro QualificationDataItem strukturu.

Platí pro

Sdílet prostřednictvím