フィールド (C# プログラミングガイド)

[アーティクル]
08/09/2011

更新 : 2010 年 8 月

フィールドとは、クラスまたは構造体で直接宣言される任意の型の変数です。フィールドは、それを含んでいる型のメンバーです。

クラスや構造体には、インスタンスフィールドと静的フィールドのいずれかまたは両方が含まれていることがあります。インスタンスフィールドは、型のインスタンスに固有になります。たとえば、クラス T と、そのクラスのインスタンスフィールド F があるとします。型 T のオブジェクトを 2 つ作成した場合、他方のオブジェクトの値には影響を与えずに、各オブジェクトの F の値を変更できます。これとは対照的に、クラス自体に属する静的フィールドは、そのクラスのすべてのインスタンスで共有されます。インスタンス A に変更が加えられると、インスタンス B と C においても、それらのインスタンスがフィールドにアクセスした場合にすぐに確認できる形で反映されます。

通常、フィールドは、プライベートまたはプロテクトのアクセシビリティを持つ変数にのみ使用します。クラスからクライアントコードに公開するデータは、メソッド、プロパティ、およびインデクサーを使用して提供する必要があります。これらの構成要素を内部フィールドへの間接アクセスとして使用することで、無効な値が入力されることを防止できます。パブリックプロパティによって公開されるデータを格納するプライベートフィールドは、バッキングストアまたはバッキングフィールドと呼ばれます。

一般に、フィールドには、複数のクラスメソッドからアクセスできるようにする必要があり、かつ 1 つのメソッドの有効期間よりも長く保持する必要のあるフィールドを格納します。たとえば、暦の日付を表すクラスには、月、日、年を表す 3 つの整数フィールドが存在します。 1 つのメソッドのスコープ外で使用されることのない変数は、メソッド本体の内部でローカル変数として宣言する必要があります。

フィールドは、フィールドのアクセスレベル、フィールドの型、フィールドの名前を順に指定して、クラスブロック内で宣言します。次に例を示します。

public class CalendarEntry
{
    // private field
    private DateTime date;

    // public field (Generally not recommended.)
    public string day;

    // Public property exposes date field safely.
    public DateTime Date 
    {
        get 
        {
            return date;
        }
        set 
        {
            // Set some reasonable boundaries for likely birth dates.
            if (value.Year > 1900 && value.Year <= DateTime.Today.Year)
            {
                date = value;
            }
            else
                throw new ArgumentOutOfRangeException();
        }

    }

    // Public method also exposes date field safely.
    // Example call: birthday.SetDate("1975, 6, 30");
    public void SetDate(string dateString)
    {
        DateTime dt = Convert.ToDateTime(dateString);

        // Set some reasonable boundaries for likely birth dates.
        if (dt.Year > 1900 && dt.Year <= DateTime.Today.Year)
        {
            date = dt;
        }
        else
            throw new ArgumentOutOfRangeException();
    }

    public TimeSpan GetTimeSpan(string dateString)
    {
        DateTime dt = Convert.ToDateTime(dateString);

        if (dt != null && dt.Ticks < date.Ticks)
        {
            return date - dt;
        }
        else
            throw new ArgumentOutOfRangeException();  

    }
}

オブジェクト内のフィールドにアクセスするには、objectname.fieldname のように、オブジェクト名の後にピリオドを追加し、その後にフィールド名を続けます。次に例を示します。

CalendarEntry birthday = new CalendarEntry();
birthday.day = "Saturday";

フィールドには、フィールドの宣言時に代入演算子を使用して初期値を設定できます。たとえば、day フィールドに自動的に "Monday" を代入するには、次の例のように day を宣言します。

public class CalendarDateWithInitialization
{
    public string day = "Monday";
    //...
}

フィールドは、オブジェクトインスタンスのコンストラクターが呼び出される直前に初期化されます。コンストラクターがフィールドの値を代入すると、フィールドの宣言中に指定された値はすべて上書きされます。詳細については、「コンストラクターの使用 (C# プログラミングガイド)」を参照してください。

注意

フィールド初期化子は、他のインスタンスフィールドを参照できません。

フィールドは、public、private、protected、internal、または protected internal とマークできます。これらのアクセス修飾子により、クラスのユーザーがフィールドにどのようにアクセスできるかが定義されます。詳細については、「アクセス修飾子 (C# プログラミングガイド)」を参照してください。

フィールドは、static と宣言することもできます。このように宣言すると、クラスのインスタンスが存在しない場合でも、呼び出し元がいつでもフィールドにアクセスできます。詳細については、「静的クラスと静的クラスメンバー (C# プログラミングガイド)」を参照してください。

フィールドは、readonly として宣言できます。読み取り専用フィールドには、初期化時またはコンストラクターでしか値を代入できません。 static readonly フィールドは基本的に定数と同じですが、C# コンパイラは、このフィールドの値にはコンパイル時にアクセスできず、実行時にしかアクセスできません。詳細については、「定数 (C# プログラミングガイド)」を参照してください。