FBro的Cookie管理器控制类

using System;
using FBroSharp.Callback;
using FBroSharp.DataType;

namespace FBroSharp.Lib;

public interface IFBroSharpCookieManager : IFBroSharpBase, IDisposable
{
    //
    // 摘要:
    //     是否有效
    //
    //     True if this object is currently attached to a valid frame.
    bool IsValid { get; }

    //
    // 摘要:
    //     取全部Cookie
    //
    //     Visit all cookies on the UI thread. The returned cookies are ordered by longest
    //     path, then by earliest creation date. Returns false if cookies cannot be accessed.
    bool VisitAllCookies(FBroSharpCookieVisitor callback);

    //
    // 摘要:
    //     取地址Cookie
    //
    //     Visit a subset of cookies on the UI thread. The results are filtered by the given
    //     url scheme, host, domain and path. If |includeHttpOnly| is true HTTP-only cookies
    //     will also be included in the results. The returned cookies are ordered by longest
    //     path, then by earliest creation date. Returns false if cookies cannot be accessed.
    bool VisitUrlCookies(string url, bool includeHttpOnly, FBroSharpCookieVisitor callback);

    //
    // 摘要:
    //     置Cookie
    //
    //     Sets a cookie given a valid URL and explicit user-provided cookie attributes.
    //     This function expects each attribute to be well-formed. It will check for disallowed
    //     characters (e.g. the ';' character is disallowed within the cookie value attribute)
    //     and fail without setting the cookie if such characters are found. If |callback|
    //     is non-NULL it will be executed asnychronously on the UI thread after the cookie
    //     has been set. Returns false if an invalid URL is specified or if cookies cannot
    //     be accessed.
    bool SetCookie(string url, FBroSharpCookieData CookieData);

    //
    // 摘要:
    //     删除Cookie
    //
    //     Delete all cookies that match the specified parameters. If both |url| and |cookie_name|
    //     values are specified all host and domain cookies matching both will be deleted.
    //     If only |url| is specified all host cookies (but not domain cookies) irrespective
    //     of path will be deleted. If |url| is empty all cookies for all hosts and domains
    //     will be deleted. If |callback| is non-NULL it will be executed asnychronously
    //     on the UI thread after the cookies have been deleted. Returns false if a non-empty
    //     invalid URL is specified or if cookies cannot be accessed. Cookies can alternately
    //     be deleted using the Visit*Cookies() methods.
    bool DeleteCookies(string url, string cookie_name);

    //
    // 摘要:
    //     刷新Cookie
    //
    //     Flush the backing store (if any) to disk. If |callback| is non-NULL it will be
    //     executed asnychronously on the UI thread after the flush is complete. Returns
    //     false if cookies cannot be accessed.
    bool FlushStore();
}
#if false // 反编译日志
缓存中的 16 项
------------------
解析: "mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
找到单个程序集: "mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
从以下位置加载: "C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0\mscorlib.dll"
------------------
解析: "System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
找到单个程序集: "System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
从以下位置加载: "C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0\System.dll"
#endif