AddInToken.QualificationData Propriedade

Definição

Namespace:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Obtém um dicionário de dados sobre os segmentos no pipeline associado ao token atual.

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 da propriedade

IDictionary<AddInSegmentType,IDictionary<String,String>>

Um dicionário cujas chaves são segmentos de pipeline e cujos valores são dicionários de pares nome/valor que representam dados de qualificação para cada segmento.

Exemplos

O exemplo a seguir mostra como examinar os dados de qualificação de um suplemento.

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

Comentários

Use essa propriedade para obter dados que foram aplicados a segmentos de pipeline com o QualificationDataAttribute atributo . Você pode usar esses dados para identificar e trabalhar com os tipos que compõem seus pipelines.

Essa propriedade retorna um dicionário de dicionários. O dicionário superior sempre tem seis chaves. Cada chave é um AddInSegmentType valor para um segmento no pipeline. Cada valor é um genérico IDictionary<TKey,TValue> de cadeias de caracteres com chaves de cadeia de caracteres que contém os dados de qualificação do segmento.

As chaves e os valores desses dicionários internos são os nomes e valores especificados nos QualificationDataAttribute atributos para os segmentos. Se nenhum dado de qualificação tiver sido aplicado a um segmento, seu dicionário estará vazio.

Observação

O modelo de suplemento não usa dados de qualificação aplicados à exibição de host do suplemento. Como resultado, o dicionário para AddInSegmentType.HostViewOfAddIn é sempre vazio.

Como alternativa, você pode obter dados de qualificação enumerando um AddInToken como se fosse uma coleção de QualificationDataItem estruturas, usando uma foreach instrução (For Each no Visual Basic, for each no Visual C++). Consulte o exemplo fornecido para a QualificationDataItem estrutura.