IVsExtensionRepositoryQuery<T> Interface

Article
02/28/2011

Used to populate the list of available extensions in an extension manager.

Namespace: Microsoft.VisualStudio.ExtensionManager
Assembly: Microsoft.VisualStudio.ExtensionManager (in Microsoft.VisualStudio.ExtensionManager.dll)

Syntax

'Déclaration
Public Interface IVsExtensionRepositoryQuery(Of T As {New, IRepositoryEntry}) _
    Inherits IOrderedQueryable(Of T), IQueryable(Of T), IEnumerable(Of T),  _
    IOrderedQueryable, IQueryable, IEnumerable

public interface IVsExtensionRepositoryQuery<T> : IOrderedQueryable<T>, 
    IQueryable<T>, IEnumerable<T>, IOrderedQueryable, IQueryable, IEnumerable
where T : new(), IRepositoryEntry

generic<typename T>
where T : gcnew(), IRepositoryEntry
public interface class IVsExtensionRepositoryQuery : IOrderedQueryable<T>, 
    IQueryable<T>, IEnumerable<T>, IOrderedQueryable, IQueryable, IEnumerable

type IVsExtensionRepositoryQuery<'T when 'T : new() and IRepositoryEntry> =  
    interface
        interface IOrderedQueryable<'T>
        interface IQueryable<'T>
        interface IEnumerable<'T>
        interface IOrderedQueryable
        interface IQueryable
        interface IEnumerable
    end

JScript does not support generic types or methods.

Type Parameters

The IVsExtensionRepositoryQuery<T> type exposes the following members.

Properties

	Name	Description
	ElementType	Gets the type of the element(s) that are returned when the expression tree associated with this instance of IQueryable is executed. (Inherited from IQueryable.)
	Expression	Gets the expression tree that is associated with the instance of IQueryable. (Inherited from IQueryable.)
	Provider	Gets the query provider that is associated with this data source. (Inherited from IQueryable.)
	SearchText

Top

Methods

	Name	Description
	ExecuteAsync()	Asynchronously executes an IVsExtensionRepositoryQuery<T> query.
	ExecuteAsync(Object)	Asynchronously executes an IVsExtensionRepositoryQuery<T> query.
	GetEnumerator()	Returns an enumerator that iterates through the collection. (Inherited from IEnumerable<T>.)
	GetEnumerator()	Returns an enumerator that iterates through a collection. (Inherited from IEnumerable.)

Top

Events

	Name	Description
	ExecuteCompleted

Top

Remarks

Although this API supports the Extension Manager infrastructure, we recommend that you do not use it because it is subject to change.

This query is built by using LINQ syntax, through the IQueryable interface, to determine what extension properties to filter on. The query is then sent to the extension repository service, which queries the web service where the extensions are located and tries to translate the results into the requested object.

The IRepositoryEntry implementation should include properties that help to identify an extension to be downloaded, for example, title, date modified, and some category information. However, the extension repository service can only populate data that corresponds to key/value pairs that are offered by the web service that is associated with the extension gallery provider. For a partial list of properties that are supported by the extension repository service, see IRepositoryEntry.

Notes

The default extension gallery provider is Visual Studio Gallery

The results of the query are returned in the ExecuteCompleted() event as the Results property of the ExecuteCompletedEventArgs.

Partager via