SubordinateDocData Class

DocData object that represents a subordinate file in memory (represented as a child project item in the Solution Explorer).

This API is not CLS-compliant. 

Inheritance Hierarchy

System.Object
  System.MarshalByRefObject
    Microsoft.VisualStudio.Modeling.Shell.DocData
      Microsoft.VisualStudio.Modeling.Shell.SubordinateDocData

Namespace:  Microsoft.VisualStudio.Modeling.Shell
Assembly:  Microsoft.VisualStudio.Modeling.Sdk.Shell.12.0 (in Microsoft.VisualStudio.Modeling.Sdk.Shell.12.0.dll)

Syntax

'Declaration
<CLSCompliantAttribute(False)> _
Public Class SubordinateDocData _
    Inherits DocData

[CLSCompliantAttribute(false)]
public class SubordinateDocData : DocData

[CLSCompliantAttribute(false)]
public ref class SubordinateDocData : public DocData

[<CLSCompliantAttribute(false)>]
type SubordinateDocData =  
    class 
        inherit DocData 
    end

public class SubordinateDocData extends DocData

The SubordinateDocData type exposes the following members.

Constructors

	Name	Description
	SubordinateDocData	Creates a SubordinateDocData instance.

Top

Properties

	Name	Description
	Cookie	Gets the cookie that identifies the document in the Running Documents table. (Inherited from DocData.)
	DocViews	Gets the collection of document views that are open for the document. (Inherited from DocData.)
	Encoding	Gets or sets the encoding that persists the document. (Inherited from DocData.)
	FileName	Gets the file name of the document. (Inherited from DocData.)
	FormatList	(Overrides DocData.FormatList.)
	Hierarchy	Gets the project hierarchy to which the document belongs. (Inherited from DocData.)
	IsBackupFileObsolete	(Inherited from DocData.)
	IsLoaded	Gets the document and verifies whether it is loaded. (Inherited from DocData.)
	ItemId	Gets the Item ID that is assigned to the document. (Inherited from DocData.)
	ParentDocData	Retrieves the parent DocData for this subordinate document.
	ServiceProvider	Gets the service provider from the shell. (Inherited from DocData.)
	UndoManager	Gets the UndoManager interface for the document. (Inherited from DocData.)
	UndoManagerIsShared	Gets the document and verifies whether more than one document is sharing the same UndoManager interface. (Inherited from DocData.)
	VSUndoManager	Gets the UndoManager interface. (Inherited from DocData.)

Top

Methods

	Name	Description
	BackupFile	Make a single file backup of this document. Returns whether the document is expected to re-load without data loss. (Inherited from DocData.)
	CanSave	Verifies whether the user can cancel the save operation. (Inherited from DocData.)
	Close	Closes the document. (Inherited from DocData.)
	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.)
	DirectoryChanged	Not currently implemented. (Inherited from DocData.)
	Dispose	Releases the unmanaged resources used by the DocData and optionally releases the managed resources. (Inherited from DocData.)
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	FilesChanged	Notifies clients that one or more documents changed. (Inherited from DocData.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	FlushUndoManager	Clears the UndoManager. (Inherited from DocData.)
	GetClassID	Gets the GUID of the editor factory that created the document. (Inherited from DocData.)
	GetCurFile	Gets the file name of the document. (Inherited from DocData.)
	GetData	Gets the document data from a buffer. (Inherited from DocData.)
	GetFormatList	Gets the list of supported document formats. (Inherited from DocData.)
	GetGuidEditorType	Gets the GUID of the editor factory that created the IVsPersistDocData object. (Inherited from DocData.)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetLifetimeService	Security Critical. Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetService	Return the requested service. (Inherited from DocData.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	HandleLoadDocDataException	Manages any exceptions that were thrown when the document was loading. (Inherited from DocData.)
	HandleSaveDocDataException	Manages any exceptions that were thrown when the document was saving. (Inherited from DocData.)
	IgnoreFileChanges	Determines whether changes to the document should be ignored. (Inherited from DocData.)
	InitializeLifetimeService	Security Critical. Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	InitNew	Initializes the document. (Inherited from DocData.)
	IsDirty	Verifies whether the document has changed since the most recent save operation. (Inherited from DocData.)
	IsDocDataDirty	By default, the subordinate document is considered dirty if the parent is dirty. (Overrides DocData.IsDocDataDirty(Int32%).)
	IsDocDataReadOnly	Verifies whether the document is read-only. (Inherited from DocData.)
	IsDocDataReloadable	Verifies whether the document can be reloaded. (Inherited from DocData.)
	Load(String, Boolean)	Subordinate files are assumed to have some "parent" DocData object that handles actual serialization, so Load operation is a no-op. (Overrides DocData.Load(String, Boolean).)
	Load(String, UInt32, Int32)	Loads the document into memory. (Inherited from DocData.)
	LoadDocData(String)	Loads the document by using its file name. (Inherited from DocData.)
	LoadDocData(String, Boolean)	Loads the document by using its file name. (Inherited from DocData.)
	MarkDocumentChangedForBackup	Mark that the document has changed and thus a new backup should be created (Inherited from DocData.)
	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.)
	OnDocumentClosed	Alerts listeners that the document was closed. (Inherited from DocData.)
	OnDocumentClosing	Alerts listeners that the document will be closed. (Inherited from DocData.)
	OnDocumentLoaded	Alerts listeners that the document is loaded. (Inherited from DocData.)
	OnDocumentLoading	Alerts listeners that the document will be loaded. (Inherited from DocData.)
	OnDocumentReadOnlyChanged	Alerts listeners that the read-only state of the document has changed. (Inherited from DocData.)
	OnDocumentReloaded	Alerts listeners that the document has been reloaded. (Inherited from DocData.)
	OnDocumentReloading	Alerts listeners that the document will be reloaded. (Inherited from DocData.)
	OnDocumentSaved	Alerts listeners that the document has been saved. (Inherited from DocData.)
	OnDocumentSaving	Alerts listeners that the document will be saved. (Inherited from DocData.)
	OnFileNameChanged	Alerts listeners that the file name of the document has changed. (Inherited from DocData.)
	OnHierarchyChanged	Alerts listeners that the Item ID that is assigned to the document has changed. (Inherited from DocData.)
	OnRegisterDocData	Assigns the document to a cookie and project hierarchy. (Inherited from DocData.)
	OpenView	Opens a specific view for the document. (Inherited from DocData.)
	QueryEditFile()	Alerts listeners that a document is about to be edited. Listeners can vote against the edit. (Inherited from DocData.)
	QueryEditFile(String, tagVSQueryEditFlags)	Alerts listeners that a document is about to be edited. Listeners can vote against the edit. (Inherited from DocData.)
	QuerySaveFile()	Alerts listeners that a file is about to be saved. Listeners can (Inherited from DocData.)
	QuerySaveFile(String, tagVSQuerySaveFlags)	Alerts listeners that a file is about to be saved. (Inherited from DocData.)
	ReloadDocData	Reloads the document. (Inherited from DocData.)
	ReloadDocDataWorker	Reloads the document. (Inherited from DocData.)
	RenameDocData	Renames a document and resets its position in the hierarchy. (Inherited from DocData.)
	ResumeFileChangeNotification	Resumes the distribution of document-change notifications for the document. (Inherited from DocData.)
	Save(String)	Subordinate files are assumed to have some "parent" DocData object that usually handles actual serialization Save operation is a no-op except in the case of SaveAs. (Overrides DocData.Save(String).)
	Save(String, Int32, UInt32)	Saves the document. (Inherited from DocData.)
	SaveAs	Save as the doc data to a file
	SaveCompleted	Alerts listeners that the document has been saved. (Inherited from DocData.)
	SaveDocData	Saves the document to a specific location. (Inherited from DocData.)
	SaveDocDataToFile	Saves the document to a specific location. (Inherited from DocData.)
	SaveSubordinateFile	Save the specified document that is subordinate to this document, for example a diagram file. (Inherited from DocData.)
	SetData	Sets the document to a buffer. (Inherited from DocData.)
	SetDocDataDirty	Sets the document's IsDirty flag. (Inherited from DocData.)
	SetDocDataReadOnly	Sets the document's read-only flag. (Inherited from DocData.)
	SetFileName	Initializes or changes the file name for the document. (Inherited from DocData.)
	SetHierarchyInfo	Initializes or changes the project hierarchy for the document. (Inherited from DocData.)
	SetUntitledDocPath	Currently not implemented. (Inherited from DocData.)
	ShowSaveOptionsDlg	Shows a dialog box from which the user can specify additional options for save formats. (Inherited from DocData.)
	SuspendFileChangeNotification	Suspends the distribution of document-change notifications for the document. (Inherited from DocData.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Events

	Name	Description
	DocumentClosed	Occurs after the document is closed. (Inherited from DocData.)
	DocumentClosing	Occurs before the document is closed. (Inherited from DocData.)
	DocumentLoaded	Occurs after the document has been loaded in the modeling window. (Inherited from DocData.)
	DocumentLoading	Occurs before the document is loaded in the modeling window. (Inherited from DocData.)
	DocumentReadOnlyChanged	Occurs when the read-only flag for the document changes. (Inherited from DocData.)
	DocumentReloaded	Occurs after the document is reloaded. (Inherited from DocData.)
	DocumentReloading	Occurs before the document is reloaded. (Inherited from DocData.)
	DocumentSaved	Occurs after the document is saved. (Inherited from DocData.)
	DocumentSaving	Occurs before the document is saved. (Inherited from DocData.)
	FileNameChanged	Occurs when the document's file name changes. (Inherited from DocData.)
	HierarchyChanged	Occurs when the document's hierarchy or Item ID changes. (Inherited from DocData.)

Top

Explicit Interface Implementations

	Name	Description
	IVsFileBackup.BackupFile	Make a single file backup of this document. (Inherited from DocData.)
	IDisposable.Dispose	Releases all resources used by the current instance of the DocData class. (Inherited from DocData.)
	IPersistFileFormat.GetClassID	Gets the class ID of the editor factory that created the document. (Inherited from DocData.)
	IVsFileBackup.IsBackupFileObsolete	Get whether the backup file is up to date. (Inherited from DocData.)

Top

Remarks

Subordinate files are assumed to have some "parent" DocData object that handles actual serialization. This class exists so that the subordinate file can be registered in the VS Running Documents Table and tracked by the VS shell.

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.

See Also

Reference

Microsoft.VisualStudio.Modeling.Shell Namespace