AddInToken.QualificationData AddInToken.QualificationData AddInToken.QualificationData AddInToken.QualificationData Property

Definition

Ruft ein Wörterbuch von Daten zu den Segmenten in der dem aktuellen Token zugeordneten Pipeline ab.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))

Eigenschaftswert

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

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Qualifizierungs Daten eines Add-Ins untersucht werden.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

Hinweise

Verwenden Sie diese Eigenschaft, um Daten abzurufen, die mit dem QualificationDataAttribute -Attribut auf Pipeline Segmente angewendet wurden.Use this property to obtain data that has been applied to pipeline segments with the QualificationDataAttribute attribute. Sie können diese Daten verwenden, um die Typen zu identifizieren und mit Ihnen zu arbeiten, die ihre Pipelines bilden.You can use this data to identify and work with the types that compose your pipelines.

Diese Eigenschaft gibt ein Wörterbuch mit Wörterbüchern zurück.This property returns a dictionary of dictionaries. Das oberste Wörterbuch weist immer sechs Schlüssel auf.The top dictionary always has six keys. Jeder Schlüssel ist ein AddInSegmentType Wert für ein Segment in der Pipeline.Each key is an AddInSegmentType value for a segment in the pipeline. Jeder Wert ist eine generische IDictionary<TKey,TValue> Zeichenfolge mit Zeichen folgen Schlüsseln, die die Qualifikations Daten des Segments enthalten.Each value is a generic IDictionary<TKey,TValue> of strings with string keys that contains the segment's qualification data.

Die Schlüssel und Werte dieser inneren Wörterbücher sind die Namen und Werte, die in QualificationDataAttribute den Attributen für die Segmente angegeben sind.The keys and values of these inner dictionaries are the names and values specified in the QualificationDataAttribute attributes for the segments. Wenn keine Qualifikations Daten auf ein Segment angewendet wurden, ist das zugehörige Wörterbuch leer.If no qualification data has been applied to a segment, its dictionary is empty.

Hinweis

Das Add-in-Modell verwendet keine Qualifizierungs Daten, die auf die Host Ansicht des Add-ins angewendet werden.The add-in model does not use qualification data that is applied to the host view of the add-in. Folglich ist das Wörterbuch für AddInSegmentType.HostViewOfAddIn immer leer.As a result, the dictionary for AddInSegmentType.HostViewOfAddIn is always empty.

Sie können Qualifizierungs Daten auch abrufen, indem Sie ein-Element AddInToken aufzählen, als wäre es eine QualificationDataItem Auflistung von-Strukturen foreach , indemFor Each Sie eine- for each Anweisung ( C++in Visual Basic in Visual) verwenden.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++). Weitere Informationen finden Sie im Beispiel QualificationDataItem für die-Struktur.See the example provided for the QualificationDataItem structure.

Gilt für: