AddInToken.QualificationData 属性

定义

命名空间:

System.AddIn.Hosting

程序集:

System.AddIn.dll

获取与当前标记关联的各个管线段的相关数据的字典。

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

属性值

IDictionary<AddInSegmentType,IDictionary<String,String>>

一个字典，其键为管线段，其值为一系列名称/值对的字典，这些名称/值对表示每个段的限定数据。

示例

以下示例演示如何检查加载项的资格数据。

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

注解

使用此属性获取已应用于具有 属性的 QualificationDataAttribute 管道段的数据。 可以使用此数据来标识和处理构成管道的类型。

此属性返回字典字典。 顶部字典始终具有六个键。 每个键都是 AddInSegmentType 管道中段的值。 每个值都是字符串的泛型 IDictionary<TKey,TValue> ，其中包含包含段限定数据的字符串键。

这些内部字典的键和值是在段的属性中指定的 QualificationDataAttribute 名称和值。 如果没有将限定数据应用于段，则其字典为空。

注意

外接程序模型不使用应用于外接程序主机视图的限定数据。 因此， 的 AddInSegmentType.HostViewOfAddIn 字典始终为空。

或者，可以通过在 Visual C++) 中使用 foreach Visual Basic 中的语句 (For Each 来枚举 AddInToken 结构集合QualificationDataItem来for each获取限定数据。 请参阅为 QualificationDataItem 结构提供的示例。