mirror of
https://github.com/danbulant/Cosmos
synced 2026-05-19 12:30:32 +00:00
531 lines
20 KiB
C#
531 lines
20 KiB
C#
/********************************************************************************************
|
||
|
||
Copyright (c) Microsoft Corporation
|
||
All rights reserved.
|
||
|
||
Microsoft Public License:
|
||
|
||
This license governs use of the accompanying software. If you use the software, you
|
||
accept this license. If you do not accept the license, do not use the software.
|
||
|
||
1. Definitions
|
||
The terms "reproduce," "reproduction," "derivative works," and "distribution" have the
|
||
same meaning here as under U.S. copyright law.
|
||
A "contribution" is the original software, or any additions or changes to the software.
|
||
A "contributor" is any person that distributes its contribution under this license.
|
||
"Licensed patents" are a contributor's patent claims that read directly on its contribution.
|
||
|
||
2. Grant of Rights
|
||
(A) Copyright Grant- Subject to the terms of this license, including the license conditions
|
||
and limitations in section 3, each contributor grants you a non-exclusive, worldwide,
|
||
royalty-free copyright license to reproduce its contribution, prepare derivative works of
|
||
its contribution, and distribute its contribution or any derivative works that you create.
|
||
(B) Patent Grant- Subject to the terms of this license, including the license conditions
|
||
and limitations in section 3, each contributor grants you a non-exclusive, worldwide,
|
||
royalty-free license under its licensed patents to make, have made, use, sell, offer for
|
||
sale, import, and/or otherwise dispose of its contribution in the software or derivative
|
||
works of the contribution in the software.
|
||
|
||
3. Conditions and Limitations
|
||
(A) No Trademark License- This license does not grant you rights to use any contributors'
|
||
name, logo, or trademarks.
|
||
(B) If you bring a patent claim against any contributor over patents that you claim are
|
||
infringed by the software, your patent license from such contributor to the software ends
|
||
automatically.
|
||
(C) If you distribute any portion of the software, you must retain all copyright, patent,
|
||
trademark, and attribution notices that are present in the software.
|
||
(D) If you distribute any portion of the software in source code form, you may do so only
|
||
under this license by including a complete copy of this license with your distribution.
|
||
If you distribute any portion of the software in compiled or object code form, you may only
|
||
do so under a license that complies with this license.
|
||
(E) The software is licensed "as-is." You bear the risk of using it. The contributors give
|
||
no express warranties, guarantees or conditions. You may have additional consumer rights
|
||
under your local laws which this license cannot change. To the extent permitted under your
|
||
local laws, the contributors exclude the implied warranties of merchantability, fitness for
|
||
a particular purpose and non-infringement.
|
||
|
||
********************************************************************************************/
|
||
|
||
using System;
|
||
using System.Globalization;
|
||
using System.IO;
|
||
using System.Runtime.InteropServices;
|
||
using EnvDTE;
|
||
using Microsoft.VisualStudio;
|
||
using Microsoft.VisualStudio.Shell.Interop;
|
||
|
||
namespace Microsoft.VisualStudio.Project.Automation
|
||
{
|
||
[ComVisible(true)]
|
||
public class OAProject : EnvDTE.Project, EnvDTE.ISupportVSProperties
|
||
{
|
||
#region fields
|
||
private ProjectNode project;
|
||
EnvDTE.ConfigurationManager configurationManager;
|
||
#endregion
|
||
|
||
#region properties
|
||
public ProjectNode Project
|
||
{
|
||
get { return this.project; }
|
||
}
|
||
#endregion
|
||
|
||
#region ctor
|
||
public OAProject(ProjectNode project)
|
||
{
|
||
this.project = project;
|
||
}
|
||
#endregion
|
||
|
||
#region EnvDTE.Project
|
||
/// <summary>
|
||
/// Gets or sets the name of the object.
|
||
/// </summary>
|
||
public virtual string Name
|
||
{
|
||
get
|
||
{
|
||
return project.Caption;
|
||
}
|
||
set
|
||
{
|
||
if(this.project == null || this.project.Site == null || this.project.IsClosed)
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
UIThread.DoOnUIThread(delegate()
|
||
{
|
||
using (AutomationScope scope = new AutomationScope(this.project.Site))
|
||
{
|
||
project.SetEditLabel(value);
|
||
}
|
||
});
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Microsoft Internal Use Only. Gets the file name of the project.
|
||
/// </summary>
|
||
public virtual string FileName
|
||
{
|
||
get
|
||
{
|
||
return project.ProjectFile;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Microsoft Internal Use Only. Specfies if the project is dirty.
|
||
/// </summary>
|
||
public virtual bool IsDirty
|
||
{
|
||
get
|
||
{
|
||
int dirty;
|
||
|
||
ErrorHandler.ThrowOnFailure(project.IsDirty(out dirty));
|
||
return dirty != 0;
|
||
}
|
||
set
|
||
{
|
||
if(this.project == null || this.project.Site == null || this.project.IsClosed)
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
UIThread.DoOnUIThread(delegate()
|
||
{
|
||
using (AutomationScope scope = new AutomationScope(this.project.Site))
|
||
{
|
||
project.SetProjectFileDirty(value);
|
||
}
|
||
});
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the Projects collection containing the Project object supporting this property.
|
||
/// </summary>
|
||
public virtual EnvDTE.Projects Collection
|
||
{
|
||
get { return null; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the top-level extensibility object.
|
||
/// </summary>
|
||
public virtual EnvDTE.DTE DTE
|
||
{
|
||
get
|
||
{
|
||
return (EnvDTE.DTE)this.project.Site.GetService(typeof(EnvDTE.DTE));
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets a GUID string indicating the kind or type of the object.
|
||
/// </summary>
|
||
public virtual string Kind
|
||
{
|
||
get { return project.ProjectGuid.ToString("B"); }
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets a ProjectItems collection for the Project object.
|
||
/// </summary>
|
||
public virtual EnvDTE.ProjectItems ProjectItems
|
||
{
|
||
get
|
||
{
|
||
return new OAProjectItems(this, project);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets a collection of all properties that pertain to the Project object.
|
||
/// </summary>
|
||
public virtual EnvDTE.Properties Properties
|
||
{
|
||
get
|
||
{
|
||
return new OAProperties(this.project.NodeProperties);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Returns the name of project as a relative path from the directory containing the solution file to the project file
|
||
/// </summary>
|
||
/// <value>Unique name if project is in a valid state. Otherwise null</value>
|
||
public virtual string UniqueName
|
||
{
|
||
get
|
||
{
|
||
if(this.project == null || this.project.IsClosed)
|
||
{
|
||
return null;
|
||
}
|
||
else
|
||
{
|
||
return UIThread.DoOnUIThread(delegate()
|
||
{
|
||
// Get Solution service
|
||
IVsSolution solution = this.project.GetService(typeof(IVsSolution)) as IVsSolution;
|
||
if (solution == null)
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
// Ask solution for unique name of project
|
||
string uniqueName = string.Empty;
|
||
ErrorHandler.ThrowOnFailure(solution.GetUniqueNameOfProject(this.project.InteropSafeIVsHierarchy, out uniqueName));
|
||
return uniqueName;
|
||
});
|
||
}
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets an interface or object that can be accessed by name at run time.
|
||
/// </summary>
|
||
public virtual object Object
|
||
{
|
||
get { return this.project.Object; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the requested Extender object if it is available for this object.
|
||
/// </summary>
|
||
/// <param name="name">The name of the extender object.</param>
|
||
/// <returns>An Extender object. </returns>
|
||
public virtual object get_Extender(string name)
|
||
{
|
||
return null;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets a list of available Extenders for the object.
|
||
/// </summary>
|
||
public virtual object ExtenderNames
|
||
{
|
||
get { return null; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the Extender category ID (CATID) for the object.
|
||
/// </summary>
|
||
public virtual string ExtenderCATID
|
||
{
|
||
get { return String.Empty; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the full path and name of the Project object's file.
|
||
/// </summary>
|
||
public virtual string FullName
|
||
{
|
||
get
|
||
{
|
||
return UIThread.DoOnUIThread(delegate()
|
||
{
|
||
string filename;
|
||
uint format;
|
||
ErrorHandler.ThrowOnFailure(project.GetCurFile(out filename, out format));
|
||
return filename;
|
||
});
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets or sets a value indicatingwhether the object has not been modified since last being saved or opened.
|
||
/// </summary>
|
||
public virtual bool Saved
|
||
{
|
||
get
|
||
{
|
||
return !this.IsDirty;
|
||
}
|
||
set
|
||
{
|
||
if(this.project == null || this.project.Site == null || this.project.IsClosed)
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
UIThread.DoOnUIThread(delegate()
|
||
{
|
||
using (AutomationScope scope = new AutomationScope(this.project.Site))
|
||
{
|
||
project.SetProjectFileDirty(!value);
|
||
}
|
||
});
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the ConfigurationManager object for this Project .
|
||
/// </summary>
|
||
public virtual EnvDTE.ConfigurationManager ConfigurationManager
|
||
{
|
||
get
|
||
{
|
||
return UIThread.DoOnUIThread(delegate()
|
||
{
|
||
if (this.configurationManager == null)
|
||
{
|
||
IVsExtensibility3 extensibility = this.project.Site.GetService(typeof(IVsExtensibility)) as IVsExtensibility3;
|
||
|
||
if (extensibility == null)
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
object configurationManagerAsObject;
|
||
ErrorHandler.ThrowOnFailure(extensibility.GetConfigMgr(this.project.InteropSafeIVsHierarchy, VSConstants.VSITEMID_ROOT, out configurationManagerAsObject));
|
||
|
||
if (configurationManagerAsObject == null)
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
else
|
||
{
|
||
this.configurationManager = (ConfigurationManager)configurationManagerAsObject;
|
||
}
|
||
}
|
||
|
||
return this.configurationManager;
|
||
});
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the Globals object containing add-in values that may be saved in the solution (.sln) file, the project file, or in the user's profile data.
|
||
/// </summary>
|
||
public virtual EnvDTE.Globals Globals
|
||
{
|
||
get { return null; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets a ProjectItem object for the nested project in the host project.
|
||
/// </summary>
|
||
public virtual EnvDTE.ProjectItem ParentProjectItem
|
||
{
|
||
get { return null; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the CodeModel object for the project.
|
||
/// </summary>
|
||
public virtual EnvDTE.CodeModel CodeModel
|
||
{
|
||
get { return null; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// Saves the project.
|
||
/// </summary>
|
||
/// <param name="fileName">The file name with which to save the solution, project, or project item. If the file exists, it is overwritten</param>
|
||
/// <exception cref="InvalidOperationException">Is thrown if the save operation failes.</exception>
|
||
/// <exception cref="ArgumentNullException">Is thrown if fileName is null.</exception>
|
||
public virtual void SaveAs(string fileName)
|
||
{
|
||
this.DoSave(true, fileName);
|
||
}
|
||
|
||
/// <summary>
|
||
/// Saves the project
|
||
/// </summary>
|
||
/// <param name="fileName">The file name of the project</param>
|
||
/// <exception cref="InvalidOperationException">Is thrown if the save operation failes.</exception>
|
||
/// <exception cref="ArgumentNullException">Is thrown if fileName is null.</exception>
|
||
public virtual void Save(string fileName)
|
||
{
|
||
this.DoSave(false, fileName);
|
||
}
|
||
|
||
/// <summary>
|
||
/// Removes the project from the current solution.
|
||
/// </summary>
|
||
public virtual void Delete()
|
||
{
|
||
if(this.project == null || this.project.Site == null || this.project.IsClosed)
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
UIThread.DoOnUIThread(delegate()
|
||
{
|
||
using (AutomationScope scope = new AutomationScope(this.project.Site))
|
||
{
|
||
this.project.Remove(false);
|
||
}
|
||
});
|
||
}
|
||
#endregion
|
||
|
||
#region ISupportVSProperties methods
|
||
/// <summary>
|
||
/// Microsoft Internal Use Only.
|
||
/// </summary>
|
||
public virtual void NotifyPropertiesDelete()
|
||
{
|
||
}
|
||
#endregion
|
||
|
||
#region private methods
|
||
/// <summary>
|
||
/// Saves or Save Asthe project.
|
||
/// </summary>
|
||
/// <param name="isCalledFromSaveAs">Flag determining which Save method called , the SaveAs or the Save.</param>
|
||
/// <param name="fileName">The name of the project file.</param>
|
||
private void DoSave(bool isCalledFromSaveAs, string fileName)
|
||
{
|
||
if(fileName == null)
|
||
{
|
||
throw new ArgumentNullException("fileName");
|
||
}
|
||
|
||
if(this.project == null || this.project.Site == null || this.project.IsClosed)
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
UIThread.DoOnUIThread(delegate()
|
||
{
|
||
using (AutomationScope scope = new AutomationScope(this.project.Site))
|
||
{
|
||
// If an empty file name is passed in for Save then make the file name the project name.
|
||
if (!isCalledFromSaveAs && string.IsNullOrEmpty(fileName))
|
||
{
|
||
// Use the solution service to save the project file. Note that we have to use the service
|
||
// so that all the shell's elements are aware that we are inside a save operation and
|
||
// all the file change listenters registered by the shell are suspended.
|
||
|
||
// Get the cookie of the project file from the RTD.
|
||
IVsRunningDocumentTable rdt = this.project.Site.GetService(typeof(SVsRunningDocumentTable)) as IVsRunningDocumentTable;
|
||
if (null == rdt)
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
IVsHierarchy hier;
|
||
uint itemid;
|
||
IntPtr unkData;
|
||
uint cookie;
|
||
ErrorHandler.ThrowOnFailure(rdt.FindAndLockDocument((uint)_VSRDTFLAGS.RDT_NoLock, this.project.Url, out hier,
|
||
out itemid, out unkData, out cookie));
|
||
if (IntPtr.Zero != unkData)
|
||
{
|
||
Marshal.Release(unkData);
|
||
}
|
||
|
||
// Verify that we have a cookie.
|
||
if (0 == cookie)
|
||
{
|
||
// This should never happen because if the project is open, then it must be in the RDT.
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
// Get the IVsHierarchy for the project.
|
||
IVsHierarchy prjHierarchy = project.InteropSafeIVsHierarchy;
|
||
|
||
// Now get the solution.
|
||
IVsSolution solution = this.project.Site.GetService(typeof(SVsSolution)) as IVsSolution;
|
||
// Verify that we have both solution and hierarchy.
|
||
if ((null == prjHierarchy) || (null == solution))
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
ErrorHandler.ThrowOnFailure(solution.SaveSolutionElement((uint)__VSSLNSAVEOPTIONS.SLNSAVEOPT_SaveIfDirty, prjHierarchy, cookie));
|
||
}
|
||
else
|
||
{
|
||
|
||
// We need to make some checks before we can call the save method on the project node.
|
||
// This is mainly because it is now us and not the caller like in case of SaveAs or Save that should validate the file name.
|
||
// The IPersistFileFormat.Save method only does a validation that is necesseray to be performed. Example: in case of Save As the
|
||
// file name itself is not validated only the whole path. (thus a file name like file\file is accepted, since as a path is valid)
|
||
|
||
// 1. The file name has to be valid.
|
||
string fullPath = fileName;
|
||
try
|
||
{
|
||
if (!Path.IsPathRooted(fileName))
|
||
{
|
||
fullPath = Path.Combine(this.project.ProjectFolder, fileName);
|
||
}
|
||
}
|
||
// We want to be consistent in the error message and exception we throw. fileName could be for example #<23>&%"<22>&"% and that would trigger an ArgumentException on Path.IsRooted.
|
||
catch (ArgumentException)
|
||
{
|
||
throw new InvalidOperationException(SR.GetString(SR.ErrorInvalidFileName, CultureInfo.CurrentUICulture));
|
||
}
|
||
|
||
// It might be redundant but we validate the file and the full path of the file being valid. The SaveAs would also validate the path.
|
||
// If we decide that this is performance critical then this should be refactored.
|
||
Utilities.ValidateFileName(this.project.Site, fullPath);
|
||
|
||
if (!isCalledFromSaveAs)
|
||
{
|
||
// 2. The file name has to be the same
|
||
if (!NativeMethods.IsSamePath(fullPath, this.project.Url))
|
||
{
|
||
throw new InvalidOperationException();
|
||
}
|
||
|
||
ErrorHandler.ThrowOnFailure(this.project.Save(fullPath, 1, 0));
|
||
}
|
||
else
|
||
{
|
||
ErrorHandler.ThrowOnFailure(this.project.Save(fullPath, 0, 0));
|
||
}
|
||
}
|
||
}
|
||
});
|
||
}
|
||
#endregion
|
||
}
|
||
}
|