FieldInfo.IsFamily Property

May 11, 2014

Gets a value that indicates whether the visibility of this field is described by FieldAttributes.Family; that is, the field is visible only within its class and derived classes.

Namespace:  System.Reflection
Assembly:  mscorlib (in mscorlib.dll)

public bool IsFamily { get; }

Property Value

Type: System.Boolean
true if access to this field is exactly described by FieldAttributes.Family; otherwise, false.

ExceptionCondition
MethodAccessException

This member is invoked late-bound through mechanisms such as Type.InvokeMember.

The visibility of a field is exactly described by FieldAttributes.Family if the only visibility modifier is protected. This property is false for fields that are protected internal in C# (Protected Friend in Visual Basic, protected public in C++); use the IsFamilyOrAssembly property to identify such fields.

The following example defines fields with varying levels of visibility, and displays the values of their IsAssembly, IsFamily, IsFamilyOrAssembly, and IsFamilyAndAssembly properties.

NoteNote:

The Visual Basic and C# languages cannot define fields with FieldAttributes.FamANDAssem visibility.

To run this example, see Building examples that have static TextBlock controls for Windows Phone 8.


using System;
using System.Reflection;

public class Example
{
   public int f_public;
   internal int f_internal;
   protected int f_protected;
   protected internal int f_protected_public;

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      outputBlock.FontFamily = new System.Windows.Media.FontFamily("Courier New");
      outputBlock.Text += String.Format("\n{0,-30}{1,-18}{2}", "", "IsAssembly", "IsFamilyOrAssembly") + "\n";
      outputBlock.Text += String.Format("{0,-21}{1,-18}{2,-18}{3}\n",
          "", "IsPublic", "IsFamily", "IsFamilyAndAssembly") + "\n";

      foreach (FieldInfo f in typeof(Example).GetFields(
          BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public))
      {
         outputBlock.Text += String.Format("{0,-21}{1,-9}{2,-9}{3,-9}{4,-9}{5,-9}",
             f.Name,
             f.IsPublic,
             f.IsAssembly,
             f.IsFamily,
             f.IsFamilyOrAssembly,
             f.IsFamilyAndAssembly
         ) + "\n";
      }
   }
}

/* This code example produces output similar to the following:

                              IsAssembly        IsFamilyOrAssembly
                     IsPublic          IsFamily          IsFamilyAndAssembly

f_public             True     False    False    False    False
f_internal           False    True     False    False    False
f_protected          False    False    True     False    False
f_protected_public   False    False    False    True     False
 */


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft