AddInToken.QualificationData Propriété

Définition

Obtient un dictionnaire de données relatif aux segments dans le pipeline associé au jeton actuel.Gets a dictionary of data about the segments in the pipeline associated with the current token.

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é

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.A dictionary whose keys are pipeline segments and whose values are dictionaries of name/value pairs that represent qualification data for each segment.

Exemples

L’exemple suivant montre comment examiner les données de qualification d’un complément.The following example shows how to examine an add-in's qualification data.

// 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 les données qui ont été appliquées aux segments de pipeline avec l' QualificationDataAttribute attribut.Use this property to obtain data that has been applied to pipeline segments with the QualificationDataAttribute attribute. Vous pouvez utiliser ces données pour identifier et utiliser les types qui composent vos pipelines.You can use this data to identify and work with the types that compose your pipelines.

Cette propriété retourne un dictionnaire de dictionnaires.This property returns a dictionary of dictionaries. Le dictionnaire Top a toujours six clés.The top dictionary always has six keys. Chaque clé est une AddInSegmentType valeur pour un segment dans le pipeline.Each key is an AddInSegmentType value for a segment in the pipeline. Chaque valeur est un générique IDictionary<TKey,TValue> de chaînes avec des clés de chaîne qui contient les données de qualification du segment.Each value is a generic IDictionary<TKey,TValue> of strings with string keys that contains the segment's qualification data.

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.The keys and values of these inner dictionaries are the names and values specified in the QualificationDataAttribute attributes for the segments. Si aucune donnée de qualification n’a été appliquée à un segment, son dictionnaire est vide.If no qualification data has been applied to a segment, its dictionary is empty.

Notes

Le modèle de complément n’utilise pas de données de qualification appliquées à la vue hôte du complément.The add-in model does not use qualification data that is applied to the host view of the add-in. Par conséquent, le dictionnaire pour AddInSegmentType.HostViewOfAddIn est toujours vide.As a result, the dictionary for AddInSegmentType.HostViewOfAddIn is always empty.

Vous pouvez également obtenir des données de qualification en énumérant un AddInToken comme s’il s’agissait d’une QualificationDataItem collection de structures, foreach à l'For Each aide d’une for each instruction ( C++dans Visual Basic, en visuel).Alternatively, you can obtain qualification data by enumerating an AddInToken as if it were a collection of QualificationDataItem structures, using a foreach statement (For Each in Visual Basic, for each in Visual C++). Consultez l’exemple fourni pour la QualificationDataItem structure.See the example provided for the QualificationDataItem structure.

S’applique à