AddInToken Classe

Définition

Représente un complément qui peut être activé.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)
Héritage
AddInToken
Attributs
Implémente

Exemples

Cette section contient deux exemples.This section contains two examples. Le premier exemple active un complément qui a été sélectionné à l’aide de la ChooseAddIn méthode, et le deuxième exemple montre la ChooseAddIn méthode.The first example activates an add-in that has been selected by using the ChooseAddIn method, and the second example shows the ChooseAddIn method.

Exemple 1Example 1

L’exemple suivant montre comment activer un complément avec un jeton.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)

Exemple 2Example 2

L’exemple suivant illustre la méthode ChooseAddIn personnalisée, qui énumère une AddInToken collection.The following example shows the custom ChooseAddIn method, which enumerates an AddInToken collection. L’utilisateur sélectionne un jeton de cette collection pour activer le complément correspondant.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

Remarques

Un AddInToken objet représente un complément, et ses segments de pipeline associés, qui peuvent être activés.An AddInToken object represents an add-in, and its associated pipeline segments, that can be activated. Le jeton contient le nom, le nom de l’assembly, la description, l’éditeur et la version du complément qu’il représente.The token contains the name, assembly name, description, publisher, and version of the add-in that it represents.

Utilisez la AddInStore.FindAddIns méthode pour obtenir une collection de jetons qui représentent des compléments dont les pipelines correspondent à une vue hôte spécifiée.Use the AddInStore.FindAddIns method to get a collection of tokens that represent add-ins whose pipelines match a specified host view. Utilisez la AddInStore.FindAddIn méthode pour obtenir une collection de jetons qui représentent tous les pipelines d’un complément spécifié qui correspondent à une vue hôte spécifiée.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.

Pour activer un complément, transmettez le jeton qui représente le complément souhaité à la Activate méthode.To activate an add-in, pass the token that represents the desired add-in to the Activate method. Cette méthode retourne une instance du type qui représente la vue hôte du complément.This method returns an instance of the type that represents the host view of the add-in.

La Activate méthode a plusieurs surcharges.The Activate method has several overloads. Quand vous utilisez une surcharge qui ne requiert pas le nom d’un domaine d’application comme l’un de ses paramètres, un nouveau domaine d’application pour le complément est automatiquement créé.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.

Vous pouvez utiliser des méthodes d’extension LINQ (Language-Integrated Query) pour exécuter des AddInTokenrequêtes sur un, en traitant le jeton QualificationDataItem comme une collection de structures.You can use Language-Integrated Query (LINQ) extension methods to perform queries on an AddInToken, treating the token as a collection of QualificationDataItem structures.

Propriétés

AddInFullName

Obtient l'espace de noms et le type du complément.Gets the namespace and type of the add-in.

AssemblyName

Obtient le nom de l'assembly qui contient le complément.Gets the name of the assembly that contains the add-in.

Description

Obtient la description du complément.Gets the description of the add-in.

EnableDirectConnect

Obtient ou définit une valeur qui indique si les compléments doivent être connectés directement à leurs hôtes quand les conditions le permettent.Gets or sets a value that indicates whether add-ins should be directly connected to their hosts when conditions permit.

Name

Obtient le nom du complément.Gets the name of the add-in.

Publisher

Obtient l'éditeur du complément.Gets the publisher of the add-in.

QualificationData

Obtient un dictionnaire de données relatif aux segments dans le pipeline associé au jeton actuel.Gets a dictionary of data about the segments in the pipeline associated with the current token.

Version

Obtient la version du complément, comme spécifié dans l'attribut AddInAttribute.Gets the version of the add-in, as specified in the AddInAttribute attribute.

Méthodes

Activate<T>(AddInEnvironment)

Active un complément dans l'environnement d'un autre complément.Activates an add-in in the environment of another add-in.

Activate<T>(AddInProcess, AddInSecurityLevel)

Active un complément dans un processus externe, dans un nouveau domaine d'application, et avec un niveau de confiance spécifié.Activates an add-in in an external process, in a new application domain, and with a specified trust level.

Activate<T>(AddInProcess, PermissionSet)

Active un complément dans un processus externe, dans un nouveau domaine d'application, et avec un jeu d'autorisations spécifié.Activates an add-in in an external process, in a new application domain, and with a specified permission set.

Activate<T>(AddInSecurityLevel)

Active un complément avec un niveau de confiance spécifié dans un nouveau domaine d'application.Activates an add-in with a specified trust level in a new application domain.

Activate<T>(AddInSecurityLevel, String)

Active un complément dans un nouveau domaine d'application avec un nom et un niveau de confiance spécifiés.Activates an add-in in a new application domain with a specified name and trust level.

Activate<T>(AppDomain)

Active un complément dans un domaine d'application existant.Activates an add-in in an existing application domain.

Activate<T>(PermissionSet)

Active un complément avec un jeu d'autorisations spécifié dans un nouveau domaine d'application.Activates an add-in with a specified permission set in a new application domain.

Equals(Object)

Détermine si un objet spécifié est identique à l'instance actuelle.Determines whether a specified object is equal to the current instance.

GetEnumerator()

Retourne un énumérateur pour les données de qualification des segments de pipeline associés à ce jeton.Returns an enumerator for the qualification data of the pipeline segments that are associated with this token.

GetHashCode()

Sert de fonction de hachage pour un jeton.Serves as a hash function for a token.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente le jeton.Returns a string that represents the token.

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()

Retourne un énumérateur pour les données de qualification des segments de pipeline associés à ce jeton.Returns an enumerator for the qualification data of the pipeline segments that are associated with this token.

Méthodes d’extension

CopyToDataTable<T>(IEnumerable<T>)

Retourne un DataTable qui contient des copies des objets DataRow, à partir d'un objet d'entrée IEnumerable<T> où le paramètre générique T est DataRow.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)

Copie les objets DataRow vers le DataTable spécifié, à partir d'un objet d'entrée IEnumerable<T> où le paramètre générique T est DataRow.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)

Copie les objets DataRow vers le DataTable spécifié, à partir d'un objet d'entrée IEnumerable<T> où le paramètre générique T est DataRow.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Retourne une collection d'éléments qui contient les ancêtres de chaque nœud de la collection source.Returns a collection of elements that contains the ancestors of every node in the source collection.

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

Retourne une collection d'éléments filtrée qui contient les ancêtres de chaque nœud de la collection source.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Seuls les éléments avec un XName correspondant sont inclus dans la collection.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Retourne une collection des nœuds descendants de chaque document et élément de la collection source.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Retourne une collection d'éléments qui contient les éléments descendants de tous les éléments et tous les documents de la collection source.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

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

Retourne une collection d'éléments filtrée qui contient les éléments descendants de tous les éléments et tous les documents de la collection source.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Seuls les éléments avec un XName correspondant sont inclus dans la collection.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Retourne une collection des éléments enfants de chaque élément et document de la collection source.Returns a collection of the child elements of every element and document in the source collection.

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

Retourne une collection filtrée des éléments enfants de chaque élément et document de la collection source.Returns a filtered collection of the child elements of every element and document in the source collection. Seuls les éléments avec un XName correspondant sont inclus dans la collection.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Retourne une collection de nœuds qui contient tous les nœuds de la collection source, triés selon l'ordre des documents.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Retourne une collection des nœuds enfants de chaque document et élément de la collection source.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Supprime chaque nœud de la collection source de son nœud parent.Removes every node in the source collection from its parent node.

S’applique à

Voir aussi