Microsoft.VisualStudio.Tools.Applications.Runtime Namespace (2007 System)

  • Article

The Microsoft.VisualStudio.Tools.Applications.Runtime namespace contains classes that support data caching in documents, and classes that are part of the Visual Studio Tools for Office runtime.

The Microsoft.VisualStudio.Tools.Applications.Runtime namespace contains the following classes:

  • CachedAttribute. Use this attribute to add an object in a document-level customization to the data cache in the document. For more information, see Caching Data.

  • The ICachedType interface. You can optionally implement this interface on objects that you add to the data cache in a document. Implement this interface if you want to gain greater control over the caching behavior of the object.

  • Exceptions that can be thrown by the Visual Studio Tools for Office runtime.

  • Other classes that are part of the Visual Studio Tools for Office infrastructure, and are not intended to be used directly by your code.

Classes

  Class Description
Public class AddInException The exception that is thrown when an exception is passed between an add-in and the host application.
Public class CacheAlreadyLoadedException The exception that is thrown when a document-level customization attempts to load the data cache in a document after the data cache has already been loaded.
Public class CachedAttribute Instructs the Visual Studio Tools for Office runtime to add the specified data object to the data cache in the document.
Public class CachedDataCouldNotBeSerializedException The exception that is thrown when an attempt to serialize cached data in a document-level customization fails.
Public class CachedDataTypeMismatchException The exception that is thrown when the XML serialized state of an object in the data cache does not match the type information for the object in the cached data manifest.
Public class CannotCacheInNonStartupException This exception is not used by the Microsoft Visual Studio Tools for the Microsoft Office system (version 3.0 Runtime). It is included in this version of the runtime to maintain compatibility with code that was compiled using earlier versions of the runtime.
Public class CannotCreateCustomizationDomainException The exception that is thrown when an application domain cannot be created and the assembly for a Visual Studio Tools for Office solution cannot be loaded.
Public class CannotCreateStartupObjectException The exception that is thrown when a host item class in a Visual Studio Tools for Office solution assembly cannot be instantiated.
Public class CannotFindMemberException The exception that is thrown when you try to programmatically add or remove an object from the data cache in a document-level customization, but the specified object is not declared in the specified host item class.
Public class CannotFindObjectToFillException The exception that is thrown when the Visual Studio Tools for Office runtime cannot locate an object in the data cache of a document-level customization.
Public class CannotFindStartupObjectAssemblyException This exception is not used by the Microsoft Visual Studio Tools for the Microsoft Office system (version 3.0 Runtime). It is included in this version of the runtime to maintain compatibility with code that was compiled using earlier versions of the runtime.
Public class CannotLoadManifestException The exception that is thrown when the manifest in the document cannot be loaded.
Public class CannotRetrieveAppInfoException Infrastructure.
Public class CannotRetrieveCachedDataException The exception that is thrown when the cached data in the document is corrupted or missing.
Public class ControlCouldNotBeInitializedException The exception that is thrown when a control that was added to a document-level customization by using the controls collection of the document could not be initialized.
Public class ControlNotFoundException The exception that is thrown when an attempt is made to reference a control in a document-level customization by using the controls collection of the document, but the control does not exist.
Public class DocumentAlreadyCustomizedException The exception that is thrown when you attempt to attach a customization to a document that is already part of a document-level customization that was created by using Visual Studio Tools for Office.
Public class DocumentAlreadyLoadedException Infrastructure.
Public class DocumentClosedException The exception that is thrown when you attempt to perform an operation using the ServerDocument class on a closed document.
Public class DocumentCustomizedWithPreviousRuntimeException The exception that is thrown when you attempt to use the ServerDocument class to perform an operation on a document that is part of a document-level customization that was created by using an earlier version of Visual Studio Tools for Office.
Public class DocumentNotCustomizedException The exception that is thrown when you try to perform an invalid operation on a document by using the ServerDocument class.
Public class DocumentNotLoadedException Infrastructure.
Public class HostAssemblyAttribute Specifies that the assembly in which this attribute appears contains proxy types for the types exposed by the host application.
Public class HostEventAttribute Relates an event in a proxy type to an event in the host application.
Public class HostMemberAttribute Sets the way that methods and properties in the proxy are bound to the corresponding members in the host application's object model.
Public class HostTypeAttribute Specifies the relationship between a type and its canonical name.
Public class InvalidDeployManifestException This exception is not used by the Microsoft Visual Studio Tools for the Microsoft Office system (version 3.0 Runtime). It is included in this version of the runtime to maintain compatibility with code that was compiled using earlier versions of the runtime.
Public class InvalidManifestException This exception is thrown when the application manifest or cached data manifest for the Visual Studio Tools for Office solution is not valid.
Public class InvalidNewApplicationManifestException This exception is not used by the Microsoft Visual Studio Tools for the Microsoft Office system (version 3.0 Runtime). It is included in this version of the runtime to maintain compatibility with code that was compiled using earlier versions of the runtime.
Public class ItemAlreadyInCacheException The exception that is thrown when an attempt is made to add an item to the data cache in a document-level customization, but the item already exists in the cache.
Public class ItemNotInCacheException The exception that is thrown when an attempt is made to retrieve an item from the data cache in a document-level customization, but the item does not exist.
Public class ManifestNotExecutedException Infrastructure.
Public class MissingDataIdException The exception that is thrown when a ServerDocument object is saved while the cached data manifest contains a CachedDataItem with an Id property that is nulla null reference (Nothing in Visual Basic) or an empty string.
Public class MissingHostItemIdException The exception that is thrown when a ServerDocument object is saved while the cached data manifest contains a CachedDataHostItem with an Id property that is nulla null reference (Nothing in Visual Basic) or an empty string.
Public class MissingTypeException The exception that is thrown when a ServerDocument object is saved while the cached data manifest contains a CachedDataItem with a DataType property that is nulla null reference (Nothing in Visual Basic) or an empty string.
Public class MultipleCachedDataCouldNotBeSerializedException The exception that is thrown when more than one cached data object could not be serialized in a document-level customization.
Public class NonCacheableTypeException The exception that is thrown when an attempt is made to cache an object in a document-level customization, but the type of the object is not a DataSet, DataTable, or a type that meets the requirements specified in Caching Data.
Public class NoStartupObjectsException This exception is thrown when a Visual Studio Tools for Office solution assembly does not contain a startup object.
Public class NotAvailableOfflineException This exception is not used by the Microsoft Visual Studio Tools for the Microsoft Office system (version 3.0 Runtime). It is included in this version of the runtime to maintain compatibility with code that was compiled using earlier versions of the runtime.
Public class NotAvailableOnlineException This exception is not used by the Microsoft Visual Studio Tools for the Microsoft Office system (version 3.0 Runtime). It is included in this version of the runtime to maintain compatibility with code that was compiled using earlier versions of the runtime.
Public class RuntimeException Provides the base class for exceptions in Visual Studio Tools for Office runtime.
Public class SafeArrayDefaultRankAttribute Defines the default rank of an array.
Public class StartupObjectAttribute Infrastructure.
Public class UnknownCustomizationFileException The exception that is thrown when you pass a file with an extension that is not supported by Visual Studio Tools for Office to a ServerDocument constructor or method.
Public class UpdateFailedException This exception is not used by the Microsoft Visual Studio Tools for the Microsoft Office system (version 3.0 Runtime). It is included in this version of the runtime to maintain compatibility with code that was compiled using earlier versions of the runtime.

Interfaces

  Interface Description
Public interface IActionsPaneSite Infrastructure.
Public interface IActivatable Infrastructure.
Public interface IAppInfo Infrastructure.
Public interface IAppInfoDocument Infrastructure.
Public interface ICachedDataProvider Infrastructure.
Public interface ICachedType Customizes the caching behavior of a type in document-level customizations created by using Visual Studio Tools for Office.
Public interface IComAddInAutomationServiceProviderCallback Infrastructure.
Public interface IComReferenceRelease Infrastructure.
Public interface IEntryPoint Provides a handle to the add-in for the host application, enables you to provide discrete initialization steps for an add-in, and enables you to release resources when an add-in shuts down.
Public interface IExtendedEntryPoint Extends IEntryPoint to enable the host application to get a handle to the add-in object.
Public interface IHostItem Infrastructure.
Public interface IHostItemProvider Provides access to host item objects that are requested by the add-in.
Public interface IHostItemProviderExtended Infrastructure.
Public interface IHostTypeProvider Enables the add-in to obtain types from the host application's object model, which can then be used to invoke static members.
Public interface IRegisterActivationCallback Infrastructure.
Public interface IServiceProviderCallback Infrastructure.
Public interface ITypeMapProvider Enables mapping between the proxy type the add-in uses and the actual host type in the host application.

Enumerations

  Enumeration Description
Public enumeration HostEventMethodType Indicates the type of the method in the host application that corresponds to a method in an add-in.

See Also

Reference

Other Resources

Caching Data