AddInToken Класс

Определение

Представляет надстройку, которая может быть активирована.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)
Наследование
AddInToken
Атрибуты
Реализации

Примеры

Этот раздел содержит два примера.This section contains two examples. В первом примере активируется надстройка, выбранная с помощью ChooseAddIn метода, а во втором примере ChooseAddIn показан метод.The first example activates an add-in that has been selected by using the ChooseAddIn method, and the second example shows the ChooseAddIn method.

Пример 1Example 1

В следующем примере показано, как активировать надстройку с помощью токена.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)

Пример 2Example 2

В следующем примере показан пользовательский ChooseAddIn метод, который перечисляет AddInToken коллекцию.The following example shows the custom ChooseAddIn method, which enumerates an AddInToken collection. Пользователь выбирает маркер из этой коллекции для активации соответствующей надстройки.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

Комментарии

AddInToken Объект представляет надстройку и связанные с ней сегменты конвейера, которые могут быть активированы.An AddInToken object represents an add-in, and its associated pipeline segments, that can be activated. Токен содержит имя, имя сборки, описание, издателя и версию надстройки, которую она представляет.The token contains the name, assembly name, description, publisher, and version of the add-in that it represents.

AddInStore.FindAddIns Используйте метод, чтобы получить коллекцию токенов, представляющих надстройки, конвейеры которых соответствуют указанному хост-представлению.Use the AddInStore.FindAddIns method to get a collection of tokens that represent add-ins whose pipelines match a specified host view. AddInStore.FindAddIn Используйте метод, чтобы получить коллекцию токенов, представляющих все конвейеры для указанной надстройки, которые соответствуют указанному хост-представлению.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.

Чтобы активировать надстройку, передайте маркер, представляющий нужную надстройку Activate , в метод.To activate an add-in, pass the token that represents the desired add-in to the Activate method. Этот метод возвращает экземпляр типа, представляющий главное представление надстройки.This method returns an instance of the type that represents the host view of the add-in.

Activate Метод имеет несколько перегрузок.The Activate method has several overloads. При использовании перегрузки, которая не требует имени домена приложения в качестве одного из параметров, автоматически создается новый домен приложения для надстройки.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.

Можно использовать методы расширения запросов языка LINQ для выполнения запросов AddInTokenк, рассматривая маркер как QualificationDataItem коллекцию структур.You can use Language-Integrated Query (LINQ) extension methods to perform queries on an AddInToken, treating the token as a collection of QualificationDataItem structures.

Свойства

AddInFullName

Возвращает пространство имен и тип надстройки.Gets the namespace and type of the add-in.

AssemblyName

Возвращает имя сборки, содержащей надстройку.Gets the name of the assembly that contains the add-in.

Description

Возвращает описание надстройки.Gets the description of the add-in.

EnableDirectConnect

Получает или задает значение, указывающее, должны ли надстройки непосредственно подключаться к их узлам, если условия это позволяют.Gets or sets a value that indicates whether add-ins should be directly connected to their hosts when conditions permit.

Name

Возвращает имя надстройки.Gets the name of the add-in.

Publisher

Возвращает издатель надстройки.Gets the publisher of the add-in.

QualificationData

Возвращает словарь данных о сегментах в конвейере, связанных с текущим токеном.Gets a dictionary of data about the segments in the pipeline associated with the current token.

Version

Возвращает версию надстройки, как указано атрибутом AddInAttribute.Gets the version of the add-in, as specified in the AddInAttribute attribute.

Методы

Activate<T>(AddInEnvironment)

Активирует надстройку в среде другой надстройки.Activates an add-in in the environment of another add-in.

Activate<T>(AddInProcess, AddInSecurityLevel)

Активирует надстройку во внешнем процессе в новом домене приложения с выбранным уровнем доверия.Activates an add-in in an external process, in a new application domain, and with a specified trust level.

Activate<T>(AddInProcess, PermissionSet)

Активирует надстройку во внешнем процессе в новом домене приложения с выбранным набором разрешений.Activates an add-in in an external process, in a new application domain, and with a specified permission set.

Activate<T>(AddInSecurityLevel)

Активирует надстройку с выбранным уровнем доверия в новом домене приложения.Activates an add-in with a specified trust level in a new application domain.

Activate<T>(AddInSecurityLevel, String)

Активирует надстройку в новом домене приложения с выбранным именем и уровнем доверия.Activates an add-in in a new application domain with a specified name and trust level.

Activate<T>(AppDomain)

Активирует надстройку в существующем домене приложения.Activates an add-in in an existing application domain.

Activate<T>(PermissionSet)

Активирует надстройку с выбранным набором разрешений в новом домене приложения.Activates an add-in with a specified permission set in a new application domain.

Equals(Object)

Определяет идентичен ли выбранный объект текущему экземпляру.Determines whether a specified object is equal to the current instance.

GetEnumerator()

Возвращает перечислитель для квалификационных данных сегментов конвейера, связанных с данным токеном.Returns an enumerator for the qualification data of the pipeline segments that are associated with this token.

GetHashCode()

Служит в качестве хэш-кода для токена.Serves as a hash function for a token.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую токен.Returns a string that represents the token.

Явные реализации интерфейса

IEnumerable.GetEnumerator()

Возвращает перечислитель для квалификационных данных сегментов конвейера, связанных с данным токеном.Returns an enumerator for the qualification data of the pipeline segments that are associated with this token.

Методы расширения

CopyToDataTable<T>(IEnumerable<T>)

Возвращает объект DataTable, содержащий копии объектов DataRow при заданном входном объекте IEnumerable<T> и универсальном параметре 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)

Копирует объекты DataRow в указанный объект DataTable с заданным входным объектом IEnumerable<T>, где универсальный параметр 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)

Копирует объекты DataRow в указанный объект DataTable с заданным входным объектом IEnumerable<T>, где универсальный параметр 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)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Возвращает коллекцию элементов, содержащую предков каждого узла в исходной коллекции.Returns a collection of elements that contains the ancestors of every node in the source collection.

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

Возвращает отфильтрованную коллекцию элементов, содержащую предков каждого узла в исходной коллекции.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Возвращает коллекцию подчиненных узлов каждого документа и элемента в исходной коллекции.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Возвращает коллекцию элементов, содержащую подчиненные элементы каждого элемента и документа в исходной коллекции.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

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

Возвращает отфильтрованную коллекцию элементов, содержащую подчиненные элементы каждого элемента и документа в исходной коллекции.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Возвращает коллекцию дочерних элементов каждого элемента и документа в исходной коллекции.Returns a collection of the child elements of every element and document in the source collection.

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

Возвращает отфильтрованную коллекцию дочерних элементов каждого элемента и документа в исходной коллекции.Returns a filtered collection of the child elements of every element and document in the source collection. В коллекцию включаются только элементы, соответствующие XName.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Возвращает коллекцию узлов, содержащую все узлы в исходной коллекции, отсортированные в порядке следования документов.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Возвращает коллекцию дочерних узлов каждого документа и элемента в исходной коллекции.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Удаление каждого узла в исходной коллекции из родительского узла.Removes every node in the source collection from its parent node.

Применяется к

Дополнительно