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
属性
実装

このセクションには、2つの例が含まれています。This section contains two examples. 最初の例では、 ChooseAddInメソッドを使用して選択されたアドインをアクティブにします。2番目の例では、 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

次の例は、コレクションChooseAddInAddInToken列挙するカスタムメソッドを示しています。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. アプリケーションドメインの名前をパラメーターの1つとしては必要としないオーバーロードを使用すると、アドイン用の新しいアプリケーションドメインが自動的に作成されます。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 オブジェクトに応じて (ジェネリック パラメーター TDataRow)、IEnumerable<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 オブジェクトに応じて (ジェネリック パラメーター TDataTable)、指定した IEnumerable<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 オブジェクトに応じて (ジェネリック パラメーター TDataTable)、指定した IEnumerable<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)

IEnumerableIQueryable に変換します。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.

適用対象

こちらもご覧ください