Proje dosyalarına veri kaydetme

Proje alt türü, proje dosyasına alt türe özgü verileri kaydedebilir ve alabilir. Yönetilen Paket Çerçevesi (MPF), bu görevi gerçekleştirmek için iki arabirim sağlar:

• Arabirimi, IVsBuildPropertyStorage proje dosyasının MSBuild bölümünden özellik değerlerine erişmeye olanak tanır. tarafından IVsBuildPropertyStorage sağlanan yöntemler, kullanıcının derlemeyle ilgili verileri yüklemesi veya kaydetmesi gerektiğinde herhangi bir kullanıcı tarafından çağrılabilir.

• , IPersistXMLFragment derlemeyle ilgili olmayan verileri serbest biçimli XML'de kalıcı hale getirmek için kullanılır. tarafından IPersistXMLFragment sağlanan yöntemler, Visual Studio'da derlemeyle ilgili olmayan verilerin proje dosyasında kalıcı olması gerektiğinde Visual Studio tarafından çağrılır.

  Derleme ve derlemeyle ilgili olmayan verileri kalıcı hale getirmek hakkında daha fazla bilgi için bkz . MSBuild proje dosyasında verileri kalıcı hale getirmek.

Derlemeyle ilgili verileri kaydetme ve alma

Derlemeyle ilgili verileri proje dosyasına kaydetmek için

• Proje dosyasının SetPropertyValue tam yolunu kaydetmek için yöntemini çağırın.

  private SpecializedProject project;
  IVsBuildPropertyStorage projectStorage = (IVsBuildPropertyStorage)project;
  string newFullPath = GetNewFullPath();
  // Set a full path of the project file.
  ErrorHandler.ThrowOnFailure(projectStorage.SetPropertyValue(
      "MSBuildProjectDirectory",
      String.Empty,
      (uint)_PersistStorageType.PST_PROJECT_FILE, newFullPath));
  

Proje dosyasından derlemeyle ilgili verileri almak için

• Proje dosyasının GetPropertyValue tam yolunu almak için yöntemini çağırın.

  private SpecializedProject project;
  IVsBuildPropertyStorage projectStorage = (IVsBuildPropertyStorage)project;
  string fullPath;
  // Get a full path of the project file.
  ErrorHandler.ThrowOnFailure(projectStorage.GetPropertyValue(
      "MSBuildProjectDirectory",
      String.Empty,
      (uint)_PersistStorageType.PST_PROJECT_FILE, out fullPath));
  

Derlemeyle ilgili olmayan verileri kaydetme ve alma

Derlemeyle ilgili olmayan verileri proje dosyasına kaydetmek için

1. Xml parçasının IsFragmentDirty geçerli dosyasına son kaydedildiğinden bu yana değişip değişmediğini belirlemek için yöntemini uygulayın.

   public int IsFragmentDirty(uint storage, out int pfDirty)
   {
       pfDirty = 0;
       switch (storage)
       {
           case (uint)_PersistStorageType.PST_PROJECT_FILE:
           {
               if (isDirty)
                   pfDirty |= 1;
               break;
           }
           case (uint)_PersistStorageType.PST_USER_FILE:
           {
               // We do not store anything in the user file.
               break;
           }
       }
   
       // Forward the call to inner flavor(s)
       if (pfDirty == 0 && innerCfg != null && this.innerCfg is IPersistXMLFragment)
           return ((IPersistXMLFragment)this.innerCfg).IsFragmentDirty(storage, out pfDirty);
   
       return VSConstants.S_OK;
   
   }
   

2. Save XML verilerini proje dosyasına kaydetmek için yöntemini uygulayın.

   public int Save(ref Guid guidFlavor, uint storage, out string pbstrXMLFragment, int fClearDirty)
   {
       pbstrXMLFragment = null;
   
       if (IsMyFlavorGuid(ref guidFlavor))
       {
           switch (storage)
           {
               case (uint)_PersistStorageType.PST_PROJECT_FILE:
               {
                   // Create XML for our data.
                   XmlDocument doc = new XmlDocument();
                   XmlNode root = doc.CreateElement(this.GetType().Name);
   
                   XmlNode node = doc.CreateElement(targetsTag);
                   node.AppendChild(doc.CreateTextNode(this.TargetsToExecute));
                   root.AppendChild(node);
   
                   node = doc.CreateElement(updateTargetsTag);
                   node.AppendChild(doc.CreateTextNode(this.UpdateTargetList.ToString()));
                   root.AppendChild(node);
   
                   doc.AppendChild(root);
                   // Get XML fragment representing our data
                   pbstrXMLFragment = doc.InnerXml;
   
                   if (fClearDirty != 0)
                       isDirty = false;
                   break;
               }
               case (uint)_PersistStorageType.PST_USER_FILE:
               {
                   // We do not store anything in the user file.
                   break;
               }
           }
       }
   
       // Forward the call to inner flavor(s)
       if (this.innerCfg != null && this.innerCfg is IPersistXMLFragment)
           return ((IPersistXMLFragment)this.innerCfg).Save(ref guidFlavor, storage, out pbstrXMLFragment, fClearDirty);
   
       return VSConstants.S_OK;
   }
   

Proje dosyasında derlemeyle ilgili olmayan verileri almak için

1. InitNew Proje uzantısı özelliklerini ve derlemeden bağımsız diğer verileri başlatmak için yöntemini uygulayın. Proje dosyasında XML yapılandırma verileri yoksa bu yöntem çağrılır.

   public int InitNew(ref Guid guidFlavor, uint storage)
   {
       //Return,if it is our guid.
       if (IsMyFlavorGuid(ref guidFlavor))
           return VSConstants.S_OK;
   
       //Forward the call to inner flavor(s).
       if (this.innerCfg != null && this.innerCfg is IPersistXMLFragment)
           return ((IPersistXMLFragment)this.innerCfg).InitNew(ref guidFlavor, storage);
   
       return VSConstants.S_OK;
   

2. Proje dosyasından Load XML verilerini yüklemek için yöntemini uygulayın.

   public int Load(ref Guid guidFlavor, uint storage, string pszXMLFragment)
   {
       if (IsMyFlavorGuid(ref guidFlavor))
       {
           switch (storage)
           {
               case (uint)_PersistStorageType.PST_PROJECT_FILE:
               {
                   // Load our data from the XML fragment.
                   XmlDocument doc = new XmlDocument();
                   XmlNode node = doc.CreateElement(this.GetType().Name);
                   node.InnerXml = pszXMLFragment;
                   if (node == null
                       || node.FirstChild == null
                       || node.FirstChild.ChildNodes.Count == 0
                       || node.FirstChild.ChildNodes[0].Name != targetsTag)
                       break;
                   this.TargetsToExecute = node.FirstChild.ChildNodes[0].InnerText;
   
                   if (node.FirstChild.ChildNodes.Count <= 1
                       || node.FirstChild.ChildNodes[1].Name != updateTargetsTag)
                       break;
                   this.UpdateTargetList = bool.Parse(node.FirstChild.ChildNodes[1].InnerText);
                   break;
               }
               case (uint)_PersistStorageType.PST_USER_FILE:
               {
                   // We do not store anything in the user file.
                   break;
               }
           }
       }
   
       // Forward the call to inner flavor(s)
       if (this.innerCfg != null && this.innerCfg is IPersistXMLFragment)
           return ((IPersistXMLFragment)this.innerCfg).Load(ref guidFlavor, storage, pszXMLFragment);
   
       return VSConstants.S_OK;
   }
   

Not

Bu konuda sağlanan tüm kod örnekleri VSSDK örneklerinde daha büyük bir örneğin parçalarıdır.

İlgili içerik

• MSBuild proje dosyasındaki verileri kalıcı hale