ユーザー設定フィールド クラスを作成する

SPFieldBoolean

Boolean のフィールド型を表します。

SPFieldCurrency

通貨のフィールド型を表します。

SPFieldLookup

ルックアップ フィールドを表します。SPFieldLookup オブジェクトに対するフィールド値は、SPFieldLookupValue オブジェクトに格納されます。

SPFieldMultiColumn

複数列のフィールド型を表します。SPFieldMultiColumn オブジェクトに対するフィールド値は、SPFieldMultiColumnValue オブジェクトに格納されます。

SPFieldNumber

数値のフィールド型を表します。

SPFieldText

単一行テキストのフィールド型を表します。

SPFieldUser

SharePoint Foundation ユーザーを表します。

FieldRenderingControl

表示、編集、新規の各フォーム内、およびフィールド コントロールを使用する任意のページ内で、フィールドをレンダリングするために使用できるコントロールを返します。レンダリング コントロールをインスタンス化するオブジェクトは、その Field プロパティに、レンダリング対象のフィールド オブジェクトへの逆参照を保持します。この逆参照が示すように、これら 2 つのオブジェクトはパートナーです。SPField の派生オブジェクトは、コンテンツ データベースとの連携を処理し、一方、BaseFieldControl の派生レンダリング コントロールは、ユーザーとの連携のほか、ユーザー インターフェイス (UI) へのフィールドのレンダリングを処理します。ただし、ユーザー設定フィールドは、必ずしもレンダリング コントロールでレンダリングする必要はありません。フィールド定義で定義された RenderPattern でもレンダリングできます。この場合、FieldRenderingControl プロパティは null にできます。最もよくあるパターンとしては、新規モードと編集モードでフィールドをレンダリングするときにはレンダリング コントロールを使用し、表示モードでレンダリングするときにはレンダリング パターンを使用します。

レンダリング コントロールを使用する場合は、ユーザー設定フィールド クラスによって、FieldRenderingControl プロパティの get アクセサーを無効にする必要があります。これには、次の標準的なパターンのコードを使用します。

public override BaseFieldControl FieldRenderingControl
{
    [SharePointPermission(SecurityAction.LinkDemand, ObjectModel = true)]
    get 
    {
        BaseFieldControl fieldControl = new field_type_nameFieldControl();
        fieldControl.FieldName = this.InternalName;
        return fieldControl;
    }
}

Public Overrides ReadOnly Property FieldRenderingControl() As BaseFieldControl
    <SharePointPermission(SecurityAction.LinkDemand, ObjectModel := True)> _
    Get
        Dim fieldControl As BaseFieldControl = New field_type_nameFieldControl()
        fieldControl.FieldName = Me.InternalName
        Return fieldControl
    End Get
End Property

アクセス許可属性では、SharePoint Foundation オブジェクト モデルを使用するためのアクセス許可が設定されたコードだけに、プロパティの読み取りを許可しています。フィールド オブジェクトの内部名を FieldName プロパティに割り当てている行では、フィールド オブジェクトへの Field プロパティの割り当ても行っています。 こうすることで、フィールド型の名前FieldControl で指定したフィールド コントロールは、レンダリングするオブジェクトを認識します。

GetFieldValueForEdit

編集モードでレンダリングされるフィールド値を返します。このメソッドは、編集フォームと新規作成フォームに使用されます。

OnAdded

無効にして、フィールドがリストに追加された後のユーザー設定フィールド型ロジックを指定します。

OnDeleting

無効にして、フィールドがリストから削除される前のユーザー設定フィールド型ロジックを指定します。

DefaultValue

特定のリスト項目がフィールド内で値を持たない場合に、フィールドに使用できる既定値を、文字列として返します。

FieldValueType

フィールド値の型を返します。

GetFieldValueAsText

フィールドのデータ値を文字列として返します。

GetValidatedString

「ユーザー設定フィールド動作の指定」の注意書きを参照してください。