DebuggerAttributes.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 / Diagnostics / DebuggerAttributes.cs / 1305376 / DebuggerAttributes.cs

                            // ==++== 
//
//   Copyright (c) Microsoft Corporation.  All rights reserved.
//
// ==--== 
/*============================================================
** 
** Class:  DebuggerAttributes 
**
** 
** Purpose: Attributes for debugger
**
**
===========================================================*/ 

 
namespace System.Diagnostics { 
    using System;
    using System.Runtime.InteropServices; 
    using System.Diagnostics.Contracts;

[Serializable]
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Method | AttributeTargets.Constructor, Inherited = false)] 
    [ComVisible(true)]
    public sealed class DebuggerStepThroughAttribute : Attribute 
    { 
        public DebuggerStepThroughAttribute () {}
    } 

[Serializable]
[AttributeUsage(AttributeTargets.Method | AttributeTargets.Constructor, Inherited = false)]
    [ComVisible(true)] 
    public sealed class DebuggerStepperBoundaryAttribute : Attribute
    { 
        public DebuggerStepperBoundaryAttribute () {} 
    }
 
[Serializable]
[AttributeUsage(AttributeTargets.Method | AttributeTargets.Property | AttributeTargets.Constructor, Inherited = false)]
    [ComVisible(true)]
    public sealed class DebuggerHiddenAttribute : Attribute 
    {
        public DebuggerHiddenAttribute () {} 
    } 

[Serializable] 
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method | AttributeTargets.Property | AttributeTargets.Constructor |AttributeTargets.Struct, Inherited = false)]
    [ComVisible(true)]
    public sealed class DebuggerNonUserCodeAttribute : Attribute
    { 
       public DebuggerNonUserCodeAttribute () {}
    } 
 
    // Attribute class used by the compiler to mark modules.
    // If present, then debugging information for everything in the 
    // assembly was generated by the compiler, and will be preserved
    // by the Runtime so that the debugger can provide full functionality
    // in the case of JIT attach. If not present, then the compiler may
    // or may not have included debugging information, and the Runtime 
    // won't preserve the debugging info, which will make debugging after
    // a JIT attach difficult. 
    [AttributeUsage(AttributeTargets.Assembly|AttributeTargets.Module, AllowMultiple = false)] 
    [ComVisible(true)]
    public sealed class DebuggableAttribute : Attribute 
    {
        [Flags]
        [ComVisible(true)]
        public enum DebuggingModes 
        {
            None = 0x0, 
            Default = 0x1, 
            DisableOptimizations = 0x100,
            IgnoreSymbolStoreSequencePoints = 0x2, 
            EnableEditAndContinue = 0x4
        }

        private DebuggingModes m_debuggingModes; 

        public DebuggableAttribute(bool isJITTrackingEnabled, 
                                   bool isJITOptimizerDisabled) 
        {
            m_debuggingModes = 0; 

            if (isJITTrackingEnabled)
            {
                m_debuggingModes |= DebuggingModes.Default; 
            }
 
            if (isJITOptimizerDisabled) 
            {
                m_debuggingModes |= DebuggingModes.DisableOptimizations; 
            }
        }

        public DebuggableAttribute(DebuggingModes modes) 
        {
            m_debuggingModes = modes; 
        } 

        public bool IsJITTrackingEnabled 
        {
            get { return ((m_debuggingModes & DebuggingModes.Default) != 0); }
        }
 
        public bool IsJITOptimizerDisabled
        { 
            get { return ((m_debuggingModes & DebuggingModes.DisableOptimizations) != 0); } 
        }
 
        public DebuggingModes DebuggingFlags
        {
            get { return m_debuggingModes; }
        } 
    }
 
    //  DebuggerBrowsableState states are defined as follows: 
    //      Never       never show this element
    //      Expanded    expansion of the class is done, so that all visible internal members are shown 
    //      Collapsed   expansion of the class is not performed. Internal visible members are hidden
    //      RootHidden  The target element itself should not be shown, but should instead be
    //                  automatically expanded to have its members displayed.
    //  Default value is collapsed 

    //  Please also change the code which validates DebuggerBrowsableState variable (in this file) 
    //  if you change this enum. 
    [ComVisible(true)]
    public enum DebuggerBrowsableState 
    {
        Never = 0,
        //Expanded is not supported in this release
        //Expanded = 1, 
        Collapsed = 2,
        RootHidden = 3 
    } 

 
    // the one currently supported with the csee.dat
    // (mcee.dat, autoexp.dat) file.
    [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property, AllowMultiple = false)]
    [ComVisible(true)] 
    public sealed class DebuggerBrowsableAttribute: Attribute
    { 
        private DebuggerBrowsableState state; 
        public DebuggerBrowsableAttribute(DebuggerBrowsableState state)
        { 
            if( state < DebuggerBrowsableState.Never || state > DebuggerBrowsableState.RootHidden)
                throw new ArgumentOutOfRangeException("state");
            Contract.EndContractBlock();
 
            this.state = state;
        } 
        public DebuggerBrowsableState State 
        {
            get { return state; } 
        }
    }

 
    // DebuggerTypeProxyAttribute
    [AttributeUsage(AttributeTargets.Struct | AttributeTargets.Class | AttributeTargets.Assembly, AllowMultiple = true)] 
    [ComVisible(true)] 
    public sealed class DebuggerTypeProxyAttribute: Attribute
    { 
        private string typeName;
        private string targetName;
        private Type target;
 
        public DebuggerTypeProxyAttribute(Type type)
        { 
            if (type == null) { 
                throw new ArgumentNullException("type");
            } 
            Contract.EndContractBlock();

            this.typeName = type.AssemblyQualifiedName;
        } 

        public DebuggerTypeProxyAttribute(string typeName) 
        { 
            this.typeName = typeName;
        } 
        public string ProxyTypeName
        {
            get { return typeName; }
        } 

        public Type Target 
        { 
            set {
                if( value == null) { 
                    throw new ArgumentNullException("value");
                }
                Contract.EndContractBlock();
 
                targetName = value.AssemblyQualifiedName;
                target = value; 
            } 

            get { return target; } 
        }

        public string TargetTypeName
        { 
            get { return targetName; }
            set { targetName = value; } 
 
        }
    } 

    // This attribute is used to control what is displayed for the given class or field
    // in the data windows in the debugger.  The single argument to this attribute is
    // the string that will be displayed in the value column for instances of the type. 
    // This string can include text between { and } which can be either a field,
    // property or method (as will be documented in mscorlib).  In the C# case, 
    // a general expression will be allowed which only has implicit access to the this pointer 
    // for the current instance of the target type. The expression will be limited,
    // however: there is no access to aliases, locals, or pointers. 
    // In addition, attributes on properties referenced in the expression are not processed.
    [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Delegate | AttributeTargets.Enum | AttributeTargets.Field | AttributeTargets.Property | AttributeTargets.Assembly, AllowMultiple = true)]
    [ComVisible(true)]
    public sealed class DebuggerDisplayAttribute : Attribute 
    {
        private string name; 
        private string value; 
        private string type;
        private string targetName; 
        private Type target;

        public DebuggerDisplayAttribute(string value)
        { 
            if( value == null ) {
                this.value = ""; 
            } 
            else {
                this.value = value; 
            }
            name = "";
            type = "";
        } 

        public string Value 
        { 
            get { return this.value; }
        } 

        public string Name
        {
            get { return name; } 
            set { name = value; }
        } 
 
        public string Type
        { 
            get { return type; }
            set { type = value; }
        }
 
        public Type Target
        { 
            set { 
                if( value == null) {
                    throw new ArgumentNullException("value"); 
                }
                Contract.EndContractBlock();

                targetName = value.AssemblyQualifiedName; 
                target = value;
            } 
            get { return target; } 
        }
 
        public string TargetTypeName
        {
            get { return targetName; }
            set { targetName = value; } 

        } 
    } 

 
    /// 
    /// Signifies that the attributed type has a visualizer which is pointed
    /// to by the parameter type name strings.
    ///  
    [AttributeUsage(AttributeTargets.Struct | AttributeTargets.Class | AttributeTargets.Assembly, AllowMultiple = true)]
    [ComVisible(true)] 
    public sealed class DebuggerVisualizerAttribute: Attribute 
    {
        private string visualizerObjectSourceName; 
        private string visualizerName;
        private string description;
        private string targetName;
        private Type target; 

        public DebuggerVisualizerAttribute(string visualizerTypeName) 
        { 
            this.visualizerName = visualizerTypeName;
        } 
        public DebuggerVisualizerAttribute(string visualizerTypeName, string visualizerObjectSourceTypeName)
        {
            this.visualizerName = visualizerTypeName;
            this.visualizerObjectSourceName = visualizerObjectSourceTypeName; 
        }
        public DebuggerVisualizerAttribute(string visualizerTypeName, Type visualizerObjectSource) 
        { 
            if (visualizerObjectSource == null) {
                throw new ArgumentNullException("visualizerObjectSource"); 
            }
            Contract.EndContractBlock();
            this.visualizerName = visualizerTypeName;
            this.visualizerObjectSourceName = visualizerObjectSource.AssemblyQualifiedName; 
        }
        public DebuggerVisualizerAttribute(Type visualizer) 
        { 
            if (visualizer == null) {
                throw new ArgumentNullException("visualizer"); 
            }
            Contract.EndContractBlock();
            this.visualizerName = visualizer.AssemblyQualifiedName;
        } 
        public DebuggerVisualizerAttribute(Type visualizer, Type visualizerObjectSource)
        { 
            if (visualizer == null) { 
                throw new ArgumentNullException("visualizer");
            } 
            if (visualizerObjectSource == null) {
                throw new ArgumentNullException("visualizerObjectSource");
            }
            Contract.EndContractBlock(); 
            this.visualizerName = visualizer.AssemblyQualifiedName;
            this.visualizerObjectSourceName = visualizerObjectSource.AssemblyQualifiedName; 
        } 
        public DebuggerVisualizerAttribute(Type visualizer, string visualizerObjectSourceTypeName)
        { 
            if (visualizer == null) {
                throw new ArgumentNullException("visualizer");
            }
            Contract.EndContractBlock(); 
            this.visualizerName = visualizer.AssemblyQualifiedName;
            this.visualizerObjectSourceName = visualizerObjectSourceTypeName; 
        } 

        public string VisualizerObjectSourceTypeName 
        {
            get { return visualizerObjectSourceName; }
        }
        public string VisualizerTypeName 
        {
            get { return visualizerName; } 
        } 
        public string Description
        { 
            get { return description; }
            set { description = value; }
        }
 
        public Type Target
        { 
            set { 
                if( value == null) {
                    throw new ArgumentNullException("value"); 
                }
                Contract.EndContractBlock();

                targetName = value.AssemblyQualifiedName; 
                target = value;
            } 
 
            get { return target; }
        } 

        public string TargetTypeName
        {
            set { targetName = value; } 
            get { return targetName; }
        } 
    } 
}
 


// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// ==++== 
//
//   Copyright (c) Microsoft Corporation.  All rights reserved.
//
// ==--== 
/*============================================================
** 
** Class:  DebuggerAttributes 
**
** 
** Purpose: Attributes for debugger
**
**
===========================================================*/ 

 
namespace System.Diagnostics { 
    using System;
    using System.Runtime.InteropServices; 
    using System.Diagnostics.Contracts;

[Serializable]
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Method | AttributeTargets.Constructor, Inherited = false)] 
    [ComVisible(true)]
    public sealed class DebuggerStepThroughAttribute : Attribute 
    { 
        public DebuggerStepThroughAttribute () {}
    } 

[Serializable]
[AttributeUsage(AttributeTargets.Method | AttributeTargets.Constructor, Inherited = false)]
    [ComVisible(true)] 
    public sealed class DebuggerStepperBoundaryAttribute : Attribute
    { 
        public DebuggerStepperBoundaryAttribute () {} 
    }
 
[Serializable]
[AttributeUsage(AttributeTargets.Method | AttributeTargets.Property | AttributeTargets.Constructor, Inherited = false)]
    [ComVisible(true)]
    public sealed class DebuggerHiddenAttribute : Attribute 
    {
        public DebuggerHiddenAttribute () {} 
    } 

[Serializable] 
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method | AttributeTargets.Property | AttributeTargets.Constructor |AttributeTargets.Struct, Inherited = false)]
    [ComVisible(true)]
    public sealed class DebuggerNonUserCodeAttribute : Attribute
    { 
       public DebuggerNonUserCodeAttribute () {}
    } 
 
    // Attribute class used by the compiler to mark modules.
    // If present, then debugging information for everything in the 
    // assembly was generated by the compiler, and will be preserved
    // by the Runtime so that the debugger can provide full functionality
    // in the case of JIT attach. If not present, then the compiler may
    // or may not have included debugging information, and the Runtime 
    // won't preserve the debugging info, which will make debugging after
    // a JIT attach difficult. 
    [AttributeUsage(AttributeTargets.Assembly|AttributeTargets.Module, AllowMultiple = false)] 
    [ComVisible(true)]
    public sealed class DebuggableAttribute : Attribute 
    {
        [Flags]
        [ComVisible(true)]
        public enum DebuggingModes 
        {
            None = 0x0, 
            Default = 0x1, 
            DisableOptimizations = 0x100,
            IgnoreSymbolStoreSequencePoints = 0x2, 
            EnableEditAndContinue = 0x4
        }

        private DebuggingModes m_debuggingModes; 

        public DebuggableAttribute(bool isJITTrackingEnabled, 
                                   bool isJITOptimizerDisabled) 
        {
            m_debuggingModes = 0; 

            if (isJITTrackingEnabled)
            {
                m_debuggingModes |= DebuggingModes.Default; 
            }
 
            if (isJITOptimizerDisabled) 
            {
                m_debuggingModes |= DebuggingModes.DisableOptimizations; 
            }
        }

        public DebuggableAttribute(DebuggingModes modes) 
        {
            m_debuggingModes = modes; 
        } 

        public bool IsJITTrackingEnabled 
        {
            get { return ((m_debuggingModes & DebuggingModes.Default) != 0); }
        }
 
        public bool IsJITOptimizerDisabled
        { 
            get { return ((m_debuggingModes & DebuggingModes.DisableOptimizations) != 0); } 
        }
 
        public DebuggingModes DebuggingFlags
        {
            get { return m_debuggingModes; }
        } 
    }
 
    //  DebuggerBrowsableState states are defined as follows: 
    //      Never       never show this element
    //      Expanded    expansion of the class is done, so that all visible internal members are shown 
    //      Collapsed   expansion of the class is not performed. Internal visible members are hidden
    //      RootHidden  The target element itself should not be shown, but should instead be
    //                  automatically expanded to have its members displayed.
    //  Default value is collapsed 

    //  Please also change the code which validates DebuggerBrowsableState variable (in this file) 
    //  if you change this enum. 
    [ComVisible(true)]
    public enum DebuggerBrowsableState 
    {
        Never = 0,
        //Expanded is not supported in this release
        //Expanded = 1, 
        Collapsed = 2,
        RootHidden = 3 
    } 

 
    // the one currently supported with the csee.dat
    // (mcee.dat, autoexp.dat) file.
    [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property, AllowMultiple = false)]
    [ComVisible(true)] 
    public sealed class DebuggerBrowsableAttribute: Attribute
    { 
        private DebuggerBrowsableState state; 
        public DebuggerBrowsableAttribute(DebuggerBrowsableState state)
        { 
            if( state < DebuggerBrowsableState.Never || state > DebuggerBrowsableState.RootHidden)
                throw new ArgumentOutOfRangeException("state");
            Contract.EndContractBlock();
 
            this.state = state;
        } 
        public DebuggerBrowsableState State 
        {
            get { return state; } 
        }
    }

 
    // DebuggerTypeProxyAttribute
    [AttributeUsage(AttributeTargets.Struct | AttributeTargets.Class | AttributeTargets.Assembly, AllowMultiple = true)] 
    [ComVisible(true)] 
    public sealed class DebuggerTypeProxyAttribute: Attribute
    { 
        private string typeName;
        private string targetName;
        private Type target;
 
        public DebuggerTypeProxyAttribute(Type type)
        { 
            if (type == null) { 
                throw new ArgumentNullException("type");
            } 
            Contract.EndContractBlock();

            this.typeName = type.AssemblyQualifiedName;
        } 

        public DebuggerTypeProxyAttribute(string typeName) 
        { 
            this.typeName = typeName;
        } 
        public string ProxyTypeName
        {
            get { return typeName; }
        } 

        public Type Target 
        { 
            set {
                if( value == null) { 
                    throw new ArgumentNullException("value");
                }
                Contract.EndContractBlock();
 
                targetName = value.AssemblyQualifiedName;
                target = value; 
            } 

            get { return target; } 
        }

        public string TargetTypeName
        { 
            get { return targetName; }
            set { targetName = value; } 
 
        }
    } 

    // This attribute is used to control what is displayed for the given class or field
    // in the data windows in the debugger.  The single argument to this attribute is
    // the string that will be displayed in the value column for instances of the type. 
    // This string can include text between { and } which can be either a field,
    // property or method (as will be documented in mscorlib).  In the C# case, 
    // a general expression will be allowed which only has implicit access to the this pointer 
    // for the current instance of the target type. The expression will be limited,
    // however: there is no access to aliases, locals, or pointers. 
    // In addition, attributes on properties referenced in the expression are not processed.
    [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Delegate | AttributeTargets.Enum | AttributeTargets.Field | AttributeTargets.Property | AttributeTargets.Assembly, AllowMultiple = true)]
    [ComVisible(true)]
    public sealed class DebuggerDisplayAttribute : Attribute 
    {
        private string name; 
        private string value; 
        private string type;
        private string targetName; 
        private Type target;

        public DebuggerDisplayAttribute(string value)
        { 
            if( value == null ) {
                this.value = ""; 
            } 
            else {
                this.value = value; 
            }
            name = "";
            type = "";
        } 

        public string Value 
        { 
            get { return this.value; }
        } 

        public string Name
        {
            get { return name; } 
            set { name = value; }
        } 
 
        public string Type
        { 
            get { return type; }
            set { type = value; }
        }
 
        public Type Target
        { 
            set { 
                if( value == null) {
                    throw new ArgumentNullException("value"); 
                }
                Contract.EndContractBlock();

                targetName = value.AssemblyQualifiedName; 
                target = value;
            } 
            get { return target; } 
        }
 
        public string TargetTypeName
        {
            get { return targetName; }
            set { targetName = value; } 

        } 
    } 

 
    /// 
    /// Signifies that the attributed type has a visualizer which is pointed
    /// to by the parameter type name strings.
    ///  
    [AttributeUsage(AttributeTargets.Struct | AttributeTargets.Class | AttributeTargets.Assembly, AllowMultiple = true)]
    [ComVisible(true)] 
    public sealed class DebuggerVisualizerAttribute: Attribute 
    {
        private string visualizerObjectSourceName; 
        private string visualizerName;
        private string description;
        private string targetName;
        private Type target; 

        public DebuggerVisualizerAttribute(string visualizerTypeName) 
        { 
            this.visualizerName = visualizerTypeName;
        } 
        public DebuggerVisualizerAttribute(string visualizerTypeName, string visualizerObjectSourceTypeName)
        {
            this.visualizerName = visualizerTypeName;
            this.visualizerObjectSourceName = visualizerObjectSourceTypeName; 
        }
        public DebuggerVisualizerAttribute(string visualizerTypeName, Type visualizerObjectSource) 
        { 
            if (visualizerObjectSource == null) {
                throw new ArgumentNullException("visualizerObjectSource"); 
            }
            Contract.EndContractBlock();
            this.visualizerName = visualizerTypeName;
            this.visualizerObjectSourceName = visualizerObjectSource.AssemblyQualifiedName; 
        }
        public DebuggerVisualizerAttribute(Type visualizer) 
        { 
            if (visualizer == null) {
                throw new ArgumentNullException("visualizer"); 
            }
            Contract.EndContractBlock();
            this.visualizerName = visualizer.AssemblyQualifiedName;
        } 
        public DebuggerVisualizerAttribute(Type visualizer, Type visualizerObjectSource)
        { 
            if (visualizer == null) { 
                throw new ArgumentNullException("visualizer");
            } 
            if (visualizerObjectSource == null) {
                throw new ArgumentNullException("visualizerObjectSource");
            }
            Contract.EndContractBlock(); 
            this.visualizerName = visualizer.AssemblyQualifiedName;
            this.visualizerObjectSourceName = visualizerObjectSource.AssemblyQualifiedName; 
        } 
        public DebuggerVisualizerAttribute(Type visualizer, string visualizerObjectSourceTypeName)
        { 
            if (visualizer == null) {
                throw new ArgumentNullException("visualizer");
            }
            Contract.EndContractBlock(); 
            this.visualizerName = visualizer.AssemblyQualifiedName;
            this.visualizerObjectSourceName = visualizerObjectSourceTypeName; 
        } 

        public string VisualizerObjectSourceTypeName 
        {
            get { return visualizerObjectSourceName; }
        }
        public string VisualizerTypeName 
        {
            get { return visualizerName; } 
        } 
        public string Description
        { 
            get { return description; }
            set { description = value; }
        }
 
        public Type Target
        { 
            set { 
                if( value == null) {
                    throw new ArgumentNullException("value"); 
                }
                Contract.EndContractBlock();

                targetName = value.AssemblyQualifiedName; 
                target = value;
            } 
 
            get { return target; }
        } 

        public string TargetTypeName
        {
            set { targetName = value; } 
            get { return targetName; }
        } 
    } 
}
 


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