AddInToken.QualificationData Propiedad

Definición

Espacio de nombres:

System.AddIn.Hosting

Ensamblado:

System.AddIn.dll

Obtiene un diccionario de datos sobre los segmentos de la canalización asociada al token actual.

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

Valor de propiedad

IDictionary<AddInSegmentType,IDictionary<String,String>>

Diccionario cuyas claves son los segmentos de canalización y cuyos valores son diccionarios de pares nombre/valor que representan los datos de calificación de cada segmento.

Ejemplos

En el ejemplo siguiente se muestra cómo examinar los datos de calificación de un complemento.

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

Comentarios

Utilice esta propiedad para obtener los datos que se han aplicado a los segmentos de canalización con el QualificationDataAttribute atributo . Puede usar estos datos para identificar y trabajar con los tipos que componen las canalizaciones.

Esta propiedad devuelve un diccionario de diccionarios. El diccionario superior siempre tiene seis claves. Cada clave es un AddInSegmentType valor para un segmento de la canalización. Cada valor es un genérico IDictionary<TKey,TValue> de cadenas con claves de cadena que contiene los datos de calificación del segmento.

Las claves y los valores de estos diccionarios internos son los nombres y valores especificados en los QualificationDataAttribute atributos de los segmentos. Si no se han aplicado datos de calificación a un segmento, su diccionario está vacío.

Nota

El modelo de complemento no usa datos de calificación que se aplican a la vista host del complemento. Como resultado, el diccionario de AddInSegmentType.HostViewOfAddIn siempre está vacío.

Como alternativa, puede obtener datos de calificación mediante la enumeración de como AddInToken si fuera una colección de QualificationDataItem estructuras, mediante una foreach instrucción (For Each en Visual Basic, for each en Visual C++). Consulte el ejemplo proporcionado para la QualificationDataItem estructura.