Artigo: 326201 - Última revisão: sexta-feira, 13 de Março de 2009 - Revisão: 4.0

Como limpar a cache quando a aplicação hospeda um controlo WebBrowser no Visual C# .NET

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que está a utilizar. Foi desactivado o conteúdo do artigo, que pode não ser relevante para si.

Nesta página

Expandir tudo | Reduzir tudo

Sumário

Este artigo passo a passo descreve como utilizar funções da interface (API) programação aplicação WinInet para limpar a cache directamente.

Poderá ter de limpar a cache programaticamente quando a aplicação hospeda um controlo WebBrowser. No entanto, esta funcionalidade não está disponível através de interfaces do controlo WebBrowser.

Funções de WinInet

Para limpar a cache directamente, pode utilizar as seguintes funções de WinInet:
  • Utilize a função FindFirstURLCacheEntry para localizar a primeira entrada da cache.
  • Utilize a função FindNextUrlCacheEntry para enumerar a cache.
  • Utilize a função DeleteUrlCacheEntry para eliminar cada entrada.
O código de exemplo neste artigo utiliza todas estas funções.

Nota : estas funções só estão disponíveis com o Microsoft Internet Explorer 5. Por conseguinte, tem de incluir as verificações adequadas (que inclui o código de exemplo neste artigo) para evitar erros.

Passos para limpar a cache no Visual C# .NET

Para utilizar as funções de WinInet no Visual C# .NET para limpar todos os ficheiros na cache, siga estes passos:
  1. Inicie o Microsoft Visual Studio NET..
  2. No menu ficheiro , aponte para Novo e, em seguida, clique em projecto .
  3. Na caixa de diálogo Novo projecto , clique em Visual C# Projects em Project Types e, em seguida, clique em Aplicação de consola em modelos .
  4. Adicione o seguinte código à classe Class1.cs:
    using System;
    using System.Runtime.InteropServices;
    
    // Visual C# version of Q326201
    namespace Q326201CS
    {
        // Class for deleting the cache.
        class DeleteCache
        {
            // For PInvoke: Contains information about an entry in the Internet cache
            [StructLayout(LayoutKind.Explicit, Size=80)]
            public struct INTERNET_CACHE_ENTRY_INFOA
            {
                [FieldOffset(0)]  public uint dwStructSize;
                [FieldOffset(4)]  public IntPtr lpszSourceUrlName;
                [FieldOffset(8)]  public IntPtr lpszLocalFileName;
                [FieldOffset(12)] public uint CacheEntryType;
                [FieldOffset(16)] public uint dwUseCount;
                [FieldOffset(20)] public uint dwHitRate;
                [FieldOffset(24)] public uint dwSizeLow;
                [FieldOffset(28)] public uint dwSizeHigh;
                [FieldOffset(32)] public FILETIME LastModifiedTime;
                [FieldOffset(40)] public FILETIME ExpireTime;
                [FieldOffset(48)] public FILETIME LastAccessTime;
                [FieldOffset(56)] public FILETIME LastSyncTime;
                [FieldOffset(64)] public IntPtr lpHeaderInfo;
                [FieldOffset(68)] public uint dwHeaderInfoSize;
                [FieldOffset(72)] public IntPtr lpszFileExtension;
                [FieldOffset(76)] public uint dwReserved;
                [FieldOffset(76)] public uint dwExemptDelta;
            }
    
            // For PInvoke: Initiates the enumeration of the cache groups in the Internet cache
            [DllImport(@"wininet",
                SetLastError=true,
                CharSet=CharSet.Auto,
                EntryPoint="FindFirstUrlCacheGroup",
                CallingConvention=CallingConvention.StdCall)]
            public static extern IntPtr FindFirstUrlCacheGroup(
                int dwFlags,
                int dwFilter,
                IntPtr lpSearchCondition,
                int dwSearchCondition,
                ref long lpGroupId,
                IntPtr lpReserved);
    
            // For PInvoke: Retrieves the next cache group in a cache group enumeration
            [DllImport(@"wininet",
                SetLastError=true,
                CharSet=CharSet.Auto,
                EntryPoint="FindNextUrlCacheGroup",
                CallingConvention=CallingConvention.StdCall)]
            public static extern bool FindNextUrlCacheGroup(
                IntPtr hFind,
                ref long lpGroupId,
                IntPtr lpReserved);
    
            // For PInvoke: Releases the specified GROUPID and any associated state in the cache index file
            [DllImport(@"wininet", 
                SetLastError=true, 
                CharSet=CharSet.Auto, 
                EntryPoint="DeleteUrlCacheGroup", 
                CallingConvention=CallingConvention.StdCall)]
            public static extern bool DeleteUrlCacheGroup(
                long GroupId,
                int dwFlags,
                IntPtr lpReserved);
    
            // For PInvoke: Begins the enumeration of the Internet cache
            [DllImport(@"wininet",
                SetLastError=true,
                CharSet=CharSet.Auto,
                EntryPoint="FindFirstUrlCacheEntryA",
                CallingConvention=CallingConvention.StdCall)]
            public static extern IntPtr FindFirstUrlCacheEntry(
                [MarshalAs(UnmanagedType.LPTStr)] string lpszUrlSearchPattern,
                IntPtr lpFirstCacheEntryInfo,
                ref int lpdwFirstCacheEntryInfoBufferSize);
    
            // For PInvoke: Retrieves the next entry in the Internet cache
            [DllImport(@"wininet",
                SetLastError=true,
                CharSet=CharSet.Auto,
                EntryPoint="FindNextUrlCacheEntryA",
                CallingConvention=CallingConvention.StdCall)]
            public static extern bool FindNextUrlCacheEntry(
                IntPtr hFind,
                IntPtr lpNextCacheEntryInfo,
                ref int lpdwNextCacheEntryInfoBufferSize);
    
            // For PInvoke: Removes the file that is associated with the source name from the cache, if the file exists
            [DllImport(@"wininet",
                SetLastError=true,
                CharSet=CharSet.Auto,
                EntryPoint="DeleteUrlCacheEntryA",
                CallingConvention=CallingConvention.StdCall)]
            public static extern bool DeleteUrlCacheEntry(
                IntPtr lpszUrlName);
    
            [STAThread]
            static void Main(string[] args)
            {
                // Indicates that all of the cache groups in the user's system should be enumerated
                const int CACHEGROUP_SEARCH_ALL = 0x0;
                // Indicates that all the cache entries that are associated with the cache group
                // should be deleted, unless the entry belongs to another cache group.
                const int CACHEGROUP_FLAG_FLUSHURL_ONDELETE = 0x2;
                // File not found.
                const int ERROR_FILE_NOT_FOUND = 0x2;
                // No more items have been found.
                const int ERROR_NO_MORE_ITEMS = 259;
                // Pointer to a GROUPID variable
                long groupId = 0;
    
                // Local variables
                int cacheEntryInfoBufferSizeInitial = 0;
                int cacheEntryInfoBufferSize = 0;
                IntPtr cacheEntryInfoBuffer = IntPtr.Zero;
                INTERNET_CACHE_ENTRY_INFOA internetCacheEntry;
                IntPtr enumHandle = IntPtr.Zero;
                bool returnValue = false;
    
                // Delete the groups first.
                // Groups may not always exist on the system.
                // For more information, visit the following Microsoft Web site:
                // http://msdn.microsoft.com/library/?url=/workshop/networking/wininet/overview/cache.asp			
                // By default, a URL does not belong to any group. Therefore, that cache may become
                // empty even when the CacheGroup APIs are not used because the existing URL does not belong to any group.			
                enumHandle = FindFirstUrlCacheGroup(0, CACHEGROUP_SEARCH_ALL, IntPtr.Zero, 0, ref groupId, IntPtr.Zero);
                // If there are no items in the Cache, you are finished.
                if (enumHandle != IntPtr.Zero && ERROR_NO_MORE_ITEMS == Marshal.GetLastWin32Error())
                    return;
    
                // Loop through Cache Group, and then delete entries.
                while(true)
                {
                    // Delete a particular Cache Group.
                    returnValue = DeleteUrlCacheGroup(groupId, CACHEGROUP_FLAG_FLUSHURL_ONDELETE, IntPtr.Zero);
                    if (!returnValue && ERROR_FILE_NOT_FOUND == Marshal.GetLastWin32Error())
                    {	
                        returnValue = FindNextUrlCacheGroup(enumHandle, ref groupId, IntPtr.Zero);
                    }
    
                    if (!returnValue && (ERROR_NO_MORE_ITEMS == Marshal.GetLastWin32Error() || ERROR_FILE_NOT_FOUND == Marshal.GetLastWin32Error()))
                        break;
                }
    
                // Start to delete URLs that do not belong to any group.
                enumHandle = FindFirstUrlCacheEntry(null, IntPtr.Zero, ref cacheEntryInfoBufferSizeInitial);
                if (enumHandle == IntPtr.Zero && ERROR_NO_MORE_ITEMS == Marshal.GetLastWin32Error())
                    return;
    
                cacheEntryInfoBufferSize = cacheEntryInfoBufferSizeInitial;
                cacheEntryInfoBuffer = Marshal.AllocHGlobal(cacheEntryInfoBufferSize);
                enumHandle = FindFirstUrlCacheEntry(null, cacheEntryInfoBuffer, ref cacheEntryInfoBufferSizeInitial);
    
                while(true)
                {
                    internetCacheEntry = (INTERNET_CACHE_ENTRY_INFOA)Marshal.PtrToStructure(cacheEntryInfoBuffer, typeof(INTERNET_CACHE_ENTRY_INFOA));		
    
                    cacheEntryInfoBufferSizeInitial = cacheEntryInfoBufferSize;
                    returnValue = DeleteUrlCacheEntry(internetCacheEntry.lpszSourceUrlName);				
                    if (!returnValue)
                    {	
                        returnValue = FindNextUrlCacheEntry(enumHandle, cacheEntryInfoBuffer, ref cacheEntryInfoBufferSizeInitial);
                    }
                    if (!returnValue && ERROR_NO_MORE_ITEMS == Marshal.GetLastWin32Error())
                    {
                        break;
                    }			
                    if (!returnValue && cacheEntryInfoBufferSizeInitial > cacheEntryInfoBufferSize)
                    {
                        cacheEntryInfoBufferSize = cacheEntryInfoBufferSizeInitial;
                        cacheEntryInfoBuffer = Marshal.ReAllocHGlobal(cacheEntryInfoBuffer, (IntPtr) cacheEntryInfoBufferSize);
                        returnValue = FindNextUrlCacheEntry(enumHandle, cacheEntryInfoBuffer, ref cacheEntryInfoBufferSizeInitial);					
                    }
                }
                Marshal.FreeHGlobal(cacheEntryInfoBuffer);		
            }
        }
    }
    					
  5. Compilar e, em seguida, execute o projecto.
  6. Para confirmar que os ficheiros temporários da Internet na cache do foram eliminados, siga estes passos no Microsoft Internet Explorer:
    1. No menu Ferramentas , clique em Opções da Internet .
    2. Na área ficheiros temporários da Internet no separador Geral , clique em definições .
    3. Clique em Ver ficheiros . Repare que todos os ficheiros na cache do Internet Explorer foram eliminados.

Referências

O código de exemplo neste artigo utiliza o espaço de nomes Interop que faz parte o runtime do Visual Studio. NET. Para mais informações, visite o seguinte Web site da Microsoft Developer Network (MSDN):
Interagir com o código não gerido
http://msdn2.microsoft.com/en-us/library/sd10k43k(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/sd10k43k(vs.71).aspx)
Para obter informações sobre programação .NET da Microsoft, visite o seguinte Web site da MSDN:
.NET framework Developer Center
http://msdn2.microsoft.com/en-us/netframework/default.aspx (http://msdn2.microsoft.com/en-us/netframework/default.aspx)
Para mais informações sobre a sintaxe das funções de colocação em cache WinInet, visite o seguinte site da Web MSDN:
Colocação em cache WinInet
http://msdn2.microsoft.com/en-us/library/ms965968.aspx (http://msdn2.microsoft.com/en-us/library/ms965968.aspx)
Para obter mais informações, clique no número de artigo que se segue para visualizar o artigo na Microsoft Knowledge Base:
262110  (http://support.microsoft.com/kb/262110/ ) Como limpar a cache quando a aplicação hospeda um controlo WebBrowser
Para obter mais informações sobre como desenvolver soluções baseadas na Web para o Microsoft Internet Explorer, visite os seguintes Web sites da Microsoft:
http://msdn.microsoft.com/ie/ (http://msdn.microsoft.com/ie/)

http://support.microsoft.com/iep (http://support.microsoft.com/iep)

A informação contida neste artigo aplica-se a:
  • Microsoft Visual C# .NET 2002 Standard Edition
Palavras-chave: 
kbmt kbcaching kbcominterop kbhowto kbhowtomaster kbwebbrowser kbwininet KB326201 KbMtpt
Tradução automáticaTradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine translation ou MT), não tendo sido portanto revisto ou traduzido por humanos. A Microsoft tem artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais. O objectivo é simples: oferecer em Português a totalidade dos artigos existentes na base de dados do suporte. Sabemos no entanto que a tradução automática não é sempre perfeita. Esta pode conter erros de vocabulário, sintaxe ou gramática? erros semelhantes aos que um estrangeiro realiza ao falar em Português. A Microsoft não é responsável por incoerências, erros ou estragos realizados na sequência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza actualizações frequentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 326201  (http://support.microsoft.com/kb/326201/en-us/ )