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
Object
MarshalByRefObject
Microsoft.VisualStudio.Modeling.Shell.DocData
Microsoft.VisualStudio.Modeling.Shell.SubordinateDocData
Namespace: Microsoft.VisualStudio.Modeling.Shell
Assembly: Microsoft.VisualStudio.Modeling.Sdk.Shell.11.0 (in Microsoft.VisualStudio.Modeling.Sdk.Shell.11.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 | |
|---|---|---|
.gif "Public method") |
SubordinateDocData | Creates a SubordinateDocData instance. |
Top
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
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.) |
.gif "Protected property") |
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 | |
|---|---|---|
.gif "Protected method") |
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 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.) |
|
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 | |
|---|---|---|
.gif "Public event") |
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 | |
|---|---|---|
.gif "Explicit interface implemetation") .gif "Private method") |
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.