EditorBrowsableAttribute Class

Definition

Namespace:

System.ComponentModel

Assembly:

System.Runtime.dll

Source:

EditorBrowsableAttribute.cs

Specifies that a class or member is viewable in an editor. This class cannot be inherited.

public ref class EditorBrowsableAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Delegate | System.AttributeTargets.Enum | System.AttributeTargets.Event | System.AttributeTargets.Field | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Property | System.AttributeTargets.Struct)]
public sealed class EditorBrowsableAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Delegate | System.AttributeTargets.Enum | System.AttributeTargets.Event | System.AttributeTargets.Field | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Property | System.AttributeTargets.Struct)>]
type EditorBrowsableAttribute = class
    inherit Attribute

Public NotInheritable Class EditorBrowsableAttribute
Inherits Attribute

Inheritance

Object

Attribute

EditorBrowsableAttribute

Attributes

AttributeUsageAttribute

Examples

The following example demonstrates how to hide a property of a class from IntelliSense by setting the appropriate value for the EditorBrowsableAttribute attribute.

Build Class1 in its own assembly. Then, in Visual Studio, create a new project and add a reference to the assembly that contains Class1. Declare an instance of Class1, and then enter the name of the instance and press the . key to activate the IntelliSense list of Class1 members. The Age property does not appear in the drop-down list because it's hidden.

#using <system.dll>

using namespace System;
using namespace System::ComponentModel;

namespace EditorBrowsableDemo
{
   public ref class Class1
   {
   public:
      Class1()
      { 
         //
         // TODO: Add constructor logic here
         //
      }

   private:
      int ageval;

   public:
      [EditorBrowsable(EditorBrowsableState::Never)]
      property int Age 
      {
         int get()
         {
            return ageval;
         }

         void set( int value )
         {
            if ( ageval != value )
            {
               ageval = value;
            }
         }
      }
   };
}

using System.ComponentModel;

namespace EditorBrowsableDemo
{
    public class Class1
    {
        public Class1() { }

        [EditorBrowsable(EditorBrowsableState.Never)]
        public int Age
        {
            get; set;
        }

        public int Height
        {
            get; set;
        }
    }
}

Imports System.ComponentModel

Public Class Class1

    Private ageval As Integer

    <EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)> _
    Public Property Age() As Integer

        Get
            Return ageval
        End Get

        Set(ByVal Value As Integer)
            If Not ageval.Equals(Value) Then
                ageval = Value
            End If
        End Set

    End Property

End Class

Remarks

EditorBrowsableAttribute is a hint to a designer that indicates whether a class or member should be displayed. You can use this type in a visual designer or text editor to determine what to make visible to the user. For example, the IntelliSense engine in Visual Studio uses this attribute to determine whether to show a class or member.

In Visual Studio, you can control when advanced properties appear in C# IntelliSense and the Properties window with the Hide Advanced Members setting under Tools > Options > Text Editor > C#. The corresponding EditorBrowsableState is Advanced.

Note

In C#, EditorBrowsableAttribute does not suppress members from being browsed by a class in the same assembly.

Constructors

EditorBrowsableAttribute()	Initializes a new instance of the EditorBrowsableAttribute class with State set to the default state.
EditorBrowsableAttribute(EditorBrowsableState)	Initializes a new instance of the EditorBrowsableAttribute class with an EditorBrowsableState.

Properties

State	Gets the browsable state of the property or method.
TypeId	When implemented in a derived class, gets a unique identifier for this Attribute. (Inherited from Attribute)

Methods

Equals(Object)	Returns whether the value of the given object is equal to the current EditorBrowsableAttribute.
GetHashCode()	Returns the hash code for this instance.
GetType()	Gets the Type of the current instance. (Inherited from Object)
IsDefaultAttribute()	When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class. (Inherited from Attribute)
Match(Object)	When overridden in a derived class, returns a value that indicates whether this instance equals a specified object. (Inherited from Attribute)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

See also

• EditorBrowsableState
• BrowsableAttribute