AddInToken.GetEnumerator Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí enumerátor pro kvalifikační data segmentů kanálu, které jsou přidruženy k tomuto tokenu.
public:
virtual System::Collections::Generic::IEnumerator<System::AddIn::Hosting::QualificationDataItem> ^ GetEnumerator();
public System.Collections.Generic.IEnumerator<System.AddIn.Hosting.QualificationDataItem> GetEnumerator ();
abstract member GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.AddIn.Hosting.QualificationDataItem>
override this.GetEnumerator : unit -> System.Collections.Generic.IEnumerator<System.AddIn.Hosting.QualificationDataItem>
Public Function GetEnumerator () As IEnumerator(Of QualificationDataItem)
Návraty
Enumerátor, který lze použít k iteraci dat kvalifikace segmentů kanálu přidružených k aktuálnímu tokenu.
Implementuje
Příklady
Následující příklad uvádí data kvalifikace pro segmenty kanálu přidružené k jednotlivým AddInToken segmentům v kolekci tokenů.
// Show the qualification data for each
// token in an AddInToken collection.
foreach (AddInToken token in tokens)
{
foreach (QualificationDataItem qdi in token)
{
Console.WriteLine("{0} {1}\n\t QD Name: {2}, QD Value: {3}",
token.Name,
qdi.Segment,
qdi.Name,
qdi.Value);
}
}
' Show the qualification data for each
' token in an AddInToken collection.
For Each token As AddInToken In tokens
For Each qdi As QualificationDataItem In token
Console.WriteLine("{0} {1}\n\t QD Name: {2}, QD Value: {3}", _
token.Name, qdi.Segment, qdi.Name, qdi.Value)
Next
Next
Poznámky
Pomocí této metody můžete s tokenem zacházet, jako by šlo o kolekci položek kvalifikačních dat, například v foreach
příkazu (For Each
v jazyce Visual Basic, for each
v jazyce Visual C++).
Pomocí enumerátoru vráceného touto metodou můžete iterovat položkami kvalifikačních dat segmentů kanálu přidružených k aktuálnímu tokenu. Každá položka kvalifikačních dat je QualificationDataItem struktura, která identifikuje segment kanálu a obsahuje dvojici název/hodnota z atributu použitého QualificationDataAttribute na tento segment.
Poznámka
Model doplňku nepoužívá kvalifikační data, která jsou použita v zobrazení hostitele doplňku. V důsledku toho při výčtu údajů o kvalifikaci nenajdete žádné položky, jejichž Segment vlastnost je AddInSegmentType.HostViewOfAddIn.
Alternativně můžete pomocí QualificationData vlastnosti získat vnořenou sadu slovníků, které obsahují data kvalifikace segmentů kanálu.