AddInToken.QualificationData Proprietà

Definizione

Spazio dei nomi:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Ottiene un dizionario di dati relativi ai segmenti della pipeline associati al token corrente.

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

Valore della proprietà

IDictionary<AddInSegmentType,IDictionary<String,String>>

Dizionario le cui chiavi sono i segmenti della pipeline e i cui valori sono i dizionari di coppie nome/valore che rappresentano i dati di qualificazione per ogni segmento.

Esempio

Nell'esempio seguente viene illustrato come esaminare i dati di qualificazione di un componente aggiuntivo.

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

Commenti

Usare questa proprietà per ottenere i dati applicati ai segmenti della pipeline con l'attributo QualificationDataAttribute . È possibile usare questi dati per identificare e usare i tipi che compongono le pipeline.

Questa proprietà restituisce un dizionario dei dizionari. Il dizionario superiore ha sempre sei chiavi. Ogni chiave è un AddInSegmentType valore per un segmento nella pipeline. Ogni valore è un generico IDictionary<TKey,TValue> di stringhe con chiavi stringa che contiene i dati di qualificazione del segmento.

Le chiavi e i valori di questi dizionari interni sono i nomi e i valori specificati negli attributi per i QualificationDataAttribute segmenti. Se non sono stati applicati dati di qualificazione a un segmento, il relativo dizionario è vuoto.

Nota

Il modello di componente aggiuntivo non usa i dati di qualificazione applicati alla visualizzazione host del componente aggiuntivo. Di conseguenza, il dizionario per AddInSegmentType.HostViewOfAddIn è sempre vuoto.

In alternativa, è possibile ottenere dati di qualificazione enumerando un oggetto AddInToken come se fosse una raccolta di QualificationDataItem strutture usando un'istruzione foreach (For Each in Visual Basic, for each in Visual C++). Vedere l'esempio fornito per la QualificationDataItem struttura.