AddInToken.QualificationData Propriété

Définition

Espace de noms:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Obtient un dictionnaire de données relatif aux segments dans le pipeline associé au jeton actuel.

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

Valeur de propriété

IDictionary<AddInSegmentType,IDictionary<String,String>>

Dictionnaire dont les clés correspondent aux segments de pipeline et dont les valeurs sont des dictionnaires contenant des paires nom/valeur représentant les données de qualification de chaque segment.

Exemples

L’exemple suivant montre comment examiner les données de qualification d’un complément.

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

Remarques

Utilisez cette propriété pour obtenir des données qui ont été appliquées aux segments de pipeline avec l’attribut QualificationDataAttribute . Vous pouvez utiliser ces données pour identifier et utiliser les types qui composent vos pipelines.

Cette propriété retourne un dictionnaire de dictionnaires. Le dictionnaire supérieur a toujours six clés. Chaque clé est une AddInSegmentType valeur pour un segment dans le pipeline. Chaque valeur est un générique IDictionary<TKey,TValue> de chaînes avec des clés de chaîne qui contiennent les données de qualification du segment.

Les clés et les valeurs de ces dictionnaires internes sont les noms et les valeurs spécifiés dans les QualificationDataAttribute attributs des segments. Si aucune donnée de qualification n’a été appliquée à un segment, son dictionnaire est vide.

Notes

Le modèle de complément n’utilise pas les données de qualification appliquées à la vue hôte du complément. Par conséquent, le dictionnaire pour AddInSegmentType.HostViewOfAddIn est toujours vide.

Vous pouvez également obtenir des données de qualification en énumérant un AddInToken comme s’il s’agissait d’une collection de QualificationDataItem structures, à l’aide d’une foreach instruction (For Each en Visual Basic, for each en Visual C++). Consultez l’exemple fourni pour la QualificationDataItem structure.