ResourceAttributes.cs source code in C# .NET

Source code for the .NET framework in C#

                        

Code:

/ 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / clr / src / BCL / System / Runtime / Versioning / ResourceAttributes.cs / 1305376 / ResourceAttributes.cs

                            // ==++== 
//
//   Copyright (c) Microsoft Corporation.  All rights reserved.
//
// ==--== 
/*============================================================
** 
** Purpose: Resource annotation rules. 
**
===========================================================*/ 
using System;
using System.Diagnostics;
using System.Globalization;
using System.Runtime.CompilerServices; 
using System.Text;
using Microsoft.Win32; 
using System.Diagnostics.Contracts; 

namespace System.Runtime.Versioning 
{
    [AttributeUsage(AttributeTargets.Method | AttributeTargets.Property | AttributeTargets.Constructor, Inherited = false)]
    [Conditional("RESOURCE_ANNOTATION_WORK")]
    public sealed class ResourceConsumptionAttribute : Attribute 
    {
        private ResourceScope _consumptionScope; 
        private ResourceScope _resourceScope; 

        public ResourceConsumptionAttribute(ResourceScope resourceScope) 
        {
            _resourceScope = resourceScope;
            _consumptionScope = _resourceScope;
        } 

        public ResourceConsumptionAttribute(ResourceScope resourceScope, ResourceScope consumptionScope) 
        { 
            _resourceScope = resourceScope;
            _consumptionScope = consumptionScope; 
        }

        public ResourceScope ResourceScope {
            get { return _resourceScope; } 
        }
 
        public ResourceScope ConsumptionScope { 
            get { return _consumptionScope; }
        } 
    }

    [AttributeUsage(AttributeTargets.Method | AttributeTargets.Field | AttributeTargets.Property | AttributeTargets.Constructor, Inherited = false)]
    [Conditional("RESOURCE_ANNOTATION_WORK")] 
    public sealed class ResourceExposureAttribute : Attribute
    { 
        private ResourceScope _resourceExposureLevel; 

        public ResourceExposureAttribute(ResourceScope exposureLevel) 
        {
            _resourceExposureLevel = exposureLevel;
        }
 
        public ResourceScope ResourceExposureLevel {
            get { return _resourceExposureLevel; } 
        } 
    }
 

    // Default visibility is Public, which isn't specified in this enum.
    // Public == the lack of Private or Assembly
    // Does this actually work?  Need to investigate that. 
    [Flags]
    public enum ResourceScope 
    { 
        None = 0,
        // Resource type 
        Machine   = 0x1,
        Process   = 0x2,
        AppDomain = 0x4,
        Library   = 0x8, 
        // Visibility
        Private  = 0x10,  // Private to this one class. 
        Assembly = 0x20,  // Assembly-level, like C#'s "internal" 
    }
 

    [Flags]
    internal enum SxSRequirements
    { 
        None = 0,
        AppDomainID = 0x1, 
        ProcessID = 0x2, 
        CLRInstanceID = 0x4, // for multiple CLR's within the process
        AssemblyName = 0x8, 
        TypeName = 0x10
    }

    public static class VersioningHelper 
    {
        // These depend on the exact values given to members of the ResourceScope enum. 
        private const ResourceScope ResTypeMask = ResourceScope.Machine | ResourceScope.Process | ResourceScope.AppDomain | ResourceScope.Library; 
        private const ResourceScope VisibilityMask = ResourceScope.Private | ResourceScope.Assembly;
 
        [System.Security.SecuritySafeCritical]
        [ResourceExposure(ResourceScope.Process)]
        [MethodImpl(MethodImplOptions.InternalCall)]
        private static extern int GetRuntimeId(); 

        public static String MakeVersionSafeName(String name, ResourceScope from, ResourceScope to) 
        { 
            return MakeVersionSafeName(name, from, to, null);
        } 

        [System.Security.SecuritySafeCritical]  // auto-generated
        [ResourceExposure(ResourceScope.None)]
        [ResourceConsumption(ResourceScope.Process, ResourceScope.Process)] 
        public static String MakeVersionSafeName(String name, ResourceScope from, ResourceScope to, Type type)
        { 
            ResourceScope fromResType = from & ResTypeMask; 
            ResourceScope toResType = to & ResTypeMask;
            if (fromResType > toResType) 
                throw new ArgumentException(Environment.GetResourceString("Argument_ResourceScopeWrongDirection", fromResType, toResType), "from");

            SxSRequirements requires = GetRequirements(to, from);
 
            if ((requires & (SxSRequirements.AssemblyName | SxSRequirements.TypeName)) != 0 && type == null)
                throw new ArgumentNullException("type", Environment.GetResourceString("ArgumentNull_TypeRequiredByResourceScope")); 
 
            // Add in process ID, CLR base address, and appdomain ID's.  Also, use a character identifier
            // to ensure that these can never accidentally overlap (ie, you create enough appdomains and your 
            // appdomain ID might equal your process ID).
            StringBuilder safeName = new StringBuilder(name);
            char separator = '_';
            if ((requires & SxSRequirements.ProcessID) != 0) { 
                safeName.Append(separator);
                safeName.Append('p'); 
                safeName.Append(Win32Native.GetCurrentProcessId()); 
            }
            if ((requires & SxSRequirements.CLRInstanceID) != 0) { 
                String clrID = GetCLRInstanceString();
                safeName.Append(separator);
                safeName.Append('r');
                safeName.Append(clrID); 
            }
            if ((requires & SxSRequirements.AppDomainID) != 0) { 
                safeName.Append(separator); 
                safeName.Append("ad");
                safeName.Append(AppDomain.CurrentDomain.Id); 
            }
            if ((requires & SxSRequirements.TypeName) != 0) {
                safeName.Append(separator);
                safeName.Append(type.Name); 
            }
            if ((requires & SxSRequirements.AssemblyName) != 0) { 
                safeName.Append(separator); 
                safeName.Append(type.Assembly.FullName);
            } 
            return safeName.ToString();
        }

        [System.Security.SecuritySafeCritical] 
        private static String GetCLRInstanceString()
        { 
            int id = GetRuntimeId(); 
            return id.ToString(CultureInfo.InvariantCulture);
        } 

        private static SxSRequirements GetRequirements(ResourceScope consumeAsScope, ResourceScope calleeScope)
        {
            SxSRequirements requires = SxSRequirements.None; 

            switch(calleeScope & ResTypeMask) { 
            case ResourceScope.Machine: 
                switch(consumeAsScope & ResTypeMask) {
                case ResourceScope.Machine: 
                    // No work
                    break;

                case ResourceScope.Process: 
                    requires |= SxSRequirements.ProcessID;
                    break; 
 
                case ResourceScope.AppDomain:
                    requires |= SxSRequirements.AppDomainID | SxSRequirements.CLRInstanceID | SxSRequirements.ProcessID; 
                    break;

                default:
                    throw new ArgumentException(Environment.GetResourceString("Argument_BadResourceScopeTypeBits", consumeAsScope), "consumeAsScope"); 
                }
                break; 
 
            case ResourceScope.Process:
                if ((consumeAsScope & ResourceScope.AppDomain) != 0) 
                    requires |= SxSRequirements.AppDomainID | SxSRequirements.CLRInstanceID;
                break;

            case ResourceScope.AppDomain: 
                // No work
                break; 
 
            default:
                throw new ArgumentException(Environment.GetResourceString("Argument_BadResourceScopeTypeBits", calleeScope), "calleeScope"); 
            }

            switch(calleeScope & VisibilityMask) {
            case ResourceScope.None:  // Public - implied 
                switch(consumeAsScope & VisibilityMask) {
                case ResourceScope.None:  // Public - implied 
                    // No work 
                    break;
 
                case ResourceScope.Assembly:
                    requires |= SxSRequirements.AssemblyName;
                    break;
 
                case ResourceScope.Private:
                    requires |= SxSRequirements.TypeName | SxSRequirements.AssemblyName; 
                    break; 

                default: 
                    throw new ArgumentException(Environment.GetResourceString("Argument_BadResourceScopeVisibilityBits", consumeAsScope), "consumeAsScope");
                }
                break;
 
            case ResourceScope.Assembly:
                if ((consumeAsScope & ResourceScope.Private) != 0) 
                    requires |= SxSRequirements.TypeName; 
                break;
 
            case ResourceScope.Private:
                // No work
                break;
 
            default:
                throw new ArgumentException(Environment.GetResourceString("Argument_BadResourceScopeVisibilityBits", calleeScope), "calleeScope"); 
            } 

            if (consumeAsScope == calleeScope) { 
                Contract.Assert(requires == SxSRequirements.None, "Computed a strange set of required resource scoping.  It's probably wrong.");
            }

            return requires; 
        }
    } 
} 

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// ==++== 
//
//   Copyright (c) Microsoft Corporation.  All rights reserved.
//
// ==--== 
/*============================================================
** 
** Purpose: Resource annotation rules. 
**
===========================================================*/ 
using System;
using System.Diagnostics;
using System.Globalization;
using System.Runtime.CompilerServices; 
using System.Text;
using Microsoft.Win32; 
using System.Diagnostics.Contracts; 

namespace System.Runtime.Versioning 
{
    [AttributeUsage(AttributeTargets.Method | AttributeTargets.Property | AttributeTargets.Constructor, Inherited = false)]
    [Conditional("RESOURCE_ANNOTATION_WORK")]
    public sealed class ResourceConsumptionAttribute : Attribute 
    {
        private ResourceScope _consumptionScope; 
        private ResourceScope _resourceScope; 

        public ResourceConsumptionAttribute(ResourceScope resourceScope) 
        {
            _resourceScope = resourceScope;
            _consumptionScope = _resourceScope;
        } 

        public ResourceConsumptionAttribute(ResourceScope resourceScope, ResourceScope consumptionScope) 
        { 
            _resourceScope = resourceScope;
            _consumptionScope = consumptionScope; 
        }

        public ResourceScope ResourceScope {
            get { return _resourceScope; } 
        }
 
        public ResourceScope ConsumptionScope { 
            get { return _consumptionScope; }
        } 
    }

    [AttributeUsage(AttributeTargets.Method | AttributeTargets.Field | AttributeTargets.Property | AttributeTargets.Constructor, Inherited = false)]
    [Conditional("RESOURCE_ANNOTATION_WORK")] 
    public sealed class ResourceExposureAttribute : Attribute
    { 
        private ResourceScope _resourceExposureLevel; 

        public ResourceExposureAttribute(ResourceScope exposureLevel) 
        {
            _resourceExposureLevel = exposureLevel;
        }
 
        public ResourceScope ResourceExposureLevel {
            get { return _resourceExposureLevel; } 
        } 
    }
 

    // Default visibility is Public, which isn't specified in this enum.
    // Public == the lack of Private or Assembly
    // Does this actually work?  Need to investigate that. 
    [Flags]
    public enum ResourceScope 
    { 
        None = 0,
        // Resource type 
        Machine   = 0x1,
        Process   = 0x2,
        AppDomain = 0x4,
        Library   = 0x8, 
        // Visibility
        Private  = 0x10,  // Private to this one class. 
        Assembly = 0x20,  // Assembly-level, like C#'s "internal" 
    }
 

    [Flags]
    internal enum SxSRequirements
    { 
        None = 0,
        AppDomainID = 0x1, 
        ProcessID = 0x2, 
        CLRInstanceID = 0x4, // for multiple CLR's within the process
        AssemblyName = 0x8, 
        TypeName = 0x10
    }

    public static class VersioningHelper 
    {
        // These depend on the exact values given to members of the ResourceScope enum. 
        private const ResourceScope ResTypeMask = ResourceScope.Machine | ResourceScope.Process | ResourceScope.AppDomain | ResourceScope.Library; 
        private const ResourceScope VisibilityMask = ResourceScope.Private | ResourceScope.Assembly;
 
        [System.Security.SecuritySafeCritical]
        [ResourceExposure(ResourceScope.Process)]
        [MethodImpl(MethodImplOptions.InternalCall)]
        private static extern int GetRuntimeId(); 

        public static String MakeVersionSafeName(String name, ResourceScope from, ResourceScope to) 
        { 
            return MakeVersionSafeName(name, from, to, null);
        } 

        [System.Security.SecuritySafeCritical]  // auto-generated
        [ResourceExposure(ResourceScope.None)]
        [ResourceConsumption(ResourceScope.Process, ResourceScope.Process)] 
        public static String MakeVersionSafeName(String name, ResourceScope from, ResourceScope to, Type type)
        { 
            ResourceScope fromResType = from & ResTypeMask; 
            ResourceScope toResType = to & ResTypeMask;
            if (fromResType > toResType) 
                throw new ArgumentException(Environment.GetResourceString("Argument_ResourceScopeWrongDirection", fromResType, toResType), "from");

            SxSRequirements requires = GetRequirements(to, from);
 
            if ((requires & (SxSRequirements.AssemblyName | SxSRequirements.TypeName)) != 0 && type == null)
                throw new ArgumentNullException("type", Environment.GetResourceString("ArgumentNull_TypeRequiredByResourceScope")); 
 
            // Add in process ID, CLR base address, and appdomain ID's.  Also, use a character identifier
            // to ensure that these can never accidentally overlap (ie, you create enough appdomains and your 
            // appdomain ID might equal your process ID).
            StringBuilder safeName = new StringBuilder(name);
            char separator = '_';
            if ((requires & SxSRequirements.ProcessID) != 0) { 
                safeName.Append(separator);
                safeName.Append('p'); 
                safeName.Append(Win32Native.GetCurrentProcessId()); 
            }
            if ((requires & SxSRequirements.CLRInstanceID) != 0) { 
                String clrID = GetCLRInstanceString();
                safeName.Append(separator);
                safeName.Append('r');
                safeName.Append(clrID); 
            }
            if ((requires & SxSRequirements.AppDomainID) != 0) { 
                safeName.Append(separator); 
                safeName.Append("ad");
                safeName.Append(AppDomain.CurrentDomain.Id); 
            }
            if ((requires & SxSRequirements.TypeName) != 0) {
                safeName.Append(separator);
                safeName.Append(type.Name); 
            }
            if ((requires & SxSRequirements.AssemblyName) != 0) { 
                safeName.Append(separator); 
                safeName.Append(type.Assembly.FullName);
            } 
            return safeName.ToString();
        }

        [System.Security.SecuritySafeCritical] 
        private static String GetCLRInstanceString()
        { 
            int id = GetRuntimeId(); 
            return id.ToString(CultureInfo.InvariantCulture);
        } 

        private static SxSRequirements GetRequirements(ResourceScope consumeAsScope, ResourceScope calleeScope)
        {
            SxSRequirements requires = SxSRequirements.None; 

            switch(calleeScope & ResTypeMask) { 
            case ResourceScope.Machine: 
                switch(consumeAsScope & ResTypeMask) {
                case ResourceScope.Machine: 
                    // No work
                    break;

                case ResourceScope.Process: 
                    requires |= SxSRequirements.ProcessID;
                    break; 
 
                case ResourceScope.AppDomain:
                    requires |= SxSRequirements.AppDomainID | SxSRequirements.CLRInstanceID | SxSRequirements.ProcessID; 
                    break;

                default:
                    throw new ArgumentException(Environment.GetResourceString("Argument_BadResourceScopeTypeBits", consumeAsScope), "consumeAsScope"); 
                }
                break; 
 
            case ResourceScope.Process:
                if ((consumeAsScope & ResourceScope.AppDomain) != 0) 
                    requires |= SxSRequirements.AppDomainID | SxSRequirements.CLRInstanceID;
                break;

            case ResourceScope.AppDomain: 
                // No work
                break; 
 
            default:
                throw new ArgumentException(Environment.GetResourceString("Argument_BadResourceScopeTypeBits", calleeScope), "calleeScope"); 
            }

            switch(calleeScope & VisibilityMask) {
            case ResourceScope.None:  // Public - implied 
                switch(consumeAsScope & VisibilityMask) {
                case ResourceScope.None:  // Public - implied 
                    // No work 
                    break;
 
                case ResourceScope.Assembly:
                    requires |= SxSRequirements.AssemblyName;
                    break;
 
                case ResourceScope.Private:
                    requires |= SxSRequirements.TypeName | SxSRequirements.AssemblyName; 
                    break; 

                default: 
                    throw new ArgumentException(Environment.GetResourceString("Argument_BadResourceScopeVisibilityBits", consumeAsScope), "consumeAsScope");
                }
                break;
 
            case ResourceScope.Assembly:
                if ((consumeAsScope & ResourceScope.Private) != 0) 
                    requires |= SxSRequirements.TypeName; 
                break;
 
            case ResourceScope.Private:
                // No work
                break;
 
            default:
                throw new ArgumentException(Environment.GetResourceString("Argument_BadResourceScopeVisibilityBits", calleeScope), "calleeScope"); 
            } 

            if (consumeAsScope == calleeScope) { 
                Contract.Assert(requires == SxSRequirements.None, "Computed a strange set of required resource scoping.  It's probably wrong.");
            }

            return requires; 
        }
    } 
} 

// 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