HttpCookie.cs source code in C# .NET

Source code for the .NET framework in C#

                        

Code:

/ 4.0 / 4.0 / untmp / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / fx / src / xsp / System / Web / HttpCookie.cs / 1305376 / HttpCookie.cs

                            //------------------------------------------------------------------------------ 
// 
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// 
//----------------------------------------------------------------------------- 

/* 
 * HttpCookie - collection + name + path 
 *
 * Copyright (c) 1998 Microsoft Corporation 
 */

namespace System.Web {
    using System.Text; 
    using System.Collections;
    using System.Collections.Specialized; 
    using System.Globalization; 
    using System.Security.Permissions;
    using System.Web.Configuration; 
    using System.Web.Management;


    ///  
    ///    
    ///       Provides a type-safe way 
    ///       to access multiple HTTP cookies. 
    ///    
    ///  
    public sealed class HttpCookie {
        private String _name;
        private String _path = "/";
        private bool _secure; 
        private bool _httpOnly;
        private String _domain; 
        private bool _expirationSet; 
        private DateTime _expires;
        private String _stringValue; 
        private HttpValueCollection _multiValue;
        private bool _changed;
        private bool _added;
 
        internal HttpCookie() {
            _changed = true; 
        } 

        /* 
         * Constructor - empty cookie with name
         */

        ///  
        ///    
        ///       Initializes a new instance of the  
        ///       class. 
        ///    
        ///  
        public HttpCookie(String name) {
            _name = name;

            SetDefaultsFromConfig(); 
            _changed = true;
        } 
 
        /*
         * Constructor - cookie with name and value 
         */

        /// 
        ///     
        ///       Initializes a new instance of the 
        ///       class. 
        ///     
        /// 
        public HttpCookie(String name, String value) { 
            _name = name;
            _stringValue = value;

            SetDefaultsFromConfig(); 
            _changed = true;
        } 
 
        private void SetDefaultsFromConfig() {
            HttpCookiesSection config = RuntimeConfig.GetConfig().HttpCookies; 
            _secure = config.RequireSSL;
            _httpOnly = config.HttpOnlyCookies;

            if (config.Domain != null && config.Domain.Length > 0) 
                _domain = config.Domain;
        } 
 
        /*
         * Whether the cookie contents have changed 
         */
        internal bool Changed {
            get { return _changed; }
            set { _changed = value; } 
        }
 
        /* 
         * Whether the cookie has been added
         */ 
        internal bool Added {
            get { return _added; }
            set { _added = value; }
        } 

        /* 
         * Cookie name 
         */
 
        /// 
        ///    
        ///       Gets
        ///       or sets the name of cookie. 
        ///    
        ///  
        public String Name { 
            get { return _name;}
            set { 
                _name = value;
                _changed = true;
            }
        } 

        /* 
         * Cookie path 
         */
 
        /// 
        ///    
        ///       Gets or sets the URL prefix to transmit with the
        ///       current cookie. 
        ///    
        ///  
        public String Path { 
            get { return _path;}
            set { 
                _path = value;
                _changed = true;
            }
        } 

        /* 
         * 'Secure' flag 
         */
 
        /// 
        ///    
        ///       Indicates whether the cookie should be transmitted only over HTTPS.
        ///     
        /// 
        public bool Secure { 
            get { return _secure;} 
            set {
                _secure = value; 
                _changed = true;
            }
        }
 
        /// 
        ///     
        ///       Indicates whether the cookie should have HttpOnly attribute 
        ///    
        ///  
        public bool HttpOnly {
            get { return _httpOnly;}
            set {
                _httpOnly = value; 
                _changed = true;
            } 
        } 

        /* 
         * Cookie domain
         */

        ///  
        ///    
        ///       Restricts domain cookie is to be used with. 
        ///     
        /// 
        public String Domain { 
            get { return _domain;}
            set {
                _domain = value;
                _changed = true; 
            }
        } 
 
        /*
         * Cookie expiration 
         */

        /// 
        ///     
        ///       Expiration time for cookie (in minutes).
        ///     
        ///  
        public DateTime Expires {
            get { 
                return(_expirationSet ? _expires : DateTime.MinValue);
            }

            set { 
                _expires = value;
                _expirationSet = true; 
                _changed = true; 
            }
        } 

        /*
         * Cookie value as string
         */ 

        ///  
        ///     
        ///       Gets
        ///       or 
        ///       sets an individual cookie value.
        ///    
        /// 
        public String Value { 
            get {
                if (_multiValue != null) 
                    return _multiValue.ToString(false); 
                else
                    return _stringValue; 
            }

            set {
                if (_multiValue != null) { 
                    // reset multivalue collection to contain
                    // single keyless value 
                    _multiValue.Reset(); 
                    _multiValue.Add(null, value);
                } 
                else {
                    // remember as string
                    _stringValue = value;
                } 
                _changed = true;
            } 
        } 

        /* 
         * Checks is cookie has sub-keys
         */

        ///  
        ///    Gets a
        ///       value indicating whether the cookie has sub-keys. 
        ///  
        public bool HasKeys {
            get { return Values.HasKeys();} 
        }

        private bool SupportsHttpOnly(HttpContext context) {
            if (context != null && context.Request != null) { 
                HttpBrowserCapabilities browser = context.Request.Browser;
                return (browser != null && (browser.Type != "IE5" || browser.Platform != "MacPPC")); 
            } 
            return false;
        } 

        /*
         * Cookie values as multivalue collection
         */ 

        ///  
        ///    Gets individual key:value pairs within a single cookie object. 
        /// 
        public NameValueCollection Values { 
            get {
                if (_multiValue == null) {
                    // create collection on demand
                    _multiValue = new HttpValueCollection(); 

                    // convert existing string value into multivalue 
                    if (_stringValue != null) { 
                        if (_stringValue.IndexOf('&') >= 0 || _stringValue.IndexOf('=') >= 0)
                            _multiValue.FillFromString(_stringValue); 
                        else
                            _multiValue.Add(null, _stringValue);

                        _stringValue = null; 
                    }
                } 
 
                _changed = true;
 
                return _multiValue;
            }
        }
 
        /*
         * Default indexed property -- lookup the multivalue collection 
         */ 

        ///  
        ///    
        ///       Shortcut for HttpCookie$Values[key]. Required for ASP compatibility.
        ///    
        ///  
        public String this[String key]
        { 
            get { 
                return Values[key];
            } 

            set {
                Values[key] = value;
                _changed = true; 
            }
        } 
 
        /*
         * Construct set-cookie header 
         */
        internal HttpResponseHeader GetSetCookieHeader(HttpContext context) {
            StringBuilder s = new StringBuilder();
 
            // cookiename=
            if (!String.IsNullOrEmpty(_name)) { 
                s.Append(_name); 
                s.Append('=');
            } 

            // key=value&...
            if (_multiValue != null)
                s.Append(_multiValue.ToString(false)); 
            else if (_stringValue != null)
                s.Append(_stringValue); 
 
            // domain
            if (!String.IsNullOrEmpty(_domain)) { 
                s.Append("; domain=");
                s.Append(_domain);
            }
 
            // expiration
            if (_expirationSet && _expires != DateTime.MinValue) { 
                s.Append("; expires="); 
                s.Append(HttpUtility.FormatHttpCookieDateTime(_expires));
            } 

            // path
            if (!String.IsNullOrEmpty(_path)) {
                s.Append("; path="); 
                s.Append(_path);
            } 
 
            // secure
            if (_secure) 
                s.Append("; secure");

            // httponly, Note: IE5 on the Mac doesn't support this
            if (_httpOnly && SupportsHttpOnly(context)) { 
                s.Append("; HttpOnly");
            } 
 
            // return as HttpResponseHeader
            return new HttpResponseHeader(HttpWorkerRequest.HeaderSetCookie, s.ToString()); 
        }
    }

    ///////////////////////////////////////////////////////////////////////////// 
    /////////////////////////////////////////////////////////////////////////////
    ///////////////////////////////////////////////////////////////////////////// 
 
    public enum HttpCookieMode {
 
        UseUri,          // cookieless=true

        UseCookies,      // cookieless=false
 
        AutoDetect,      // cookieless=AutoDetect; Probe if device is cookied
 
        UseDeviceProfile // cookieless=UseDeviceProfile; Base decision on caps 
    }
} 

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.


                        

Link Menu

Network programming in C#, Network Programming in VB.NET, Network Programming in .NET
This book is available now!
Buy at Amazon US or
Buy at Amazon UK