AddInStore.FindAddIn(Type, String, String, String) Método

Definição

Namespace:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Localiza um suplemento específico.

public:
 static System::Collections::ObjectModel::Collection<System::AddIn::Hosting::AddInToken ^> ^ FindAddIn(Type ^ hostViewOfAddIn, System::String ^ pipelineRootFolderPath, System::String ^ addInFilePath, System::String ^ addInTypeName);

[System.Security.SecurityCritical]
public static System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken> FindAddIn (Type hostViewOfAddIn, string pipelineRootFolderPath, string addInFilePath, string addInTypeName);

[<System.Security.SecurityCritical>]
static member FindAddIn : Type * string * string * string -> System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken>

Public Shared Function FindAddIn (hostViewOfAddIn As Type, pipelineRootFolderPath As String, addInFilePath As String, addInTypeName As String) As Collection(Of AddInToken)

Parâmetros

hostViewOfAddIn

Type

O tipo que define a exibição do suplemento do host.

pipelineRootFolderPath

String

O caminho para a raiz da estrutura de diretório do pipeline.

addInFilePath

String

O caminho e o nome de arquivo do suplemento a ser localizado.

addInTypeName

String

O nome do tipo do suplemento.

Retornos

Collection<AddInToken>

Uma coleção de tokens que contém apenas o token que representa o suplemento encontrado.

Atributos

SecurityCriticalAttribute

Exceções

ArgumentException

O comprimento de pipelineRootFolderPath, addInFilePath ou addInTypeName é zero.

- ou -

O arquivo de suplemento não existe no addInfilePath.

ArgumentNullException

Um ou mais parâmetros são null.

SecurityException

O chamador não tem permissão de acesso de leitura ao pipelineRootFolderPath.

Exemplos

O exemplo a seguir localiza um suplemento específico.

// Find a specific add-in.

// Construct the path to the add-in.
string addInFilePath = pipeRoot + @"\AddIns\P3AddIn2\P3AddIn2.dll";

// The fourth parameter, addinTypeName, takes the full name
// of the type qualified by its namespace. Same as AddInToken.AddInFullName.
Collection<AddInToken> tokenColl = AddInStore.FindAddIn(typeof(Calculator),
    pipeRoot, addInFilePath, "CalcAddIns.P3AddIn2");
Console.WriteLine("Found {0}", tokenColl[0].Name);

' Find a specific add-in.
' Construct the path to the add-in.
Dim addInFilePath As String = (pipeRoot + "\AddIns\P3AddIn2\P3AddIn2.dll")
' The fourth parameter, addinTypeName, takes the full name 
' of the type qualified by its namespace. Same as AddInToken.AddInFullName.
Dim tokenColl As System.Collections.ObjectModel.Collection(Of AddInToken) = AddInStore.FindAddIn(GetType(Calculator), pipeRoot, addInFilePath, "CalcAddIns.P3AddIn2")
Console.WriteLine("Found {0}", tokenColl(0).Name)

Comentários

Se um único pipeline para um suplemento for encontrado, ele será o único item na AddInToken coleção. Se vários pipelines para o suplemento especificado forem encontrados, você poderá diferenciá-los examinando a QualificationData propriedade .

Confira também

• FindAddIns(Type, String, String[])