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
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- LocalIdKeyIdentifierClause.cs
- DataObjectFieldAttribute.cs
- ThousandthOfEmRealDoubles.cs
- ServiceSecurityAuditElement.cs
- CompilerInfo.cs
- ObjectStateManager.cs
- PersistenceMetadataNamespace.cs
- TagNameToTypeMapper.cs
- UnsafeNativeMethods.cs
- FixedSOMTableRow.cs
- AuthenticationModuleElement.cs
- UniqueCodeIdentifierScope.cs
- XmlNodeReader.cs
- BinaryNode.cs
- TreeViewCancelEvent.cs
- DataKeyCollection.cs
- MappingModelBuildProvider.cs
- MenuItemStyleCollection.cs
- TemplateBuilder.cs
- MailWriter.cs
- XmlNodeChangedEventManager.cs
- StringSource.cs
- CompilerScopeManager.cs
- Wildcard.cs
- ScrollChangedEventArgs.cs
- CodeGroup.cs
- HttpListenerContext.cs
- MenuItemCollection.cs
- CompositeActivityMarkupSerializer.cs
- Opcode.cs
- XmlAttributeProperties.cs
- UnaryExpressionHelper.cs
- TaskCanceledException.cs
- FixedPageProcessor.cs
- OuterGlowBitmapEffect.cs
- Baml6ConstructorInfo.cs
- Enum.cs
- FormsAuthentication.cs
- Span.cs
- ObjectDataSourceEventArgs.cs
- AssemblyCache.cs
- DropDownButton.cs
- SourceFileBuildProvider.cs
- FigureParagraph.cs
- XmlSchemaCollection.cs
- IISMapPath.cs
- TreeViewAutomationPeer.cs
- BinaryFormatter.cs
- XPathConvert.cs
- RsaSecurityTokenAuthenticator.cs
- SelectionPattern.cs
- StorageMappingItemLoader.cs
- BinaryVersion.cs
- XmlDataProvider.cs
- ImageSource.cs
- HTTPRemotingHandler.cs
- StorageEntityContainerMapping.cs
- OuterGlowBitmapEffect.cs
- StructuredTypeEmitter.cs
- FormsAuthenticationUserCollection.cs
- EventSinkActivity.cs
- BrowsableAttribute.cs
- PassportAuthenticationEventArgs.cs
- ZipIOExtraField.cs
- Parameter.cs
- SQLByteStorage.cs
- odbcmetadatacolumnnames.cs
- Binding.cs
- NamedPipeAppDomainProtocolHandler.cs
- XmlDataContract.cs
- InteropBitmapSource.cs
- SessionState.cs
- StrongNamePublicKeyBlob.cs
- MenuBase.cs
- BitmapEffectState.cs
- RenderOptions.cs
- StorageInfo.cs
- SspiWrapper.cs
- NamedPipeTransportSecurityElement.cs
- DBDataPermissionAttribute.cs
- TreeNodeEventArgs.cs
- WebPartsSection.cs
- QuadraticEase.cs
- ServiceInfoCollection.cs
- MappingException.cs
- ProjectionNode.cs
- BamlBinaryWriter.cs
- ModuleBuilder.cs
- EditorPart.cs
- StyleSheetComponentEditor.cs
- DataSourceControl.cs
- BindingWorker.cs
- UIElementHelper.cs
- Pen.cs
- CodeTypeReferenceExpression.cs
- GridViewColumnHeader.cs
- TextServicesHost.cs
- ObjectListField.cs
- TextBoxBase.cs
- ToolboxItemAttribute.cs