AddInToken.QualificationData Eigenschaft

Definition

Namespace:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Ruft ein Wörterbuch von Daten zu den Segmenten in der dem aktuellen Token zugeordneten Pipeline ab.

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

Eigenschaftswert

IDictionary<AddInSegmentType,IDictionary<String,String>>

Ein Wörterbuch, dessen Schlüssel Pipelinesegmente und dessen Werte Wörterbücher von Name-Wert-Paaren sind, die Qualifizierungsdaten für die einzelnen Segmente darstellen.

Beispiele

Das folgende Beispiel zeigt, wie Die Qualifikationsdaten eines Add-Ins untersucht werden.

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

Hinweise

Verwenden Sie diese Eigenschaft, um Daten abzurufen, die mit dem QualificationDataAttribute -Attribut auf Pipelinesegmente angewendet wurden. Sie können diese Daten verwenden, um die Typen zu identifizieren und damit zu arbeiten, aus denen Ihre Pipelines besteht.

Diese Eigenschaft gibt ein Wörterbuch mit Wörterbüchern zurück. Das oberste Wörterbuch verfügt immer über sechs Schlüssel. Jeder Schlüssel ist ein AddInSegmentType Wert für ein Segment in der Pipeline. Jeder Wert ist ein Generisches IDictionary<TKey,TValue> aus Zeichenfolgen mit Zeichenfolgenschlüsseln, die die Qualifikationsdaten des Segments enthalten.

Die Schlüssel und Werte dieser inneren Wörterbücher sind die Namen und Werte, die in den QualificationDataAttribute Attributen für die Segmente angegeben sind. Wenn keine Qualifikationsdaten auf ein Segment angewendet wurden, ist dessen Wörterbuch leer.

Hinweis

Das Add-In-Modell verwendet keine Qualifikationsdaten, die auf die Hostansicht des Add-Ins angewendet werden. Daher ist das Wörterbuch für AddInSegmentType.HostViewOfAddIn immer leer.

Alternativ können Sie Qualifizierungsdaten abrufen, indem Sie eine AddInToken aufzählen, als ob es eine Sammlung von QualificationDataItem Strukturen wäre, indem Sie eine foreach -Anweisung (For Each in Visual Basic, for each in Visual C++) verwenden. Sehen Sie sich das für die -Struktur bereitgestellte QualificationDataItem Beispiel an.