Sanal yol saðlayýcýsý dinamik olarak yüklemek için nasýl kullanýlacaðý ve sanal yollarýn ASP.NET 2. 0'da derleme içeriði

Var sayýlma ve Hoþ Geldiniz arka! Benim Parag Agarwal, Microsoft'ta bir destek mühendisine adýdýr. Bu ay size Microsoft ASP.NET 2. 0'daki sanal yol saðlayýcýsý tartýþmak için kullanacaðýnýz.

GENEL BAKIÞ

Bu ay nasýl içerik ve derleme, ASP.NET 2.0 dosyalarý sanal bir eriþim saðlayarak, ASP.NET'in geniþletileceðini tartýþýlacaktýr. Bu özellik, uygulamalar, içerik yerine fiziksel dosya sistemindeki bir veritabanýnda depolanýr, Microsoft SharePoint Portal Server, benzer oluþturmak için kullanýlabilir. Bu makalede, istenen Web form sayfasý içeriðini bir Microsoft SQL Server veritabanýnda depolandýðý bir örnek oluþturur.

Sanal yol saðlayýcýsý

Bir sanal yol saðlayýcýsý ile ASP.NET derleme sistemine sanal içerik için biz geniþletebilirsiniz bir düzenek saðlar. Örneðin, bir sanal yol saðlayýcýsý, dosya sistemi dýþýndaki konumlardan içerik kaynaðý için bir yol saðlar. Sanal içerik saðlamak isteyen geliþtiriciler, aþaðýdaki görevleri gerçekleþtirmelisiniz:

• VirtualPathProvider bir sýnýf oluþturmak ve dosya ve klasör istekleri iþlemek için tüm gerekli yöntemleri uygulayýn.
• <a1>Kayýt</a1> ortam barýndýran ASP.NET için sanal yol saðlayýcýsý biliyor burada içeriði gelen hizmet.
• Içerik akýþý VirtualFile ve sanal dizin nesneleri oluþturma.

VirtualPathProvider sýnýfý hakkýnda daha fazla bilgi için aþaðýdaki Microsoft Developer Network (MSDN) Web sitesini ziyaret edin:

Hangi içeriðin sanallaþtýrýlmýþ?

Browseable, ASPX, <a1>ana sayfa</a1>, ASCX ve temalarý sanallaþtýrýlmýþ yalnýzca maddeler türleridir.

Uygulama çaðrýlarý AppInitialize statik yöntem ve Global.asax dosyasý içinde tanýmlanan olaylarý yapýldýktan sonra baþlatýldý. Bu yöntem çaðrýlarý VirtualPathProvider sýnýfý kaydedilebilir yalnýzca iki yerlerdir.

Derleme App_Code ve App_Data klasörleri gibi üst düzey öðelerin yaþam döngüsü için kaydetmek istediðiniz saðlayýcýyý uygulamanýn içinde herhangi bir noktada etkilenip etkilenmedikleri edemiyor.

Varsayýlan olmayan göz içeriði sanallaþtýrmak için <a0></a0>, size BuildProvider sýnýf eþlemeniz gerekir. BuildProvider sýnýfý nasýl ASP.NET oluþturma ve ortam kullandýðý BuildProvider sýnýfý, farklý dosya türleri için kaynak kodu hakkýnda daha fazla bilgi için aþaðýdaki MSDN Web sitesini ziyaret edin:

Derleme Modeli

Sanal yol saðlayýcýsý için size bir örnek oluþturmadan önce size ASP.NET 2.0 derleme modelindeki baþlýca Bileþenleri'ne genel bakýþ aracýlýðýyla gelecektir. Bu genel bakýþ, bize nasýl içerik açmasýný ve bir Web sayfasýna gözatmak için Microsoft Visual Studio'da Web sitesi oluþturma ASP.NET'in yapý sistemi tarafýndan derlenen anlamanýza yardýmcý olur.

ClientBuildManager sýnýfý

Sistem birleþtirmeler oluþturma, kaynak kodu oluþturma ve ASP.NET ile etkileþim tarafýndan pre-compilation gerçekleþtiren Apý'ler oluþturmak ClientBuildManager sýnýf sunar. ClientBuildManager sýnýf, yapý sistemi dýþýnda Microsoft ýnternet ýnformation Services (IIS) eriþim saðlar. Visual Studio 2005, ClientBuildManager sýnýf'ý kullanarak, ýntellisense deyim tamamlama ve gerçek zamanlý hata raporlamasý gibi harika özellikler saðlar. ClientBuildManager sýnýfý, dosya veya sanal ve fiziksel yollarý da saðlar. Daha fazla bilgi için aþaðýdaki MSDN Web sitesini ziyaret edin:

BuildManager sýnýfý

BuildManager sýnýfý derlemeler ve uygulama sayfalarýnda derleme iþlemi yönetir. Daha fazla bilgi için aþaðýdaki MSDN Web sitesini ziyaret edin:

BuildProvider sýnýfý

BuildProvider sýnýf, belirli bir dosyayý ayrýþtýrmak ve karþýlýk gelen kod dosyasý oluþturmak için iþlevler saðlar. Daha fazla bilgi için aþaðýdaki MSDN Web sitesini ziyaret edin:

AssemblyBuilder sýnýfý

AssemblyBuilder sýnýfý, bir Dinamik derleme ile tüm derleme baðýmlýlýklar listesini gösterir. Bu sýnýf, kaynak kodu veya bir derleme iþlemi sýrasýnda derleme saðlayýcýsý tarafýndan saðlanan CodeCompileUnit nesnesi bekliyor. Daha fazla bilgi için aþaðýdaki MSDN Web sitesini ziyaret edin:

Bir veritabanýndan geliyor sanal içerik için sanal yol Saðlayýcýsý'ný geniþletme

Sanal yol saðlayýcýsý ve derleme modeli ile ilgili genel bir anlayýþ bölümlerimiz artýk, biz küçük bir SharePoint Portal oluþturabilirsiniz Hizmetleri benzeri olmayan dosya tabanlý içeriðine eriþim saðlayan uygulama.

Not Örnek uygulama oluþturma baþlamadan önce veritabaný yapýsý ve örnek kullanýlan Web sitesi hiyerarþi konunda us arayýn:

Veritabanýnda VirtualFileSystem adlý tek bir tablo yok. Bu tablo, aþaðýdakine benzer:

Web sitesi hiyerarþi içinde Visual Studio, aþaðýdakine benzer:


Notlarý

• App_Code klasöründe bir sanal yol saðlayýcýsý VirtualPathProvider sýnýfý, sanal dizin sýnýfý, VirtualFile sýnýfý ve bir yardýmcý sýnýf olarak uygulamak için gerekli olan tüm sýnýflarýný içerir.
• SharePointDir klasörü, bir sanal dizini gösterir. Bu sanal dizinin içeriðini veritabanýnda depolanýr. Bu klasör içindeki bir sayfa için herhangi bir istek ASP.NET çalýþma zamaný tarafýndan sanal bir dosya için bir istek olarak deðerlendirilir.
• Biz CRUD gerçekleþtirebileceðiniz bir kullanýcý arabirimi AdminstrationPage.aspx sayfayý görüntüler GridView denetiminin yardýmýyla sanal içeriði (oluþturma, okuma, güncelleþtirme ve silme) iþlemleri. AdminstrationPage.aspx sayfa aþaðýdakine benzer:

Us konunda örnek oluþturmaya baþlayýn.

Bunu yapmak için þu adýmlarý izleyin:

1. Visual Studio 2005'i baþlatýn.
2. Tam bir sýradüzeni ve önceki görüntüde görünen dosyalarý içeren bir Web sitesi oluþturur.
3. SharePointDirectory.cs kaynak dosyayý açýn.
4. Aþaðýdaki ad SharePointDirectory.cs dosyasýnda bulunan doðrulayýn:

   using System;
   using System.Collections;
   using System.Data;
   using System.Security.Permissions;
   using System.Web;
   using System.Web.Hosting;
   

5. SharePointProvider sýnýf bildirmek ve VirtualPathProvider RESULTCLASS devralýr

   public class SharePointProvider : 
   VirtualPathProvider

6. Bir anahtar-deðer çifti //from veritabaný alýnan iki özel members.

   //It contains the file name and content as a key-value pair retrieved 
   //from the database.
   Hashtable virtualFiles = null; 
   DBUtility utility = null;

7. AppInitialize yöntemi ekleyin. Bu iþlem en önemli yöntemi AppInitialize yöntemidir. ASP.NET uygulama baþlatma sýrasýnda çalýþma zamaný alt yapýsý, bu yöntem çaðýrýr.
   
   Not Bu yöntem bu sýnýf, bir Web.config dosyasý olmadan yüklemek ASP.NET çalýþma zamaný vermiyoruz bir el ile olarak düþünülebilir.
   
   Bu yöntemi ile birlikte birden fazla sýnýf varsa, bir derleme hatasý oluþur. Bu yöntem içinde biz bizim saðlayýcýsý ile ASP.NET barýndýrma ortamýnda kaydetmek. Þimdi tüm istekleri bir Web sayfasý için bu saðlayýcýyý. geçecek

   public static void AppInitialize()
   {
      HostingEnvironment.RegisterVirtualPathProvider(new SharePointProvider());
   }

8. Kurucu SharePointProvider sýnýfý için uygular. Bu adým, size sanal tüm dosyalarý ve içeriklerini hýzlý eriþim için bellekte tanýmlamanýzdan baðlýdýr. Bellek içi sonuç kümesi, içeriði geçersiz kadar çaba göstereceðiz. Içerik veritabanýnda içerik deðiþtiðinde tamamlanmaz güncelleþtirilmesi gerekiyor.

   public SharePointProvider(): base() 
   {
      utility = new DBUtility();
      virtualFiles = utility.GetVirtualFiles();
   }

9. Sonra IsPathVirtual yöntemi ekleyin. Bu yöntemi kullanarak, biz istenen dosyayý sanal bir yolu olup olmadýðýný belirleyebilirsiniz. Zaten SharePointDir klasördeki istenen dosyanýn bir sanal. alýnýr verdik

   private bool IsPathVirtual(string virtualPath)
   {
      String checkPath = 
         VirtualPathUtility.ToAppRelative(virtualPath);
      return checkPath.StartsWith("~/SharePointDir".ToLower().ToString(), StringComparison.InvariantCultureIgnoreCase);    
   }

10. FileExists yöntemi, dosyanýn var olup olmadýðýný döndürür. Bu doðrulama istenen dosyanýn veritabanýnda bulunan yapar. Dosya yoksa, daha önce kaydedilmiþ sanal yol saðlayýcýsý nesnesi baþvurusunu derleme sistemdeki edinir ve dosyayý yeniden FileExists yöntemi çaðrýlarak bulmak deneyecek. Dosyayý yine de bulunmazsa, size baþka alýrsýnýz "404 (dosya bulunamýyor)" hata iletisini.

    public override bool FileExists(string virtualPath)
    {
             if (IsPathVirtual(virtualPath))
             {
                SharePointVirtualFile file = (SharePointVirtualFile)GetFile(virtualPath);
                // Determine whether the file exists on the virtual file 
                // system.
                if (utility.CheckIfFileExists(virtualPath))
                    return true;
                else
                    return Previous.FileExists(virtualPath);
              }
              else
              return Previous.FileExists(virtualPath);
     }

11. Benzer þekilde DirectoryExists yöntemi vardýr. Bu yöntem, saðlayýcý bir baðýmsýz deðiþken olarak geçirilen sanal dosya yolu hizmet vermeden, doðru döndürecektir. Aksi durumda, saðlayýcý saðlayýcýnýn daha önce kaydedilmiþ sanal dosya yolu zamanki verir ve klasörü yoksa, biz 404 hata iletileri yeniden alýrsýnýz.

    public override bool DirectoryExists(string virtualDir)
    {
       if (IsPathVirtual(virtualDir))
       { 
          // Right now, we are not storing the directory information in  
          // our SharePoint Portal Services database. We assume that all of the virtual 
          // content is served from a directory that is named SharePointDir and was
          // created inside the ASP.NET Web site. Therefore, we will always 
          // return TRUE in this case.	
          SharePointVirtualDirectory dir = (SharePointVirtualDirectory)GetDirectory(virtualDir);
          return true;
       }
       else
          return Previous.DirectoryExists(virtualDir);
     }

12. Sonraki GetFile ve GetDirectory yöntemleri vardýr. FileExists ve DirectoryExists yöntem çaðrýlarý baþarýlý olduktan sonra ASP.NET çalýþma zamaný, bu yöntem sanal yol saðlayýcýsý çaðýrýr.

    //This method is used by the compilation system to obtain a VirtualFile instance to 
    //work with a given virtual file path.
    public override VirtualFile GetFile(string virtualPath)
    {
       if (IsPathVirtual(virtualPath))
          return new SharePointVirtualFile(virtualPath, this);
       else
          return Previous.GetFile(virtualPath);
    }
    
    //This method is used by the compilation system to obtain a VirtualDirectory 
    //instance to work with a given virtual directory.
    public override VirtualDirectory GetDirectory(string virtualDir)
    {
       if (IsPathVirtual(virtualDir))
           return new SharePointVirtualDirectory(virtualDir, this);
       else
           return Previous.GetDirectory(virtualDir);
    }

13. Daha sonra bu örnek. VirtualFile sýnýfý tarafýndan kullanýlan birkaç yardýmcý programý yöntemleri eklemeniz gerekir

    public string GetFileContents(string virPath)
    {
       return utility.GetFileContents(virPath);	
    }
    
    public Hashtable GetVirtualData
    {
       get { return this.virtualFiles; }
       set { this.virtualFiles = value; }
    }

    Not bu örnekte, biz düzenek sanal içeriðe yapýlan deðiþiklikler yapý sisteme bildirmek için kullanmýyorsunuz demektir. Sanal saðlayýcýnýn önbelleði sanal kaynak yardýmcý olmak için kullanýlan GetCacheDependency adlý bir API sunar. Dosyalardan herhangi birinin geçersiz duruma geldiðinde size önbellekteki geçersiz kýlar. Daha fazla bilgi için aþaðýdaki MSDN Web sitesini ziyaret edin:
    http://msdn2.microsoft.com/en-us/library/system.web.hosting.virtualpathprovider.getcachedependency.aspx (http://msdn2.microsoft.com/en-us/library/system.web.hosting.virtualpathprovider.getcachedependency.aspx)
14. Biz ana saðlayýcý sýnýfýyla yapýlýr. Þimdi SharePointDirectory.cs kaynak dosyayý açýn. Bu sýnýf sanallaþtýrýlmýþ kaynaklar için bir özet iþlevi görecek. Sanal dizin sýnýfý hakkýnda daha fazla bilgi için aþaðýdaki MSDN Web sitesini ziyaret edin:
    http://msdn2.microsoft.com/en-us/library/system.web.hosting.virtualdirectory.aspx (http://msdn2.microsoft.com/en-us/library/system.web.hosting.virtualdirectory.aspx)
15. Sanal dizin sýnýfý soyut bir sýnýf olduðundan, size tüm Soyut yöntemler geçersiz kýlmak gerekir. Bu örnekte <a0></a0> size sanal içeriði tek bir sanal dizin içinde geliyor varsayalým çünkü ancak size ek uygulama geçersiz kýlýnmýþ Bu yöntemlerde saðlamaz. Bu nedenle, sýnýf tanýmý aþaðýdaki gibi görünecektir:

    public class SharePointVirtualDirectory : VirtualDirectory
    {
       SharePointProvider spp;
       public SharePointVirtualDirectory(string virtualDir, SharePointProvider provider) : base(virtualDir){spp = provider;}
       private ArrayList children = new ArrayList();
       public override IEnumerable Children {get {return children;}}
       private ArrayList directories = new ArrayList();
       public override IEnumerable Directories{get {return directories;}}
       private ArrayList files = new ArrayList();
       public override IEnumerable Files{get { return files;}}
    }

16. Artýk, biz VirtualFile soyut sýnýfýný SharePointVirtualFile adlý bir sýnýf tanýmlamak hazýrsýnýz. Bu sýnýf, OpenFile adýnda geçersiz kýlýnmýþ bir özet yöntem olacaktýr. ASP.NET tarafýndan kullanýlan bir akýþý örneði OpenFile yöntemi döndürür sanal dosyayý kullanmak için bir ortam oluþturmak.

    public class SharePointVirtualFile : VirtualFile
    {
       private SharePointProvider spp;
       private string virPath;
    
       public SharePointVirtualFile(string virtualPath, SharePointProvider provider) : base(virtualPath)
       {
          this.spp = provider;
          this.virPath = virtualPath;
        }
    
        public override Stream Open()
        {
           string fileContents = spp.GetFileContents(virPath);
           Stream stream = new MemoryStream();
           if (fileContents != null || fileContents.Equals(String.Empty))
           {
               // Put the page content on the stream.
               StreamWriter writer = new StreamWriter(stream);
               writer.Write(fileContents);
               writer.Flush();
               stream.Seek(0, SeekOrigin.Begin);
            }
            return stream;
          }
    }

17. En son olarak, biz DBUtility.cs dosyasýnda DBUtiliity sýnýfý tanýmlayacaktýr. Yöntem uygulama saðlanmadý. DBUtiliity sýnýfý, içeriði ile birlikte diðer birkaç yardýmcý program iþlevleri veritabanýndan elde etmek için saðlayýcý sýnýflarý tarafýndan kullanýlýr.

    public class DBUtility
    {
       SqlConnection cnn;
       string connectionString = "connectionstring to DB…";
        
       //Run a select query to obtain all files and their content, and 
       //store the result in a in memory hashtable to obtain fast access.	
       string cmdSelectAllFiles = "SELECT FileName,FileData FROM VirtualFileSystem";
       Hashtable virtualFiles = null;
    
       public DBUtility(){ virtualFiles = new Hashtable();}
    
       public Hashtable GetVirtualFiles()
       {
          /* 1. Open a connection.  
             2. Select all the files.
             3. Iterate through the result and store the file name as a Key and
                content as a Value in a hashtable.
             4. Finally return hashtable.
          */
          return virtualFiles;
        }
    
       public string GetFileContents(string virPath)
       {
          //Obtain a file name from the virtual path. 
          string fileName = ExtractFileName(virPath);
            
          //Ater you obtain the file name, find it in the hashtable, and then
          //return the content for that file from the Values collection.	
        }
    
       private string ExtractFileName(string virPath)
       {
           //Extract a file name from the virtual path and return it.
       }
    
       public bool CheckIfFileExists(string virPath)
       {
           string fileName = ExtractFileName(virPath);
           //After you extract the file name, find it in the hashtable of 
           //virtual files. If the file name is found, return true. Otherwise, return false.	
        }
    }
    

    Bu saðlayýcý içeriði iþlenen deðiþtirebilirsiniz ayrýcalýklý bir iþlem olduðundan kaydetme akýlda tutulmasý gereken Not bir þey olur. Özel sýnýflar VirtualPathProvider, sanal dizin ve VirtualFile sýnýfý altýnda tam güven izinlerini'ný çalýþtýrmanýz gerekir. Daha fazla bilgi için aþaðýdaki MSDN Web sitesini ziyaret edin:
    http://msdn2.microsoft.com/en-us/library/system.web.aspnethostingpermission.aspx (http://msdn2.microsoft.com/en-us/library/system.web.aspnethostingpermission.aspx)
18. Size yapýlmasý saðlayýcý sýnýflarý ve þimdi bizim uygulama yazma sanal içerik hazýrdýr. Uygulamayý vermek için Görünüm ve davranýþ bir SharePoint Portal Services Yönetimi Web sayfasýnýn bir AdministrationPage.aspx sayfa Web sitesinin kök klasörde oluþturduðum. The page contains a GridView control that is bound with a virtual table.

    <asp:GridView ID="GridView1" runat="server"  
          AutoGenerateColumns="False" DataSourceID="SqlDataSource1" >
        <Columns>
          <asp:BoundField DataField="FileName" HeaderText="FileName" />
          <asp:TemplateField HeaderText="Remote Content" >
            <ItemTemplate>
              <asp:Label ID="Label1" runat="server"  
                         Text="FileContent...."></asp:Label>
            </ItemTemplate>
            <EditItemTemplate>
              <asp:TextBox ID="Label1" runat="server" Text='<%# 
                    Eval("FileData", "{0}") %>'></asp:TextBox>
            </EditItemTemplate>
            </asp:TemplateField>
            <asp:HyperLinkField HeaderText="Virtual Path" 
                 DataTextField="VirtualPath" Target="_self" 
                 DataNavigateUrlFormatString= "{0}"  
                 DataNavigateUrlFields="VirtualPath" />   
            <asp:CommandField  ShowEditButton="True" 
                 ShowDeleteButton="True" CausesValidation="false" 
                 HeaderText="Operations" CancelText="Cancel" />   
       </Columns>
    </asp:GridView>
    <asp:SqlDataSource ID="SqlDataSource1" runat="server" 
                       ConnectionString="<%$ 
        ConnectionStrings:VirtualProviderDBConnectionString %>"
        SelectCommand="SELECT [FileName], [FileData], [VirtualPath] FROM 
        [VirtualFileSystem] Where [FileName] LIKE '%aspx%'”>
    </asp:SqlDataSource>
    

Sonuç

Sanal yol saðlayýcýsý için bu tüm, þimdilik. Umarým bu sütun, ASP.NET 2.0 için temel bir derleme iþlemi anlamanýza yardýmcý olur ve hizmet verdiði bir veritabanýndan biz çalýþmak gibi içeriði olmayan dosya tabanlý içeriði ASP.NET çalýþma zamaný nasýl izin verebilirsiniz.

Zaman için teþekkürler. ASP.NET 2. 0 ' eklenen yeni özellikleri hakkýnda daha fazla yazma bekler. Daha fazla bilgi ve örnekler için MSDN Web sitelerini ziyaret edin:

Her zaman olarak, gelecekte sütunlarý adreslenmiþ istediðiniz konularý veya bilgi bankasýnýn Ask For It (http://support.microsoft.com/common/survey.aspx?scid=sw;en;1176&p0=&p1=&p2=&p3=&p4=) formunu kullanarak fikir gönderme bildirmekten çekinmeyin.