GlobalObjectProviderFactory Class

Article
07/12/2014

Provides a base class for enumerating global object providers.

This API is not CLS-compliant. The CLS-compliant alternative is [None].

Inheritance Hierarchy

System.Object
System.MarshalByRefObject
Microsoft.VisualStudio.Shell.Design.GlobalObjectProviderFactory

Namespace: Microsoft.VisualStudio.Shell.Design
Assembly: Microsoft.VisualStudio.Shell.Design (in Microsoft.VisualStudio.Shell.Design.dll)

Syntax

'Declaration
<CLSCompliantAttribute(False)> _
<GuidAttribute("39FD482D-C76C-4dd4-9E06-FB7C52F69C8A")> _
Public MustInherit Class GlobalObjectProviderFactory _
    Inherits MarshalByRefObject

[CLSCompliantAttribute(false)]
[GuidAttribute("39FD482D-C76C-4dd4-9E06-FB7C52F69C8A")]
public abstract class GlobalObjectProviderFactory : MarshalByRefObject

[CLSCompliantAttribute(false)]
[GuidAttribute(L"39FD482D-C76C-4dd4-9E06-FB7C52F69C8A")]
public ref class GlobalObjectProviderFactory abstract : public MarshalByRefObject

[<AbstractClass>]
[<CLSCompliantAttribute(false)>]
[<GuidAttribute("39FD482D-C76C-4dd4-9E06-FB7C52F69C8A")>]
type GlobalObjectProviderFactory =  
    class 
        inherit MarshalByRefObject 
    end

public abstract class GlobalObjectProviderFactory extends MarshalByRefObject

The GlobalObjectProviderFactory type exposes the following members.

Constructors

	Name	Description
	GlobalObjectProviderFactory	Initializes an instance of the GlobalObjectProviderFactory class.

Top

Methods

	Name	Description
	CreateObjRef	Security Critical. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetLifetimeService	Security Critical. Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetProviders	Returns an array of all the currently available global object providers.
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	InitializeLifetimeService	Security Critical. Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object.)
	MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Remarks

The GlobalObjectProviderFactory class provides a mechanism for enumerating global object providers.

Design-time tools that are concerned only with accessing a list of current global objects or types instead typically use the GetGlobalObjects or GetGlobalTypes methods of the GlobalObjectService class.

There is a default implementation of this mechanism built into Microsoft Visual Studio design environment. This implementation looks in the registry for all available global object providers on each call; it does not cache any data. Custom project types may specify which global objects are returned by providing a class derived from GlobalObjectProviderFactory in their project context. This will preempt the service that is built into the design package.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Share via