AddInToken AddInToken AddInToken AddInToken Class

Definition

Stellt ein Add-In dar, das aktiviert werden kann.Represents an add-in that can be activated.

public ref class AddInToken sealed : System::Collections::Generic::IEnumerable<System::AddIn::Hosting::QualificationDataItem>
[System.Serializable]
public sealed class AddInToken : System.Collections.Generic.IEnumerable<System.AddIn.Hosting.QualificationDataItem>
type AddInToken = class
    interface seq<QualificationDataItem>
    interface IEnumerable
Public NotInheritable Class AddInToken
Implements IEnumerable(Of QualificationDataItem)
Vererbung
AddInTokenAddInTokenAddInTokenAddInToken
Attribute
Implementiert

Beispiele

Dieser Abschnitt enthält zwei Beispiele.This section contains two examples. Im ersten Beispiel wird ein Add-in aktiviert, das mit der ChooseAddIn -Methode ausgewählt wurde, und im zweiten Beispiel wird die ChooseAddIn -Methode veranschaulicht.The first example activates an add-in that has been selected by using the ChooseAddIn method, and the second example shows the ChooseAddIn method.

Beispiel 1Example 1

Im folgenden Beispiel wird gezeigt, wie ein Add-in mit einem Token aktiviert wird.The following example shows how to activate an add-in with a token.

//Ask the user which add-in they would like to use.
AddInToken selectedToken = ChooseAddIn(tokens);

//Activate the selected AddInToken in a new
//application domain with the Internet trust level.
Calculator CalcAddIn = selectedToken.Activate<Calculator>(AddInSecurityLevel.Internet);
            
//Run the add-in using a custom method.
RunCalculator(CalcAddIn);
'Ask the user which add-in they would like to use.
Dim selectedToken As AddInToken = ChooseAddIn(tokens)
'Activate the selected AddInToken in a new
'application domain with the Internet trust level.
Dim CalcAddIn As Calculator = selectedToken.Activate(Of Calculator)(AddInSecurityLevel.Internet)
'Run the add-in using a custom method.
RunCalculator(CalcAddIn)

Beispiel 2Example 2

Das folgende Beispiel zeigt die Benutzer ChooseAddIn definierte-Methode, die eine AddInToken -Auflistung auflistet.The following example shows the custom ChooseAddIn method, which enumerates an AddInToken collection. Der Benutzer wählt ein Token aus dieser Sammlung aus, um das entsprechende Add-in zu aktivieren.The user selects a token from this collection to activate the corresponding add-in.

// Method to select a token by 
// enumeratng the AddInToken collection.
private static AddInToken ChooseAddIn(Collection<AddInToken> tokens)
{
    if (tokens.Count == 0)
    {
        Console.WriteLine("No add-ins are available");
        return null;
    }

    Console.WriteLine("Available add-ins: ");

	// Show the token properties for each token 
	// in the AddInToken collection (tokens),
	// preceded by the add-in number in [] brackets.
    int tokNumber = 1;
	foreach (AddInToken tok in tokens)
	{
		Console.WriteLine(String.Format("\t[{0}]: {1} - {2}\n\t{3}\n\t\t {4}\n\t\t {5} - {6}",
			tokNumber.ToString(), 
			tok.Name,
			tok.AddInFullName,
			tok.AssemblyName,
			tok.Description,
			tok.Version,
			tok.Publisher));
        tokNumber++;
	}

    Console.WriteLine("Which calculator do you want to use?");
    String line = Console.ReadLine();
    int selection;
    if (Int32.TryParse(line, out selection))
    {
        if (selection <= tokens.Count)
        {
            return tokens[selection - 1];
        }
    }
    Console.WriteLine("Invalid selection: {0}. Please choose again.", line);
    return ChooseAddIn(tokens);
}
' Method to select a token by 
' enumeratng the AddInToken collection.

Private Shared Function ChooseAddIn(ByVal tokens As System.Collections.ObjectModel.Collection(Of AddInToken)) As AddInToken
    If (tokens.Count = 0) Then
        Console.WriteLine("No add-ins are available")
        Return Nothing
    End If
    Console.WriteLine("Available add-ins: ")
    ' Show the token properties for each token 
    ' in the AddInToken collection (tokens),
    ' preceded by the add-in number in [] brackets.

    Dim tokNumber As Integer = 1
    For Each tok As AddInToken In tokens
        Console.WriteLine(vbTab & "{0}: {1} - {2}" & _
                vbLf & vbTab & "{3}" & _
                vbLf & vbTab & "{4}" & _
                vbLf & vbTab & "{5} - {6}", _
                tokNumber.ToString, tok.Name, _
                tok.AddInFullName, tok.AssemblyName, _
                tok.Description, tok.Version, tok.Publisher)
        tokNumber = tokNumber + 1
    Next
    Console.WriteLine("Which calculator do you want to use?")
    Dim line As String = Console.ReadLine
    Dim selection As Integer
    If Int32.TryParse(line, selection) Then
        If (selection <= tokens.Count) Then
            Return tokens((selection - 1))
        End If
    End If
    Console.WriteLine("Invalid selection: {0}. Please choose again.", line)
    Return ChooseAddIn(tokens)

End Function

Hinweise

Ein AddInToken -Objekt stellt ein Add-in und die zugehörigen Pipeline Segmente dar, die aktiviert werden können.An AddInToken object represents an add-in, and its associated pipeline segments, that can be activated. Das Token enthält den Namen, den Assemblynamen, die Beschreibung, den Verleger und die Version des Add-Ins, das es darstellt.The token contains the name, assembly name, description, publisher, and version of the add-in that it represents.

Verwenden Sie AddInStore.FindAddIns die-Methode, um eine Auflistung von Token zu erhalten, die Add-Ins darstellen, deren Pipelines einer angegebenen Host Ansicht entsprechen.Use the AddInStore.FindAddIns method to get a collection of tokens that represent add-ins whose pipelines match a specified host view. Verwenden Sie AddInStore.FindAddIn die-Methode, um eine Auflistung von Token zu erhalten, die alle Pipelines für ein angegebenes Add-in darstellen, die einer angegebenen Host Ansicht entsprechen.Use the AddInStore.FindAddIn method to get a collection of tokens that represent all the pipelines for a specified add-in that match a specified host view.

Um ein Add-in zu aktivieren, übergeben Sie das Token, das das gewünschte Add-in Activate darstellt, an die-Methode.To activate an add-in, pass the token that represents the desired add-in to the Activate method. Diese Methode gibt eine Instanz des Typs zurück, der die Host Ansicht des Add-Ins darstellt.This method returns an instance of the type that represents the host view of the add-in.

Die Activate -Methode verfügt über mehrere über Ladungen.The Activate method has several overloads. Wenn Sie eine Überladung verwenden, die den Namen einer Anwendungsdomäne nicht als einen ihrer Parameter erfordert, wird automatisch eine neue Anwendungsdomäne für das Add-in erstellt.When you use an overload that does not require the name of an application domain as one of its parameters, a new application domain for the add-in is automatically created.

Sie können LINQ (Language-Integrated Query)-Erweiterungs Methoden verwenden, um Abfragen für AddInTokeneine auszuführen und das Token als eine Auflistung QualificationDataItem von Strukturen zu behandeln.You can use Language-Integrated Query (LINQ) extension methods to perform queries on an AddInToken, treating the token as a collection of QualificationDataItem structures.

Eigenschaften

AddInFullName AddInFullName AddInFullName AddInFullName

Ruft den Namespace und den Typ des Add-Ins ab.Gets the namespace and type of the add-in.

AssemblyName AssemblyName AssemblyName AssemblyName

Ruft den Namen der Assembly ab, die das Add-In enthält.Gets the name of the assembly that contains the add-in.

Description Description Description Description

Ruft die Beschreibung des Add-Ins ab.Gets the description of the add-in.

EnableDirectConnect EnableDirectConnect EnableDirectConnect EnableDirectConnect

Ruft einen Wert ab, der angibt, ob Add-Ins direkt mit ihren Hosts verbunden werden sollen, wenn die Bedingungen dies zulassen, oder legt diesen Wert fest.Gets or sets a value that indicates whether add-ins should be directly connected to their hosts when conditions permit.

Name Name Name Name

Ruft den Namen des Add-Ins ab.Gets the name of the add-in.

Publisher Publisher Publisher Publisher

Ruft den Herausgeber des Add-Ins ab.Gets the publisher of the add-in.

QualificationData QualificationData QualificationData QualificationData

Ruft ein Wörterbuch von Daten zu den Segmenten in der dem aktuellen Token zugeordneten Pipeline ab.Gets a dictionary of data about the segments in the pipeline associated with the current token.

Version Version Version Version

Ruft die Version des Add-Ins ab, wie im AddInAttribute-Attribut angegeben.Gets the version of the add-in, as specified in the AddInAttribute attribute.

Methoden

Activate<T>(AddInEnvironment) Activate<T>(AddInEnvironment) Activate<T>(AddInEnvironment) Activate<T>(AddInEnvironment)

Aktiviert ein Add-In in der Umgebung eines anderen Add-Ins.Activates an add-in in the environment of another add-in.

Activate<T>(AddInProcess, AddInSecurityLevel) Activate<T>(AddInProcess, AddInSecurityLevel) Activate<T>(AddInProcess, AddInSecurityLevel) Activate<T>(AddInProcess, AddInSecurityLevel)

Aktiviert ein Add-In mit einer angegebenen Vertrauensebene in einem externen Prozess in einer neuen Anwendungsdomäne.Activates an add-in in an external process, in a new application domain, and with a specified trust level.

Activate<T>(AddInProcess, PermissionSet) Activate<T>(AddInProcess, PermissionSet) Activate<T>(AddInProcess, PermissionSet) Activate<T>(AddInProcess, PermissionSet)

Aktiviert ein Add-In mit einem angegebenen Berechtigungssatz in einem externen Prozess in einer neuen Anwendungsdomäne.Activates an add-in in an external process, in a new application domain, and with a specified permission set.

Activate<T>(AddInSecurityLevel) Activate<T>(AddInSecurityLevel) Activate<T>(AddInSecurityLevel) Activate<T>(AddInSecurityLevel)

Aktiviert ein Add-In mit einer angegebenen Vertrauensebene in einer neuen Anwendungsdomäne.Activates an add-in with a specified trust level in a new application domain.

Activate<T>(AddInSecurityLevel, String) Activate<T>(AddInSecurityLevel, String) Activate<T>(AddInSecurityLevel, String) Activate<T>(AddInSecurityLevel, String)

Aktiviert ein Add-In mit einem angegebenen Namen und einer angegebenen Vertrauensebene in einer neuen Anwendungsdomäne.Activates an add-in in a new application domain with a specified name and trust level.

Activate<T>(AppDomain) Activate<T>(AppDomain) Activate<T>(AppDomain) Activate<T>(AppDomain)

Aktiviert ein Add-In in einer vorhandenen Anwendungsdomäne.Activates an add-in in an existing application domain.

Activate<T>(PermissionSet) Activate<T>(PermissionSet) Activate<T>(PermissionSet) Activate<T>(PermissionSet)

Aktiviert ein Add-In mit einem angegebenen Berechtigungssatz in einer neuen Anwendungsdomäne.Activates an add-in with a specified permission set in a new application domain.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob ein angegebenes Objekt gleich der aktuellen Instanz ist.Determines whether a specified object is equal to the current instance.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Gibt einen Enumerator für die Qualifizierungsdaten der Pipelinesegmente zurück, die diesem Token zugeordnet sind.Returns an enumerator for the qualification data of the pipeline segments that are associated with this token.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als eine Hashfunktion für ein Token.Serves as a hash function for a token.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das Token darstellt.Returns a string that represents the token.

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Gibt einen Enumerator für die Qualifizierungsdaten der Pipelinesegmente zurück, die diesem Token zugeordnet sind.Returns an enumerator for the qualification data of the pipeline segments that are associated with this token.

Erweiterungsmethoden

CopyToDataTable<T>(IEnumerable<T>) CopyToDataTable<T>(IEnumerable<T>) CopyToDataTable<T>(IEnumerable<T>) CopyToDataTable<T>(IEnumerable<T>)

Gibt eine DataTable zurück, die Kopien der DataRow-Objekte enthält, wenn ein IEnumerable<T>-Eingabeobjekt vorhanden ist, bei dem der generische Parameter T den Wert DataRow hat.Returns a DataTable that contains copies of the DataRow objects, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)

Kopiert DataRow-Objekte in die angegebene DataTable, bei einem IEnumerable<T>-Eingabeobjekt, bei dem der generische Parameter T den Wert DataRow aufweist.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)

Kopiert DataRow-Objekte in die angegebene DataTable, bei einem IEnumerable<T>-Eingabeobjekt, bei dem der generische Parameter T den Wert DataRow aufweist.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>) Ancestors<T>(IEnumerable<T>) Ancestors<T>(IEnumerable<T>) Ancestors<T>(IEnumerable<T>)

Gibt eine Auflistung von Elementen zurück, die die übergeordneten Elemente der einzelnen Knoten in der Quellauflistung enthält.Returns a collection of elements that contains the ancestors of every node in the source collection.

Ancestors<T>(IEnumerable<T>, XName) Ancestors<T>(IEnumerable<T>, XName) Ancestors<T>(IEnumerable<T>, XName) Ancestors<T>(IEnumerable<T>, XName)

Gibt eine gefilterte Auflistung von Elementen zurück, die die übergeordneten Elemente der einzelnen Knoten in der Quellauflistung enthält.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>) DescendantNodes<T>(IEnumerable<T>) DescendantNodes<T>(IEnumerable<T>) DescendantNodes<T>(IEnumerable<T>)

Gibt eine Auflistung der Nachfolgerknoten jedes Dokuments und Elements in der Quellauflistung zurück.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>) Descendants<T>(IEnumerable<T>) Descendants<T>(IEnumerable<T>) Descendants<T>(IEnumerable<T>)

Gibt eine Auflistung von Elementen zurück, die die Nachfolgerelemente jedes Elements und Dokuments in der Quellauflistung enthält.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

Descendants<T>(IEnumerable<T>, XName) Descendants<T>(IEnumerable<T>, XName) Descendants<T>(IEnumerable<T>, XName) Descendants<T>(IEnumerable<T>, XName)

Gibt eine gefilterte Auflistung von Elementen zurück, die die Nachfolgerelemente jedes Elements und Dokuments in der Quellauflistung enthält.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>) Elements<T>(IEnumerable<T>) Elements<T>(IEnumerable<T>) Elements<T>(IEnumerable<T>)

Gibt eine Auflistung der untergeordneten Elemente jedes Elements und Dokuments in der Quellauflistung zurück.Returns a collection of the child elements of every element and document in the source collection.

Elements<T>(IEnumerable<T>, XName) Elements<T>(IEnumerable<T>, XName) Elements<T>(IEnumerable<T>, XName) Elements<T>(IEnumerable<T>, XName)

Gibt eine gefilterte Auflistung der untergeordneten Elemente jedes Elements und Dokuments in der Quellauflistung zurück.Returns a filtered collection of the child elements of every element and document in the source collection. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>) InDocumentOrder<T>(IEnumerable<T>) InDocumentOrder<T>(IEnumerable<T>) InDocumentOrder<T>(IEnumerable<T>)

Gibt eine in Dokumentreihenfolge sortierte Auflistung von Knoten zurück, die alle Knoten in der Quellauflistung enthält.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>) Nodes<T>(IEnumerable<T>) Nodes<T>(IEnumerable<T>) Nodes<T>(IEnumerable<T>)

Gibt eine Auflistung der untergeordneten Knoten jedes Dokuments und Elements in der Quellauflistung zurück.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>) Remove<T>(IEnumerable<T>) Remove<T>(IEnumerable<T>) Remove<T>(IEnumerable<T>)

Entfernt jeden Knoten in der Quellauflistung aus seinem übergeordneten Knoten.Removes every node in the source collection from its parent node.

Gilt für:

Siehe auch