AddInToken.QualificationData Özellik

Tanım

Ad Alanı:

System.AddIn.Hosting

Bütünleştirilmiş Kod:

System.AddIn.dll

Geçerli belirteçle ilişkili işlem hattındaki segmentlerle ilgili bir veri sözlüğü alır.

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

Özellik Değeri

IDictionary<AddInSegmentType,IDictionary<String,String>>

Anahtarları işlem hattı segmentleri olan ve değerleri her segment için niteleme verilerini temsil eden ad/değer çiftlerinin sözlükleri olan bir sözlük.

Örnekler

Aşağıdaki örnekte bir eklentinin niteleme verilerinin nasıl inceleneceği gösterilmektedir.

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

Açıklamalar

özniteliğiyle QualificationDataAttribute işlem hattı kesimlerine uygulanmış verileri almak için bu özelliği kullanın. İşlem hatlarınızı oluşturan türleri tanımlamak ve bunlarla çalışmak için bu verileri kullanabilirsiniz.

Bu özellik sözlükler sözlüğü döndürür. Üstteki sözlüğün her zaman altı tuşu vardır. Her anahtar, işlem hattındaki bir segment için bir AddInSegmentType değerdir. Her değer, segmentin niteleme verilerini içeren dize anahtarlarına sahip dizelerin genelidir IDictionary<TKey,TValue> .

Bu iç sözlüklerin anahtarları ve değerleri, segmentlerin özniteliklerinde QualificationDataAttribute belirtilen adlar ve değerlerdir. Bir segmente herhangi bir niteleme verisi uygulanmadıysa sözlüğü boş olur.

Not

Eklenti modeli, eklentinin konak görünümüne uygulanan niteleme verilerini kullanmaz. Sonuç olarak, sözlüğü AddInSegmentType.HostViewOfAddIn her zaman boş olur.

Alternatif olarak, niteleme verilerini AddInToken almak için deyimini kullanarak (For EachVisual Basic'te, for each Visual C++'da) bir foreach yapı koleksiyonu QualificationDataItem gibi numaralandırabilirsiniz. Yapı için sağlanan örne QualificationDataItem bakın.