AddInToken AddInToken AddInToken AddInToken Class

Definizione

Rappresenta un componente aggiuntivo attivabile.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)
Ereditarietà
AddInTokenAddInTokenAddInTokenAddInToken
Attributi
Implementazioni

Esempi

In questa sezione sono riportati due esempi.This section contains two examples. Il primo esempio viene attivato un componente aggiuntivo che è stato selezionato utilizzando la ChooseAddIn metodo e il secondo esempio viene illustrato il ChooseAddIn (metodo).The first example activates an add-in that has been selected by using the ChooseAddIn method, and the second example shows the ChooseAddIn method.

Esempio 1Example 1

Nell'esempio seguente viene illustrato come attivare un componente aggiuntivo con un token.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)

Esempio 2Example 2

L'esempio seguente mostra l'oggetto personalizzato ChooseAddIn metodo, che enumera un AddInToken raccolta.The following example shows the custom ChooseAddIn method, which enumerates an AddInToken collection. L'utente seleziona un token da questa raccolta per attivare il componente aggiuntivo corrispondente.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

Commenti

Un AddInToken oggetto rappresenta un componente aggiuntivo e il relativo segmenti della pipeline associati, che possono essere attivati.An AddInToken object represents an add-in, and its associated pipeline segments, that can be activated. Il token contiene il nome, il nome dell'assembly, descrizione, editore e la versione del componente aggiuntivo che rappresenta.The token contains the name, assembly name, description, publisher, and version of the add-in that it represents.

Usare il AddInStore.FindAddIns metodo per ottenere una raccolta di token che rappresentano i componenti aggiuntivi corrispondono a una determinata visualizzazione host la cui pipeline.Use the AddInStore.FindAddIns method to get a collection of tokens that represent add-ins whose pipelines match a specified host view. Usare il AddInStore.FindAddIn metodo per ottenere una raccolta di token che rappresentano tutte le pipeline per un componente aggiuntivo specificato che corrispondono a una determinata visualizzazione host.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.

Per attivare un componente aggiuntivo, passare il token che rappresenta il componente aggiuntivo desiderato per il Activate (metodo).To activate an add-in, pass the token that represents the desired add-in to the Activate method. Questo metodo restituisce un'istanza del tipo che rappresenta la visualizzazione host del componente aggiuntivo.This method returns an instance of the type that represents the host view of the add-in.

Il Activate metodo dispone di diversi overload.The Activate method has several overloads. Quando si usa un overload che non richiede il nome di un dominio dell'applicazione come uno dei relativi parametri, viene creato automaticamente un nuovo dominio applicazione per il componente aggiuntivo.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.

È possibile usare i metodi di estensione Language-Integrated Query (LINQ) per eseguire query su un AddInToken, considerando il token come una raccolta di QualificationDataItem strutture.You can use Language-Integrated Query (LINQ) extension methods to perform queries on an AddInToken, treating the token as a collection of QualificationDataItem structures.

Proprietà

AddInFullName AddInFullName AddInFullName AddInFullName

Ottiene lo spazio dei nomi e il tipo del componente aggiuntivo.Gets the namespace and type of the add-in.

AssemblyName AssemblyName AssemblyName AssemblyName

Ottiene il nome dell'assembly che contiene il componente aggiuntivo.Gets the name of the assembly that contains the add-in.

Description Description Description Description

Ottiene la descrizione del componente aggiuntivo.Gets the description of the add-in.

EnableDirectConnect EnableDirectConnect EnableDirectConnect EnableDirectConnect

Ottiene o imposta un valore che indica se i componenti aggiuntivi devono essere connessi direttamente ai rispettivi host quando le condizioni lo permettono.Gets or sets a value that indicates whether add-ins should be directly connected to their hosts when conditions permit.

Name Name Name Name

Ottiene il nome del componente aggiuntivo.Gets the name of the add-in.

Publisher Publisher Publisher Publisher

Ottiene l'editore del componente aggiuntivo.Gets the publisher of the add-in.

QualificationData QualificationData QualificationData QualificationData

Ottiene un dizionario di dati relativi ai segmenti della pipeline associati al token corrente.Gets a dictionary of data about the segments in the pipeline associated with the current token.

Version Version Version Version

Ottiene la versione del componente aggiuntivo, come specificata nell'attributo AddInAttribute.Gets the version of the add-in, as specified in the AddInAttribute attribute.

Metodi

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

Attiva un componente aggiuntivo nell'ambiente di un altro componente aggiuntivo.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)

Attiva un componente aggiuntivo in un processo esterno in un nuovo dominio applicazione e con un livello di attendibilità specificato.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)

Attiva un componente aggiuntivo in un processo esterno in un nuovo dominio applicazione e con un set di autorizzazioni specificato.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)

Attiva un componente aggiuntivo con un livello di attendibilità specificato in un nuovo dominio applicazione.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)

Attiva un componente aggiuntivo in un nuovo dominio applicazione con un nome e un livello di attendibilità specificati.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)

Attiva un componente aggiuntivo in un dominio applicazione esistente.Activates an add-in in an existing application domain.

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

Attiva un componente aggiuntivo con un set di autorizzazioni specificato in un nuovo dominio applicazione.Activates an add-in with a specified permission set in a new application domain.

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

Determina se un oggetto specificato equivale all'istanza corrente.Determines whether a specified object is equal to the current instance.

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

Restituisce un enumeratore per i dati di qualificazione dei segmenti della pipeline associati a questo token.Returns an enumerator for the qualification data of the pipeline segments that are associated with this token.

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

Viene utilizzato come funzione hash per un token.Serves as a hash function for a token.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Restituisce una stringa che rappresenta il token.Returns a string that represents the token.

Implementazioni dell'interfaccia esplicita

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

Restituisce un enumeratore per i dati di qualificazione dei segmenti della pipeline associati a questo token.Returns an enumerator for the qualification data of the pipeline segments that are associated with this token.

Extension Methods

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

Restituisce un DataTable che contiene copie del DataRow oggetti, dato un input IEnumerable<T> oggetto in cui il parametro generico T è 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) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)

Le copie DataRow oggetti specificata DataTable, un giudizio IEnumerable<T> oggetto in cui il parametro generico T è 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) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler) CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)

Le copie DataRow oggetti specificata DataTable, un giudizio IEnumerable<T> oggetto in cui il parametro generico T è DataRow.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)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

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

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

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

Consente la parallelizzazione di una query.Enables parallelization of a query.

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

Converte un' IEnumerable a un IQueryable.Converts an IEnumerable to an IQueryable.

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

Restituisce una raccolta di elementi che contiene i predecessori di ciascun nodo nella raccolta di origine.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)

Restituisce una raccolta di elementi filtrati che contiene i predecessori di ciascun nodo nella raccolta di origine.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta.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>)

Restituisce una raccolta di nodi discendenti di ciascun documento ed elemento nella raccolta di origine.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>)

Restituisce una raccolta di elementi che contiene gli elementi discendenti di ciascun elemento e documento nella raccolta di origine.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)

Restituisce una raccolta filtrata di elementi che contiene gli elementi discendenti di ciascun elemento e documento nella raccolta di origine.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta.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>)

Restituisce una raccolta di elementi figlio di ciascun elemento e documento nella raccolta di origine.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)

Restituisce una raccolta filtrata degli elementi figlio di ciascun elemento e documento nella raccolta di origine.Returns a filtered collection of the child elements of every element and document in the source collection. Solo gli elementi che hanno un oggetto XName corrispondente vengono inclusi nella raccolta.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>)

Restituisce una raccolta di nodi che contiene tutti i nodi nella raccolta di origine ordinati in base all'ordine con cui sono riportati nel documento.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>)

Restituisce una raccolta di nodi figlio di ciascun documento ed elemento nella raccolta di origine.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>)

Rimuove ciascun nodo nella raccolta di origine dal nodo padre.Removes every node in the source collection from its parent node.

Si applica a

Vedi anche