AddInToken.QualificationData Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
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.